チケットにタグが追加されました（トリガー）
このピースでできることZendeskの接続方法1. ZendeskのAPIトークンの取得2. 接続を作成3. 接続設定4. 接続名が設定されていることを確認するピースの設定項目1. 特定のタグ（オプション）取得できる情報出力例（抜粋）
このピースでできること
- チケット更新に特定のタグが含まれると起動します（Webhook）。
Zendeskの接続方法
1. ZendeskのAPIトークンの取得
- Zendeskの管理センターのサイドバーからから「アプリおよびインテグレーション」>「APIトークン」を選択します。APIトークンアクセスがオフになっています」と表示が出た場合は「トークンアクセス設定を表示」をクリックします。
- 「APIトークンアクセスを許可」にチェックを入れて右下の「保存」ボタンを押します。
- 「APIトークンを追加」を押します。
- APIトークンの名前などを入力して右下の「保存」を押すとAPIトークンが表示されます。二度と表示されないものなのでどこかにメモをしておいてください。
2. 接続を作成
- 接続から「接続を作成」をクリックします。
3. 接続設定
- 接続名を設定して、以下の3項目を入力し、「保存」をクリックします。
| エージェントのメールアドレス | Zendeskにログインするために使用するメールアドレス |
| トークン | 1で取得したAPIトークン。 |
| 組織 | Zendeskインスタンスのサブドメイン。インスタンスのURLが以下のような場合は青字の部分がサブドメイン。 ex) https://workrun-1111.zendesk.com |
4. 接続名が設定されていることを確認する
- 接続名が設定されていることを確認します。
ピースの設定項目
1. 特定のタグ（オプション）
取得できる情報
条件に一致したチケットの情報を取得できます。
| 実際のキー | 内容・条件 |
|---|---|
| / / | チケットID・件名・説明。 |
| / / | 状態・優先度・タグ配列。 |
| / / | 依頼者・担当者・組織のID。未設定の場合はnullなどになります。 |
| / | チケットの作成・更新日時。 |
| 送信本文に含まれる場合のカスタム項目。各要素のid・valueを参照します。 |
- 出力は受信本文の オブジェクトです。後続ステップでは ・ などを直接参照します。 という階層にはなりません。
- Zendesk側のトリガで「Notify active webhook」を設定し、通知本文に オブジェクトを含めてください。通知に含まれる項目だけが利用でき、チケット詳細を自動で追加取得するものではありません。
- 「特定のタグ（オプション）」を指定した場合は、そのタグが配列に含まれると対象です。空欄では1件以上のタグを持つチケット更新が対象です。タグ追加前後の比較は行いません。
- 固定サンプルにある全項目が通常通知でも提供されるとは限りません。Zendesk側の通知本文で送るキーを確認してください。
- ・・ などを後続の記録や通知に利用できます。
出力例（抜粋）
キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。