新規ユーザー(トリガー)
このピースでできることZendeskの接続方法1. ZendeskのAPIトークンの取得2. 接続を作成3. 接続設定4. 接続名が設定されていることを確認するピースの設定項目1. ユーザーロール(任意)取得できる情報出力例(抜粋)
このピースでできること
- 新しいユーザーが作成されたときに起動します(Zendesk event 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・名前・メールアドレス・電話番号。未登録の場合などはnullや未設定になります。 |
| / | ユーザーのロール・所属組織ID。 |
| / / / | 作成・更新日時・タイムゾーン・言語情報。 |
| / | タグの配列・設定されているカスタムユーザー項目。 |
- 通知本文の 、 内の 、 の順に対象データを探し、見つかったユーザーだけを返します。後続では ・ などを直接参照します。
- ロールを指定した場合、その値(end-user・agent・admin)に一致するユーザーだけが対象です。空欄または「すべてのロール」では絞り込みません。
- Zendeskのユーザー作成イベントを購読します。チケット用のNotify active webhookを手動で作る方式とは異なります。
- 項目は受信通知の内容に依存します。固定のテスト例だけでは全項目の提供は保証されません。・ などを後続の顧客管理に利用できます。
出力例(抜粋)
キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。