Zendesk 連携

サービス連携画面を開く

Pigeon Workflow ダッシュボードの「設定」→「サービス連携」→「Zendesk」を選択します。

サブドメイン・メール・API トークンを入力

サブドメイン: Zendesk URL の https://<ここ>.zendesk.com 部分（例: loftal）
メール: Zendesk 管理者のメールアドレス
API トークン: 後述「② Zendesk 側で API トークンを取得」で取得した値

「接続」をクリック → Webhook URL が発行される

例: https://app.pigeon-workflow.ai/api/webhooks/zendesk/<一意のトークン>
この URL を ③ Zendesk 側の Webhook 登録で使います。コピーしておいてください。

Zendesk 管理画面にログイン

https://<サブドメイン>.zendesk.com/admin にアクセスします。

API トークン設定画面を開く

左メニュー「アプリと連携」→「API」→「Zendesk API」タブを開きます。

「トークンアクセス」を有効化

「トークンアクセス」の「有効化」をクリックします（未有効の場合のみ）。

「API トークンを追加」

説明欄に「Pigeon Workflow」など分かりやすい名前を入れて「保存」。表示される長い文字列をコピーします（一度しか表示されないので注意）。

Pigeon Workflow の登録画面に戻る

コピーしたトークンを Pigeon Workflow の登録画面に貼り付けます。

Webhook を登録

Zendesk 管理画面 → 「アプリと連携」→「Webhook」→「Webhook を作成」。
名前: 任意（例: 「Pigeon Workflow 自動返信」）
エンドポイント URL: 手順①で発行された Webhook URL
リクエストメソッド: POST / リクエスト形式: JSON / 認証: なし

Trigger を作成 → Webhook を呼び出す

Zendesk 管理画面 → 「オブジェクトとルール」→「ビジネスルール」→「トリガ」→「トリガを追加」。
条件: 「チケット: 更新タイプ → 作成」を必ず追加（必要に応じてタグ・優先度・件名フィルタも追加）。
アクション: 「アクティブな Webhook へ通知」→ 上で作成した Webhook を選択。

JSON 本文: Pigeon Workflow が受け付ける形式で記述（最低限以下を含める）:

{
  "ticket_id": "{{ticket.id}}",
  "subject": "{{ticket.title}}",
  "description": "{{ticket.description}}",
  "latest_comment_html": "{{ticket.latest_comment_html}}",
  "ticket": {
    "requester": {
      "name": "{{ticket.requester.name}}",
      "email": "{{ticket.requester.email}}"
    },
    "status": "{{ticket.status}}",
    "priority": "{{ticket.priority}}"
  },
  "attachments": "{{ticket.latest_comment_formatted.attachments}}"
}

「保存」→ 試しにチケットを作成して動作確認

Zendesk で新規チケットを作成すると、登録した Pigeon Workflow が呼び出されます。 実行履歴は Pigeon Workflow の「実行履歴」画面で確認できます。