Meta Tech Provider

Coexistence の番号を Chatwoot の WhatsApp Cloud インボックスとして使う

Chatwoot の WhatsApp Cloud インボックスで入力する値は 3 つです。WhatsApp Business Account の ID、電話番号 ID、アクセストークンです。Coexistence の番号なら、この 3 つがすべて揃います。これらでインボックスを作成し、番号の Webhook 送信先を Chatwoot の Webhook URL に設定して同じ認証トークンを入力すれば、チームは Chatwoot から、担当者は携帯電話から返信できます。

3 values

WABA ID、電話番号 ID、アクセストークン: Chatwoot の WhatsApp Cloud 手動設定で求められる値です。

smb_message_echoes

Chatwoot はこの Coexistence のイベントに対応しているため、WhatsApp Business アプリから送った返信も会話に表示されます。

Per number

Meta では、企業の電話番号ごとに独自の Webhook コールバック URL を持たせ、アプリの既定値を上書きできます。

Coexistence の番号を Chatwoot に接続するには？

2 か所で、次の順に設定します。

Chatwoot でインボックスを追加し、WhatsApp を選んで、手動設定の WhatsApp Cloud プロバイダーを選びます。番号、電話番号 ID、WhatsApp Business Account の ID、アクセストークンを入力します。これらは EasyCoexistence のダッシュボードの接続画面に表示され、アシスタントからは get_api_credentials で取得できます。すると Chatwoot が、そのインボックス用の Webhook URL と Webhook 認証トークンを表示します。

次に EasyCoexistence で、番号の Webhook 送信先をその URL に設定し、同じ認証トークンを入力します。Meta が Chatwoot に認証リクエストを送り、Chatwoot が応答すれば、以降はその番号宛のすべてのメッセージがインボックスに届きます。間に処理を挟まないため、動かし続けるワークフローはありません。

1Copy credentialsWABA id, phone number id, token

2Create Chatwoot inboxWhatsApp Cloud, manual setup

3Copy webhook + tokenShown by Chatwoot

4Set destinationSame URL and verify token

携帯電話から送った返信は Chatwoot に表示されますか？

はい、表示されます。Coexistence の番号では、WhatsApp Business アプリで入力した返信を Meta が smb_message_echoes イベントとして通知します。Chatwoot の Webhook ジョブがこのフィールドを認識し、該当する会話に送信済みメッセージとして記録します。ソースコードにも、Chatwoot とアプリの両方から返信する企業のメッセージを Chatwoot に同期するケースとして明記されています。

これにより、実際の運用で役割分担が成り立ちます。オーナーは常連のお客様には携帯電話から返信を続け、チームは席で共有インボックスを担当し、互いの送信内容がスクリーンショットの転送なしで見られます。

Chatwoot から送ったメッセージは、同じ番号の Cloud API 経由で送信されるため、携帯電話にも表示されます。

Chatwoot のインボックスにアプリシークレットを設定してはいけないのはなぜですか？

配信が、手元にないシークレットで署名されているからです。Meta は各 Webhook を、サブスクリプションを所有するアプリ、つまり EasyCoexistence のアプリのアプリシークレットで署名します。このシークレットが共有されることはありません。

Chatwoot の現行ソースでは、手動設定の WhatsApp Cloud チャネルで X-Hub-Signature-256 ヘッダーを検証するのは、アプリシークレットが保存されている場合か、Chatwoot 独自の embedded signup で作成したチャネルの場合だけです。アプリシークレットのない手動インボックスは配信を受け付けますが、何かしらのアプリシークレットを入力したインボックスは、すべての配信を未認証として拒否します。

ここで保護の役割を果たすのが認証トークンです。長いランダムな値を選んでください。Chatwoot が Meta の認証リクエストとそれ以外を見分ける手がかりになります。

この番号で Chatwoot にできないことは何ですか？

同時に 2 か所で Webhook を受け取ることです。Meta は番号の Webhook を 1 つの送信先にだけ届けるため、Chatwoot が受け取っている間は、n8n のワークフローには同じイベントが届きません。両方必要な場合は、各配信を Chatwoot とワークフローの両方に転送する小さな中継サーバーを自前で用意し、送信先をそこに向けてください。

Coexistence の制限は、他の環境と同じく適用されます。API の送信は毎秒最大 20 メッセージ、フリーテキストはお客様の最後のメッセージから 24 時間以内にしか送れず、それ以降はメッセージテンプレートを使います。

WhatsApp Business アプリは、少なくとも 14 日に 1 回は開く必要があります。EasyCoexistence がこれを監視しています。

よくある間違い

Chatwoot のインボックスにアプリシークレットを入力する。配信は EasyCoexistence のアプリのシークレットで署名されているため、Chatwoot はすべてを未認証として拒否します。
EasyCoexistence に、Chatwoot が表示したものと違う認証トークンを入力する。Meta の認証が失敗し、インボックスにメッセージが一切届きません。
手動設定ではなく Chatwoot の embedded signup を選ぶ。番号が Chatwoot 独自の Meta アプリ経由で接続され、別の接続になってしまいます。

EasyCoexistence で実現する

easycoexistence.com で番号を接続し、認証情報を Chatwoot の WhatsApp Cloud インボックスにコピーして、Webhook 送信先を Chatwoot に設定します。料金は接続済みの番号 1 件あたり月額 US$ 9 から、台数が増えると US$ 1 まで下がり、最初の 3 日間は無料トライアルです。

よくある質問

セルフホストの Chatwoot でも使えますか？

はい。Webhook URL に app.chatwoot.com の代わりにご自身の Chatwoot ドメインが使われる点だけが違い、残りの設定は同じです。

Chatwoot のために自前の Meta アプリは必要ですか？

いいえ、不要です。番号は EasyCoexistence 経由で接続され、認証情報の提供と Webhook の振り分けも EasyCoexistence が行います。Chatwoot のガイドに Meta アプリの作成手順があるのは、アプリを持っていない前提だからです。

複数の番号を Chatwoot に入れられますか？

はい。番号ごとに WhatsApp Cloud インボックスを 1 つ作成し、各番号の Webhook 送信先に、それぞれのインボックスの URL と認証トークンを設定してください。

EasyCoexistence は会話の内容を見られますか？

いいえ、見られません。Meta が Webhook を Chatwoot に直接届けており、EasyCoexistence が会話の内容を保存することはありません。

続きを読む

Verifying a WhatsApp webhook endpointMeta calls your endpoint with a GET challenge before delivering anything. What it sends, what to return, and why a wrong answer fails silently.The smb_message_echoes webhookHow software sees what a human sent from the WhatsApp Business app. Only exists on Coexistence numbers, and ignoring it causes double replies.Connect WhatsApp to Activepieces on a Coexistence numberUse Activepieces' WhatsApp Business piece on a Coexistence number: paste the token and WABA id, point the webhook at the trigger, and leave the app secret empty.Receive WhatsApp webhooks in a Supabase Edge FunctionMake a Supabase Edge Function the webhook destination of a Coexistence number: answer Meta's verification, store messages in Postgres, reply through the Cloud API.MCP or a webhook: which one you actually needMCP acts when asked. A webhook reacts when something happens. Why an assistant cannot answer customers on its own, and why most systems need both.

始める準備はできましたか？

WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。

無料トライアルを始める

確認日 2026-10-11