1. ［設定］→［開発者向け情報］→［Webhook］の順に移動します。

2. ［新しいWebhook］をクリックします。

3. 処理の選択欄で、［タブ］から［IM］（インスタントメッセージ）を選択し、［処理］から［セッションのステータス］を選択します。

4. Webhook URLを入力します。ここで指定したURLに送信データが送られます。

5. 必要に応じて部門IDを指定し、特定の部門の通知だけを受信するように設定します。

6. ［保存する］をクリックし、動作をテストします。

質問：Webhookを受信できません。何を確認すればよいですか？

回答：主な原因として、Webhookが無効になっている、送信先の応答が遅いまたは正しくない、Webhook作成時の検証に失敗した、などが考えられます。利用中のプランの上限を確認します。有効にできるWebhookは、プロフェッショナルプランでは5件、エンタープライズプランでは10件、アルティメットプランでは20件です。上限に達している場合、新しく作成したWebhookは無効のままになります。また、Webhookの送信先サーバーから、データの受信後5秒以内に正常な応答（HTTPステータスコード200）が返されるように設定されていることをご確認ください。Webhookを作成すると、Zoho Deskから最初に検証用のGETリクエストが指定URLに送信されます。送信先から正常な応答（HTTPステータスコード200）が返されない場合、Zoho DeskからHTTP POSTリクエストが送信され、接続確認が再試行されます。どちらも失敗すると、Webhookは作成されません。

質問：送信先から、送信先URLが削除されていることを示す応答（HTTPステータスコード410）が返されました。何が起きたのでしょうか？

回答：HTTPステータスコード410が返されると、Zoho Deskでは送信先URLが存在しなくなったと判断され、Webhookの登録が自動で解除されます。送信先を修正した後、Webhookを作成し直す必要があります。

質問：Webhookは受信できますが、どのステータス変更によって実行されたか分かりません。

回答：必ずsessionStatus（新しいステータス）とsessionOldStatus（変更前のステータス）を組み合わせて確認します。たとえば、sessionOldStatus: "ACTIVE"とsessionStatus: "ON_HOLD"の組み合わせは、対応中のチャットが保留にされたことを示します。一方、sessionOldStatus: "OPEN"とsessionStatus: "ENDED"の組み合わせは、誰も対応を開始しないままセッションが終了したことを示します。

質問：特定の部門のWebhookだけを受信できますか？

回答：はい、できます。Webhookの登録時にdepartmentIdsの一覧を指定します。経路ごとに別のチームが対応しており、各チームに関連するセッションの通知だけを受信したい場合などに役立ちます。

質問：Webhookを作成する権限がありません。

回答：Webhookの作成可否は権限ごとに設定されます。権限設定でWebhook権限が有効になっているユーザーのみが、Webhookを作成できます。Zoho Deskの管理者に、［設定］→［ユーザーと権限］→［権限］→［権限］の順に移動し、対象の権限でWebhook権限を有効にするよう依頼してください。

質問：Webhookを公開前にテストするにはどうすればよいですか？

回答：開発中は、webhook.siteやngrokなどのサービスを使用して、ローカルの送信先を外部からアクセス可能にします。テスト用URLを送信先としてWebhookを作成し、Zoho Deskでセッションの変更を再現します（例：テストチャットを開始し、保留にしてから終了します）。本番URLに切り替える前に、想定した送信データを受信できるかどうかを確認します。