Coexistence 番号で WhatsApp を Zoho CRM に接続する

WhatsApp のメッセージはどのように Zoho CRM のレコードになりますか？

Meta は、番号に届いたすべてのメッセージを、設定した Webhook の送信先に送ります。ここでは n8n の Webhook ノードです。ワークフローはペイロードから送信者の番号を取り出し、その番号を phone に指定して Zoho の検索エンドポイントを呼び出します。対象はまずリード、次にコンタクトです。Zoho はモジュール内のすべての電話番号項目を確認するため、Mobile と Phone のどちらに登録されていても一致します。営業担当者がどの項目を使ったかを推測する必要はありません。

一致するレコードがなければ、n8n の Zoho CRM ノードが WhatsApp のプロフィール名と番号でリードを作成します。どちらの場合でも、ワークフローはレコード ID を持っているので、POST /Notes を通じてそのレコードにメッセージをノートとして書き込みます。ノートに必要なのは Note_Content と、モジュールとレコードを示す Parent_Id だけです。

{
  "data": [
    {
      "Note_Title": "WhatsApp, inbound",
      "Note_Content": "do you have anything friday?",
      "Parent_Id": {
        "module": { "api_name": "Leads" },
        "id": "4876876000000624001"
      }
    }
  ]
}

n8n の認証情報にはどの Zoho 権限が必要ですか？

検索と書き込みを行うモジュールの読み取りと作成、さらに Notes の作成権限が必要です。Zoho ではノートのスコープを ZohoCRM.modules.notes.CREATE と呼び、親モジュールの作成スコープも併せて求めます。そのため、リードは作成できてもノートのスコープが付与されていない認証情報では、最後のステップで認可エラーになります。

n8n の Zoho CRM ノードは、リード、コンタクト、アカウント、商談、各種営業ドキュメントに対応し、作成、upsert、取得、全件取得、更新、削除ができます。ただしノートはリソースに含まれないため、ノートは HTTP Request ノードで書き込みます。このノードでは、すでに接続した Zoho の認証情報を再利用できるので、管理する OAuth の許可は 2 つではなく 1 つで済みます。

API ドメインは、利用している Zoho のデータセンターに合わせて設定してください。EU リージョンで作成した認証情報は、zohoapis.com ではなく zohoapis.eu を呼び出します。

Zoho CRM は何件のメッセージを処理できますか？

Zoho は API をクレジット制で計測しており、24 時間のローリング期間ごとの上限は、エディションとユーザー数によって決まります。Free エディションは 5,000 です。Standard は 50,000 に 1 ユーザーあたり 250 を加えた数、Professional は 50,000 に 1 ユーザーあたり 500、Enterprise は 50,000 に 1 ユーザーあたり 1,000 を加えた数で、いずれもエディションごとの上限があります。

受信メッセージ 1 件につき、検索とノートの書き込みが 1 回ずつ、初めての送信者ではさらにリードの作成が発生します。小規模な企業の番号であれば、有料エディションの上限には十分収まります。先に問題になるのは、たいてい同時実行数です。Free は同時 5 件、Standard は同時 10 件までなので、一斉送信への返信が集中するとキューに溜まることがあります。Zoho から上限エラーが返る場合は、n8n のワークフローを 1 件ずつ処理する設定にしてください。

電話から送った返信も Zoho CRM に届きますか？

届けることができます。Coexistence の番号では WhatsApp Business アプリがそのまま使えます。そこから誰かが返信すると、Meta はその送信メッセージのエコーを、smb_message_echoes フィールドとして同じ Webhook の送信先に送ります。

ワークフローにエコー用の分岐を作り、送信済みと分かるタイトルを付けてノートとして書き込んでください。Zoho でリードを開いた営業担当者は、会話の双方のやり取りを読めるようになり、CRM にスクリーンショットを貼り付ける必要もなくなります。

ワークフロー自身が Cloud API で送るメッセージも同様です。たとえば商談のステージが変わったときに送る承認済みテンプレートは、送信の時点で記録するのが最適です。その時点でワークフローが本文とレコード ID を保持しているからです。

よくある間違い

• 認証情報にリードのスコープだけを付与し、ZohoCRM.modules.notes.CREATE を付与していない。検索とリードの作成までは動きますが、その後のノートがすべて失敗します。
• 別の Zoho データセンターのアカウントから zohoapis.com を呼び出している。アカウントが属するリージョンの API ドメインを使ってください。
• リードだけを検索している。成約済みのお客様はコンタクトにいるため、その方が連絡してくるたびに重複したリードが新しく作られます。

よくある質問

続きを読む