Web通知の設定項目

メモ： 

1. データの送信方法（HTTPリクエストのメソッド）として、POSTまたはPUTを選択した場合、ヘッダーとボディの設定画面が表示されます。
   
2. また、データの送信方法（HTTPリクエストのメソッド）として、DELETEを選択した場合、ヘッダーとURLパラメーターの設定画面が表示されます。
3. データの送信方法（HTTPリクエストのメソッド）として、GETを選択した場合、URLのパラメーターの設定画面のみが表示されます。
   
4. ［予定］タブのパラメーターとして参加者の個人情報（メールアドレス、電話番号、携帯番号など）を使用することはできません。
   

• Web通知の作成
  
• ワークフロールールへの関連付け
  
• 連携のテスト
  

Web通知を作成するには

1. ［設定］ → ［自動化］ → ［処理］ → ［Web通知］ タブの順に移動します。
   
2. Web通知 の一覧ページで、右上にある ［Web通知を設定する］ をクリックします。
   
3. 新しいWeb通知 の設定画面で、必要なパラメーターをすべて指定します。
   
4. ［保存する］ をクリックします。
   

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

Web通知の 個別指定形式パラメーターの値 の入力欄に挿入した差し込み項目の値が、 ${使用できない項目} と表示される場合があります。これは、次のような理由で発生します。

カスタム項目の削除

挿入した差し込み項目に対応するカスタム項目が削除された場合が該当します。そのため、Web通知の 個別指定形式パラメーターの値 の入力欄に、削除されたカスタム項目の差し込み項目が挿入されたままの場合、該当の項目は ${使用できない項目} として表示されます。

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

値の挿入に使用した、ルックアップの種類のカスタム項目が削除された場合が該当します。そのため、Web通知の 個別指定形式パラメーターの値 の入力欄に、削除されたルックアップ項目の差し込み項目が挿入されたままの場合、該当の項目は ${使用できない項目} として表示されます。

タブで使用できない差し込み項目の使用

選択したタブの使用可能な差し込み項目の一覧にはない項目の差し込み項目を使用した場合、該当の項目は「 ${使用できない項目} 」として表示されます。

たとえば［商談］タブの 個別指定形式パラメーターの値 の入力欄に、差し込み項目として${見込み客.見込み客ID}を挿入すると、該当の項目は ${使用できない項目} として表示されます。

連携や機能の無効化

Zoho CRMアカウントの設定で連携や機能を無効にした場合、該当の連携の一部として作成された項目も利用できなくなります。このような項目に対応する差し込み項目が、 個別指定形式パラメーターの値 の入力欄に挿入されている場合、該当の値は ${使用できない項目} として表示されます。これは、次の機能や連携で発生する可能性があります。

• Google 広告連携 ：使用できなくなったGoogle 広告の項目は、Web通知のパラメーターでも使用できなくなります。
  
• 訪問者追跡（Zoho SalesIQ連携） ：使用できなくなった訪問者追跡（Zoho SalesIQ）の項目は、Web通知のパラメーターでも使用できなくなります。
  
• テリトリー管理 ：テリトリー管理で使用できなくなった項目は、Web通知のパラメーターでも使用できなくなります。
  
• 複数通貨 ：無効になった通貨は、Web通知のパラメーターでも使用できなくなります。
  

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

1. ［設定］ → ［自動化］ → ［ワークフロールール］ の順に移動します。
   
2. ワークフロールール の一覧ページで、右上にある ［ルールを作成する］ をクリックします。
   
3. 新しいルールの作成 画面で、ワークフロールールの詳細を設定します。
   
4. ワークフロールールの処理 の設定で、［Web通知］を選択します。
   
5. Web通知の関連付け画面で、Web通知を選択して ［関連付ける］ をクリックします。
   
6. ［保存する］ をクリックします。
   

Web通知の処理をテストするには

1. ワークフロールールの条件に応じたテストデータを、Zoho CRMに追加します。
   
2. 連携先のアプリケーションで、Web通知によってZoho CRMからデータが送信されたかどうか、送信されたデータの内容が適切かどうかを確認します。
   
3. エラーまたはデータの不一致がある場合は、Zoho CRMでWeb通知の設定を修正します。
   
4. 連携先のアプリケーションでZoho CRMから必要なデータを取得できるようになるまで、上記の手順でテストを繰り返し実行します。
   

留意事項

• ワークフロールールごとに、Web通知を6件まで関連付けることができます（すぐに実行する処理を1件＋時間基準処理を5件まで）。
  
• Web通知の設定で、Zoho CRMから外部アプリケーションへのデータ送信用に指定できる項目の値は、10件までです。
  
• Web通知を使用して、外部アプリケーションからZoho CRMにデータを取得することはできません。
  
• 外部アプリケーションにデータを送信するには、通常、対象のアプリケーションのAPIを実行します。その際に使用する認証情報は、外部アプリケーションの仕様に応じて設定や更新を行う必要があります。
  
• 外部アプリケーションのAPIの問題が原因でWeb通知連携が機能しなくなった場合でも、その旨を通知するメールは送信されません。
  
• POSTメソッドを使用したWeb通知では、個別指定形式パラメーターとして最大10,000文字を使用できます。
  
• Web通知の処理に失敗した場合、エラーに関するメールがZoho CRMから自動で送信されます。さらに、15分経過後に、2度目のメールが送信されます。以降は、該当のワークフロールールのWeb通知の実行に関するメールは送信されません。
  
• 1日あたりの実行回数の上限を超えた場合、予定していた残りのWeb通知は外部アプリケーションには送信されません。管理者にはエラーに関するメールが送信されます。
  
• ［通知先のURL］ 項目でポート番号を指定する場合、指定可能なポート番号は「 80 」または「 443 」のみです。
  
• Web通知のパラメーター設定時に、必要に応じて 日付 ／ 日時 形式と タイムゾーン を選択できます。
  
• Web通知の実行回数の上限：
  
• プロフェッショナルプラン：50,000回／日、または、100回×ユーザー数（いずれか少ない方）
  
• エンタープライズプラン：500,000回／日、または、500回×ユーザー数（いずれか少ない方）
  
• アルティメットプラン：1,000,000回／日、または、1,000回×ユーザー数（いずれか少ない方）
  

利用例1

Zoho CRMで商談を受注したときに、Zoho Creatorで作成した販売手数料管理アプリケーションで、代理店の販売手数料を自動計算します。

メリット

商談を受注すると、販売代理店と受注金額の情報が、販売手数料管理アプリケーションに自動で送信され、販売代理店ごとに異なる販売手数料の計算を効率化できます。また、アプリケーションの連携により、人為的な計算ミスを回避できます。

利用条件

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

設定手順

1. Zoho Creatorを使用して、自社の要件に合わせて販売手数料管理アプリケーションを作成します（ アプリケーションの作成方法 についてはZoho Creatorのはじめてガイドをご参照ください）。
   
2. Web通知の設定
   
3. ワークフロールールの設定
   
4. 連携のテスト
   

手順1：Zoho Creatorでのアプリケーションの作成

Zoho Creatorで、販売手数料管理アプリケーションを作成します。追加する項目の例は以下のとおりです。

• 営業担当者
  
• 商談名
  
• 顧客名
  
• 商談の総額
  
• 商談の種類（［新規］または［既存］）
  
• 完了予定日
  
• 販売手数料
  

Zoho Creatorを使用したアプリケーションの作成方法については、 Zoho Creatorのはじめてガイド をご参照ください。

手順2：Web通知の設定

Web通知の設定で、個別指定形式パラメーターを選択します。その後、［商談］タブを選択し、値を送信する対象の項目を選択します。選択する項目の例は以下のとおりです。

• 商談名
  
• 完了予定日
  
• 種類
  
• データの担当者
  
• 総額
  

Web通知の設定で、次の詳細を入力します。

独自パラメーター：