お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Webhookを有効にすると、Zoho Recruitでイベントが発生するたびに即時のWeb通知をディスパッチして、third-partyアプリケーションとの対話を可能にします。Webhookを使用すると、HTTP URLを設定し、ワークフロールールにリンクして通知プロセス全体を自動化できます。

シナリオ例

• Zoho RecruitのWebフォームを使用してWebサイトから集められた候補者や連絡先に基づいて、メールマーケティングソフトウェア（例: MailChimp）のメーリングリストに加入者を追加できます。
• 面接者または候補者に処理について通知するSMSリマインダーを送信できます。

理想的なユーザー

• ワークフロー管理権限を持つRecruit ユーザー
• REST APIスキルを持つプログラマー

利用可能性

必要な権限:ワークフロー管理権限を持つユーザーはこの機能にアクセスできます。

Webhookのフィールドリスト

Webhookの設定

Webhookの設定には次の三つのステップが含まれます:

• Webhookの作成。
• ワークフロールールにWebhookをリンク。
• Webhookインテグレーションのテスト。

Webhookを作成するには:

1. 設定 > 自動化 > 処理 > Webhookに移動します。
2. WebhookページでWebhookを設定をクリックします。
3. 新規 Webhookページで必要なパラメーターをすべて入力します。
4. 保存をクリックします。
   

サポートされていないマージ項目値の識別

たまに、Webhookの値説明エディタで使用するマージ項目値が${Unsupported_Field}として表示されることがあります。これが起こる理由をいくつかご紹介します。

カスタム項目の削除

挿入したマージ項目の値が削除されました。削除された項目のマージ項目値がまだWebhookの値説明エディタに存在する場合、その値は${Unsupported_Field}として表示されます。

カスタムルックアップ項目の削除

挿入したカスタムルックアップ項目の値が削除されました。削除されたルックアップ項目のマージ項目値がまだWebhookの値説明エディタに存在する場合、その値は${Unsupported_Field}として表示されます。

利用可能マージ項目のリストに項目が見つからない

選択済みのタブの利用可能なマージ項目に一覧されていない項目のマージ項目値が使用中の場合、それは${Unsupported_Field}として表示されます。
例えば、Job Openingsタブの値説明エディタにマージ項目値${Candidates。Candidate Id}を挿入すると、それはサポートされていない項目として表示されます。

ワークフロールールにWebhookをリンクするには：

1. 次へ移動します：設定 > 自動化 > 処理 > ワークフロールール
2. ワークフロールールページで、ルール作成をクリックします。
3. 新しいルールを作成するページで、ワークフロールールパラメーターを記入します。
4. ワークフロー処理の下で、Webhookを選択します。
5. 通話Webhookポップアップで、必要なWebhookを選択して関連付けるをクリックします。
6. 保存をクリックします。
   

Webhook統合をテストするには：

1. ワークフロールールの基準に従ってRecruitにテストデータを追加します。
2. Webhook通知を経由してZoho Recruitからのデータ受信をアプリケーションで確認します。
3. データの不一致やエラーが発生した場合、Zoho RecruitでWebhook設定を調整します。
4. アプリケーションがZoho Recruitから必要なデータを受信するまでテストを続けます。

覚えておくべき重要なポイント

• ワークフロールールごとに最大6つのWebhook（1つの即時操作と5つの時間ベースの処理）をリンクすることができます。
• Zoho Recruitからの最大10のRecruit項目のデータを、Webhookを使用して第三者アプリケーションに送信することができます。
• Webhook経由で他のアプリケーションからZoho Recruitにデータを取り込むことはできません。
• 第三者アプリケーションが設定した制限に従ってAPIチケットを定期的に更新してください。
• 第三者のAPIの問題によりWebhook統合が動作しなくなった場合、メール通知は受け取られません。
• Webhookでは、POSTメソッドを使用する際にユーザー定義形式に最大10000文字まで許可しています。
• 処理の失敗の場合、Webhookは最初に通知を送信し、その後15分経った後にZoho Recruitシステムから2回目の通知が行われます。これ以降、特定のワークフロートリガーについては、Webhook通知は送信されません。
• 1日の最大件数を超過した場合、システムは残りのWebhook通知を第三者アプリケーションに送信せず、管理者に失敗を通知します。
• 'URLを通知'項目にて、ポート番号を指定する場合、ポート番号80または443のみがサポートされています。
• Zoho Recruitは、Webhookパラメータ設定時に必須の日付/時刻形式とタイムゾーンの選択を提供します。
• Webhookの制限:
• プロフェッショナルエディション - 1日あたり10,000回の呼び出しまたはライセンスあたり100回の呼び出しのいずれか少ない方。
• エンタープライズエディション - 1日あたり20,000回またはユーザーライセンスあたり500回の呼び出しのいずれか少ない方。
  

法人シナリオ

大規模な採用イベントが行われ、すべての面接官はSMSで注意を受ける予定です。このプロセスは、Webhookを使用して効率化できます。

目的

面接がスケジュールされたことについて、面接官にSMSを送信する。

前提条件

• SMS 決済サービス サービスのアカウント
• ワークフロールールへのアクセス

手順

1. SMS 決済サービス サービスのアカウントを作成する
2. Zoho RecruitでWebhookを設定する
3. ワークフロールールを確立する
4. Webhookの統合をテストする

SMS 決済サービス サービスでアカウントを作成し、以下の詳細を取得してWebhookを設定します：

• リクルーター
• 候補者の名前
• 機会の金額
• 面接の詳細
• 面接の予定時間

Zohoは現在、以下のSMS決済サービスプロバイダーと提携しています：

• Twilio
• Clickatell
• Screen Magic
• メッセージメディア

これらの供給元からSMSクレジットとAPI詳細を購入することができます。

ユーザー定義パラメータを設定するときに面接タブから以下の項目を選択します：

• SMS 決済サービスのドメイン名
• ユーザー名
• 認証トークン

以下の詳細をWebhookに指定してください：

通知先URL:
http://<ドメイン名>/smsgateway/post - POSTメソッド

ユーザー定義パラメータ（XMLまたはJSON）

http://www.screen-magic.com/ ' xmlns=' http://www.defns.com/ '>
<ユーザー名>xxxx@xxxxx.com
SMS-Provider
XXXXXXX
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
<メッセージ mobilenumber='${ユーザー.モバイル}'>${Interviews.Interviewer} さん、インタビューが以下の通り予定されています。日時: ${Interviews.差出人}、場所: ${Interviews.場所}、候補者名: ${Interviews.Candidate名}

メモ
上記のXML文字列は、デモンストレーション目的でScreen Magic決済サービスを使用しています。

ワークフロールールページで次の手順に従ってください：

1. すべての新規面接のワークフローを作成します。
   
   • 種類は新規面接です。
   • ステージは完了済みです。
   • クロージング日を選択します。
2. 上記に記載されているようにWebhookを設定します。
3. クリック保存して関連付ける
4. ワークフロールールを保存します。

すべての更新された面接詳細と共にテスト面接データを追加します。
モバイルデバイスでSMS通知を探します。まだSMSが受信されていない場合は、Webhookの設定を調整してテストを続けます。テストが成功したら、テストエントリを削除し、この連携をRecruitユーザーに展開します。

エラーコードを参照

Webhookの実行が失敗すると、次のエラーメッセージの一つがZoho Recruitに表示されます。

HTTPステータスコード

• 400 Bad Request - 必要なパラメータがしばしば欠落しています。
• 401 Unauthorized - 有効な認証トークンが提供されていません。
• 402 Request Failed - パラメータは有効でしたが、リクエストに失敗しました。
• 404 Not Found - リクエストした商品は存在しません。
• 500, 502, 503, 504 サーバーエラー - サードパーティアプリケーションで問題が発生しました。
• エラーコード1 - APIサーバーへの一時的な接続不能。Recruitから送信したリクエストのAPIサーバーログとファイアウォール設定を確認する必要があります。

カスタムエラー

内部処理失敗 - Webhookが処理エラーのために実行できなくなる場合があります。
日次制限到達 - 会社が1日の上限に達した場合に発生します。