Coexistence の番号で WhatsApp を GoHighLevel のコンタクトに連携する
番号の Webhook を n8n のワークフローに送り、n8n の HighLevel ノードで送信者を HighLevel のコンタクトとして upsert し、各メッセージを POST /contacts/{contactId}/notes でノートとして書き込みます。認証にはサブアカウントの設定で発行する Private Integration トークンを使います。phone_number_id とサブアカウントの対応表を持てば、1 つのワークフローですべてのクライアントに対応できます。
HighLevel API v2 のバースト制限。アプリごと、サブアカウントまたは会社ごとにカウントされます。
HighLevel API v2 で 1 日に許可されるリクエスト数。アプリごと、リソースごとです。
ローテーション後、古い Private Integration トークンと新しいトークンの両方が使える重複期間。
WhatsApp のメッセージはどのように HighLevel のコンタクトに届きますか？
Meta は、番号に届いたメッセージをすべて、設定した Webhook の送信先に POST します。ここでは n8n の Webhook ノードです。ワークフローは送信者の電話番号と WhatsApp のプロフィール名を n8n の HighLevel ノードに渡します。このノードのコンタクトリソースには作成または更新の操作があるため、新しい送信者はコンタクトになり、既知の送信者は重複せずに見つかります。
コンタクト ID が得られたら、HTTP Request ノードでメッセージ本文を /contacts/{contactId}/notes に POST します。ノートはコンタクトのレコードに表示され、開いた人は誰でもお客様が何を書いたかを確認できます。フォローアップが必要なメッセージの場合は、HighLevel ノードでコンタクトにタスクを作成したり、パイプラインに商談を作成したりすることもできます。どちらもノードが直接サポートしています。
チームは、これまでどおり WhatsApp Business アプリから返信を続けられます。
ワークフローにはどのトークンを使うべきですか？
Private Integration トークンです。HighLevel の API v2 には OAuth かこのトークンのどちらかでアクセスし、旧 v1 の API キーはすでにサポートが終了しています。Private Integration トークンはサブアカウントの設定で作成し、チェックを入れた権限にスコープが限定され、他のアクセストークンと同じく Authorization ヘッダーで送信します。
このトークンは自動では更新されません。これは自動化には好都合で、誰かがローテーションするまで使い続けられます。ローテーションすると、HighLevel は古いトークンと新しいトークンを 7 日間どちらも有効にします。この期間内に新しいトークンを n8n に貼り付けてください。
スコープは、ワークフローに必要なものだけにチェックを入れてください。コンタクトとノート、使う場合は商談とタスクです。設定に Private Integrations が見つからない場合は、HighLevel の案内に従い、Labs で有効にしてください。
1 つのワークフローで複数のクライアントのサブアカウントに対応するには？
受信した番号でルーティングします。Meta が送るすべての Webhook には、メッセージを受け取った企業の番号の phone_number_id が含まれています。すべてのクライアントの番号を同じ n8n の Webhook に向け、各 phone_number_id をそのクライアントのサブアカウントとトークンに対応づける小さなテーブルを用意し、実行の最初にトークンを引き当てます。
これにより、全クライアントに対して保守するワークフローは 1 つで済みます。代理店にとっては特に大きな利点です。照合ロジックやノートの形式を修正すれば、全員に一度に反映されます。
レート制限はアプリごと、サブアカウントごとにカウントされるため、クライアント同士で枠を奪い合うことはありません。それぞれに 10 秒あたり 100 リクエスト、1 日 200,000 件が割り当てられます。
スマートフォンで入力した返信も HighLevel に届きますか？
届けられます。Coexistence の番号では WhatsApp Business アプリを引き続き使え、そこから返信すると、Meta は送信したメッセージのエコーを同じ Webhook の送信先に smb_message_echoes フィールドで送ります。
このエコー用の分岐を追加し、送信済みと分かる形でノートに書き込んでください。コンタクトのレコードには、お客様の発言と企業の返信が順番に並びます。クライアントが CRM を開いたときに期待する表示です。
ワークフロー自身が Cloud API でメッセージを送る場合は、たとえば予約確定後に承認済みのテンプレートを送るときなどに、送信の時点でノートを書き込みます。ワークフローは本文とコンタクト ID をすでに持っています。
よくある間違い
- v1 の API キーを使うこと。HighLevel の v1 API はサポートが終了しています。API v2 には Private Integration トークンか OAuth が必要です。
- 7 日間の重複期間内に n8n を更新せずに Private Integration トークンをローテーションすること。古いトークンが失効すると、すべての呼び出しが失敗します。
- すべてのクライアントのメッセージを 1 つのサブアカウントのトークンで書き込むこと。先に phone_number_id を正しいサブアカウントに対応づけないと、レコードが別のクライアントに入ってしまいます。
easycoexistence.com で各クライアントの番号を接続し、すべての Webhook の送信先を同じ n8n ワークフローに向け、phone_number_id でルーティングします。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を追加するほど US$ 1 までです。最初の 3 日間は無料です。
よくある質問
メッセージは HighLevel の Conversations タブに表示されますか？
このワークフローでは表示されません。API 経由で書き込むのはコンタクト、ノート、タスク、商談で、会話への返信は WhatsApp Business アプリまたはワークフローから行います。
n8n の代わりに Make や Zapier を使えますか？
はい。カスタム Webhook またはキャッチフックでメッセージを受信し、HTTP ステップで同じトークンを使って HighLevel の API v2 を呼び出します。
予約が入ったら WhatsApp で確認メッセージを送れますか？
はい、ワークフローで可能です。HighLevel が n8n の Webhook URL を呼び出すと、n8n が番号の phone_number_id とトークンを使い、Cloud API で承認済みのテンプレートを送信します。
EasyCoexistence はメッセージを保存しますか？
いいえ。Meta は各 Webhook をお客様の n8n の URL に直接配信し、EasyCoexistence が会話の内容を保存することはありません。
続きを読む
始める準備はできましたか？
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日