新規チケット（トリガー）
このピースでできること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. 組織（オプション）
設定メモ: Zendesk 側で Triggers にて「Notify active webhook」を設定してください。
取得できる情報
条件に一致したチケットの情報を取得できます。
| 実際のキー | 内容・条件 |
|---|---|
| / / | チケットID・件名・説明。 |
| / / | 状態・優先度・タグ配列。 |
| / / | 依頼者・担当者・組織のID。未設定の場合はnullなどになります。 |
| / | チケットの作成・更新日時。 |
| 送信本文に含まれる場合のカスタム項目。各要素のid・valueを参照します。 |
- 出力は受信本文の オブジェクトです。後続ステップでは ・ などを直接参照します。 という階層にはなりません。
- Zendesk側のトリガで「Notify active webhook」を設定し、通知本文に オブジェクトを含めてください。通知に含まれる項目だけが利用でき、チケット詳細を自動で追加取得するものではありません。
- 「組織（オプション）」を選択した場合はその組織IDに一致するチケットだけを出力します。空欄またはAll Organizationsは組織で絞り込みません。作成/更新などの通知条件はZendesk側で設定します。
- 固定サンプルにある全項目が通常通知でも提供されるとは限りません。Zendesk側の通知本文で送るキーを確認してください。
- ・・ などを後続の記録や通知に利用できます。
出力例（抜粋）
キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。