アルパカログ

開発しているNotion Blogやプログラミングの話題が中心のブログ

Zendesk REST APIで複数のフィールドをAND条件にしてチケットを検索する方法

Zendeskでは開発者向けのREST APIが提供されています。

このエントリでは、Zendesk REST APIのSearch APIを使い複数のチケットフィールドをAND指定してチケットを検索する方法を説明します。

Undocumented な方法のため、使用は自己責任でお願いします。

リクエストURL

チケットを検索する場合のリクエストURLは下記のようになるでしょう。

/api/v2/search.json?query=type:ticket {query}&sort_by={sort_by}&sort_order={sort_order}&page={page}

チケットフィールドを含め検索条件はqueryで指定します。

チケットフィールドの指定

チケットフィールド (カスタムフィールド) の条件はZendesk Support search referenceにあるとおりfieldvalue:12345のように指定します。

ここで気を付けなければならないのは12345の部分はIDではなく値であるということです。

AND条件

fieldvalue:12345,67890のようにスペースを入れずCSVで指定します。たったこれだけです。

以上です。

このエントリでは、Zendesk REST APIのSearch APIを使い複数のチケットフィールドをAND 指定してチケットを検索する方法を説明しました。