Webhook（Web通知）の項目の一覧

Webhook（Web通知）の設定

Webhook（Web通知）を設定するには、次の3つの手順を実行します：

• Webhook（Web通知）を作成する
  
• Webhook（Web通知）をワークフロールールに関連付ける
  
• Webhook（Web通知）連携をテストする
  

Webhook（Web通知）を作成するには

1. ［設定］ > ［自動化］ > ［処理］ > ［Webhook（Web通知）］ に移動します。
   
2. ［Webhook（Web通知）］ ページで、 ［Webhook（Web通知）の設定］ をクリックします。
   
3. ［新しいWebhook（Web通知）］ ページで、必要なパラメーターをすべて指定します。
   
4. ［保存］ をクリックします。
   
   
   
   

使用できない差し込み項目値の識別

Webhook（Web通知）の 値の詳細 の編集画面で使用した差し込み項目の値が、 ${unsupported_field} と表示される場合があります。これは、次のような理由で発生します。

カスタム項目の削除

値を挿入した差し込み項目が削除されています。Webhook（Web通知）の 値の詳細 の編集画面に、削除済み項目の差し込み項目値が引き続き含まれる場合、その値は ${Unsupported_Field} として表示されます。

カスタム検索項目の削除

値を挿入したカスタム検索項目が削除されています。Webhook（Web通知）の 値の詳細 の編集画面に、削除された検索項目の差し込み項目値が引き続き含まれる場合、その値は ${Unsupported_Field} として表示されます。

使用可能な差し込み項目のリストにない項目

選択したタブの使用可能な差し込み項目リストにはない項目の差し込み項目値を使用した場合、 ${Unsupported_Field} として表示されます。

たとえば［商談］タブの 値の詳細 の編集画面に、差し込み項目値${Leads.Lead Id}を挿入すると、使用できない項目として表示されます。 

連携/機能の無効化

アカウントの機能または連携が無効になっている場合は、連携の一部として作成された項目も、無効にした後のアカウントでは使用できません。このような項目の差し込み項目値が 値の詳細 の編集画面に挿入されている場合、 ${Unsupported_Field} として表示されます。これは、次の機能/連携に適用されます。

• Google 広告連携 - 使用できなくなったGoogle広告項目は使用できません。
  
• 訪問者追跡（Zoho SalesIQ連携） - 使用できなくなった訪問者追跡項目は使用できません。
  
• テリトリー管理 - 使用できなくなったテリトリー管理項目は使用できません。
  
• 複数通貨 - 無効にされた通貨は使用できません。
  

Webhook（Web通知）をワークフロールールに関連付けるには

1. ［設定］ > ［自動化］ > ［ワークフロールール］ に移動します。
   
2. ［ワークフロールール］ ページで、 ［ルールの作成］ をクリックします。
   
3. ［新しいルールの作成］ ページで、ワークフロールールのパラメーターを指定します。
   
4. ［ワークフローの処理］ でWebhook（Web通知）を選択します。
   
5. ［Webhook（Web通知）の呼び出し］ポップアップで、Webhook（Web通知）を選択して ［関連付け］ をクリックします。
   
6. ［保存］ をクリックします。
   
   
   
   

Webhook（Web通知）連携をテストするには

1. ワークフロールールの条件に従い、CRMにテストデータを追加します。
   
2. アプリケーションで、Webhook（Web通知）を介してZoho CRMから受信したデータを確認します。
   
3. エラーまたはデータの不一致がある場合は、Zoho CRMでWebhook（Web通知）の設定を変更します。
   
4. 使用しているアプリケーションがZoho CRMから必要なデータを取得するまで、このテストを続けます。
   

重要事項

• ワークフロールールごとに、最大6件までのWebhook（Web通知）（すぐに実行する処理を1件+時間基準処理を5件まで）を関連付けることができます。
  
• Webhook（Web通知）を使用して、Zoho CRMから外部アプリケーションに、最大10件のCRM項目のデータを転送できます。
  
• Webhook（Web通知）を使用して、他のアプリケーションからZoho CRMに、データを取得することはできません。
  
• APIチケットは、外部アプリケーションの制限に従って、定期的に更新する必要があります。
  
• 外部サービスAPIの問題が原因でWebhook（Web通知）連携が機能しなくなると、メール通知を受信できません。
  
• Webhook（Web通知）では、POSTメソッドを使用している場合、ユーザー定義形式で最大10,000文字を使用できます。
  
• プロセスに障害が発生した場合、Webhook（Web通知）は最初に通知を送信し、Zoho CRMシステムは15分後に2回目の通知を送信します。その後、システムはその特定のワークフロー実行に関するWebhook（Web通知）を送信しません。
  
• 1日あたりの上限を超えた場合、残りのWebhook（Web通知）は外部アプリケーションには送信されず、管理者にエラーが通知されます。
  
• ［通知先のURL］ 項目でポート番号を設定する場合、対応しているポート番号は「 80 」または「 443 」のみです。
  
• Zoho CRMには、Webhook（Web通知）のパラメーター設定時に「 日付 / 日時 」形式と「 タイムゾーン 」を選択するオプションがあります。
  
• 1日あたりのWebhook（Web通知）呼び出し回数の上限：
  
• プロフェッショナルプラン - 50,000回/日、または、100回/日xユーザー数（いずれか少ない方）。
  
• エンタープライズプラン - 500,000回/日、または、500回/日xユーザー数（いずれか少ない方）。 
  
• アルティメットプラン - 1,000,000回/日、または、1,000回/日xユーザー数（いずれか少ない方）。  
  

ビジネスでの利用例1

Zoho CRMで機会が完了すると、Zoho Creatorアプリで販売手数料を計算できます。

目的

営業マネージャーと給与計算チームは、販売手数料アプリを使用して、組織が設定した定義済みの計算式（受注した契約または売上高の、一律2％など）に基づき営業担当者の報酬を計算できます。このアプリケーションを使用すると、営業担当者の販売手数料を計算する際に、手入力を減らしてエラーを最小限に抑え、時間を節約できます。また、営業担当者は月次の販売手数料を、一元的に追跡できます。

前提条件

• Zoho Creatorアプリケーションのアカウント
  
• Zoho APIへのアクセス権限
  
• Zoho Creatorの知識
  

手順

1. Zoho Creatorを使用して販売手数料アプリを作成する（ アプリの作成 についてはZoho Creatorのチュートリアルをご参照ください）   
   
2. Zoho CRMでWebhook（Web通知）を設定する
   
3. ワークフロールールを設定する
   
4. Webhook（Web通知）の連携をテストする            
   

手順1：Zoho Creatorで販売手数料アプリを作成する             

Zoho Creatorで、次の項目を含む販売手数料アプリを作成します： 

• 営業担当者
  
• 商談名
  
• 顧客名
  
• 商談の総額
  
• 商談の種類：［新しいビジネス］または［既存ビジネス］
  
• 受注日
  
• 販売手数料
  

Zoho Creatorを使用したアプリケーションの作成については、Zoho Creatorのオンラインヘルプ をご参照ください。

手順2：Webhook（Web通知）を設定する

ユーザー定義パラメーターの設定時に、［商談］タブから次の項目を選択します：

• 商談名
  
• 受注日
  
• 種類
  
• データの担当者
  
• 総額
  

Webhook（Web通知）で、次の詳細を指定します：

通知先のURL：

1. https://creator.zoho.com/api/xml/write - POST メソッド
   

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

メモ 

• 上記のXML文字列では、名前はZoho Creatorアプリの項目を表し、データ値はZoho CRMから送信されます。
  
• <applicaton name>は、Zoho Creatorのフォームを含むアプリケーションの名前です。アプリケーションの名前は、Zoho Creatorの［アプリケーションの設定］タブから取得できます。
  
• <form name>は、Zoho Creatorでデータを編集するフォームの名前です。フォームの名前は、Zoho Creatorアカウントのフォーム設定から取得できます。
  
• Creatorアプリの日付形式が、yyyy-MM-dd形式であることを確認します。日付形式は、Zoho Creatorアカウントのアプリケーション設定から変更できます。
  

カスタムパラメーター：

メモ

• 他のアプリからZoho Creatorにデータを取得するには、Zoho APIのユーザー名と認証トークンを指定する必要があります。Zoho API情報の生成については、 オンラインヘルプ をご参照ください。
  

手順3：ワークフロールールを設定する         

［ワークフロールール］ページで、次の手順を実行します：

1. ワークフロー条件を次のように設定します： 
   
   • ［種類］は ［新しいビジネス］
     
   • ［ステージ］は ［受注］
     
2. ［次へ］ をクリックします。
   
   
   
   
   
3. すぐに実行する処理として、Webhook（Web通知）を選択します。
   
4. ［Webhook（Web通知）の呼び出し］ ポップアップで、リストからWebhook（Web通知）を選択して ［関連付け］ をクリックします。
   
5. ワークフロールールを保存します。 
   
   
   
   
   
   

ワークフロールールへのWebhook（Web通知）の関連付け

手順4：連携をテストする         

1. CRMにテスト商談を追加します。［種類］項目は［新しいビジネス］、［ステージ］項目は［受注］に指定します。テストデータの入力時に、［総額］、［完了予定日］、［データの担当者］、［取引先名］、［商談名］も入力します。
   
2. Zoho Creatorで販売手数料アプリを開き、CRMデータを確認します。
   
   データを受信していない場合は、Webhook（Web通知）の設定を変更して、テストを続けます。テストが正常に終了したら、テストデータを削除し、この連携をCRMユーザーに展開します。
   
   

ビジネスでの利用例2

顧客と営業担当者にSMSメール通知を送信できます。

目的

顧客からの支払いの期日が今日だとします。Webhook（Web通知）をワークフロールールの時間基準処理に関連付けることで、支払い期日、顧客名、総額の詳細を記載したSMSを営業担当者に送信できます。

前提条件

• SMSゲートウェイサービスのアカウント
  
• ワークフロールールへのアクセス権限
  

手順

1. SMSゲートウェイサービスでアカウントを作成する           
   
2. Zoho CRMでWebhook（Web通知）を設定する           
   
3. ワークフロールールを設定する
   
4. Webhook（Web通知）の連携をテストする           
   

手順1：SMSゲートウェイサービスでアカウントを作成する         

SMSゲートウェイサービスでアカウントを作成し、次の詳細を取得して、Webhook（Web通知）を設定します： 

• 営業担当者
  
• 商談名
  
• 顧客名
  
• 商談の総額
  
• 商談の種類：新しいビジネス
  
• ステージ：受注
  
• 支払期限日（カスタム項目）
  

現在、Zohoは次のSMSゲートウェイサービスと提携しています：

• BulkSMS
  
• Clickatell
  
• Screen Magic
  
• Valueleaf
  
• Solutions Infini
  

上記の仕入先から、SMSクレジットとAPIの詳細を購入できます。

手順2：Webhook（Web通知）を設定する

ユーザー定義パラメーターの設定時に、［見込み客］タブから次の項目を選択します：

• SMSゲートウェイのドメイン名
  
• ユーザー名
  
• 認証トークン
  

Webhook（Web通知）で、次の詳細を指定します：

通知先のURL：

1. http://<Domain Name>/smsgateway/post - POSTメソッド
   

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

メモ 

• 上記のXML文字列では、デモ用にScreen Magicゲートウェイを使用しました。
  

手順3：ワークフロールールを設定する 

［ワークフロールール］ページで、次の手順を実行します：

1. ワークフロー条件を次のように設定します： 
   
   • ［種類］は  ［新しいビジネス］
     
   • ［ステージ］は  ［受注］
     
   • ［完了予定日］を選択します。 
     
2. 時間基準の処理として、Webhook（Web通知）を選択します。
   
3. ワークフロールールを保存します。
   

ワークフロールールの条件

 

ワークフロールールへのWebhook（Web通知）の関連付け

手順4：連携をテストする 

1. CRMにテスト商談を追加します。そのとき、［種類］項目は［既存ビジネス］、［支払期限］項目は［今日］に指定します。テストデータの入力時に、［総額］、［完了予定日］、［データの担当者］、［取引先名］、［商談名］も入力します。
   
2. 携帯電話でSMSメール通知を確認します。
   
   SMSを受信していない場合は、Webhook（Web通知）の設定を変更して、テストを続けます。テストが正常に終了したら、テストデータを削除し、この連携をCRMユーザーに展開します。 
   

エラーコードの参照

Webhook（Web通知）の実行に失敗すると、Zoho CRMに次のいずれかのエラーメッセージが表示されます：

HTTPステータスコード

• Bad Request - 必須パラメーターが不足している場合があります。
  
• Unauthorized Request  - 有効な認証トークンが指定されていません。
  
• Request Failed - パラメーターは有効でしたが、リクエストに失敗しました。
  
• Page Not Found - リクエストされた項目が存在しません。
  
• Third-party error - 外部アプリケーションで問題が発生しました。
  
• Third-party server not available - 外部サービスのAPIサーバーとの接続が切れました。
  
• Internal process failure - Webhook（Web通知）の処理中にエラーが発生しました。
  
• Day limit reached - 組織アカウントの1日あたりの上限に達しました。
  
• Invalid URL - URLにSSRFの脆弱性があるか、無効なURLです。
  
• Socket timeout - Webhook（Web通知）が呼び出されましたが、10秒間レスポンスを受信しませんでした。