Meta Tech Provider

Coexistence 番号の WhatsApp メッセージを HubSpot に記録する

HubSpot には Communications オブジェクトがあり、チャネルタイプに WHATS_APP を指定できます。HubSpot の外で行われたメッセージを記録するための仕組みです。番号の Webhook を n8n のワークフローに送り、電話番号でコンタクトを検索または作成し、メッセージごとに /crm/v3/objects/communications へ POST します。会話はコンタクトのタイムラインに記録され、チームはこれまでどおり WhatsApp Business アプリから返信できます。

WHATS_APP

HubSpot の Communications オブジェクトで、hs_communication_channel_type がサポートする値です。

100 / 10 s

HubSpot Free と Starter で、非公開配布アプリ 1 つあたりに適用されるバースト制限です。Professional と Enterprise では 190 です。

Pro or Enterprise

HubSpot 独自の WhatsApp 受信トレイチャネルを使うために必要な Marketing Hub または Service Hub のプランです。

WhatsApp メッセージはどのように HubSpot のコンタクトに記録されますか？

3 つのステップで記録されます。まず Meta が、番号に設定した Webhook の送信先（ここでは n8n の Webhook ノード）へメッセージを届けます。次にワークフローが、送信者の電話番号で HubSpot のコンタクトを検索し、一致するものがなければ新規作成します。最後に、メッセージ本文を持つ communication レコードを作成し、そのコンタクトに関連付けます。

HubSpot はこの用途のために Communications オブジェクトを用意しています。HubSpot の外で送受信された WhatsApp、LinkedIn、SMS のメッセージを表し、記録された通話やメールと同じようにレコードのタイムラインに表示されます。必須のプロパティは、チャネルタイプ、CRM に設定した hs_communication_logged_from、本文、オーナー、タイムスタンプです。

HubSpot のマーケットプレイスアプリは必要ありません。n8n の HTTP Request ノードは、HubSpot ノード用に設定済みの認証情報をそのまま使えます。呼び出しはメッセージごとに POST が 1 回です。

POST /crm/v3/objects/communications, one inbound message (add an associations array for the contact)

{
  "properties": {
    "hs_communication_channel_type": "WHATS_APP",
    "hs_communication_logged_from": "CRM",
    "hs_communication_body": "do you have anything friday?",
    "hubspot_owner_id": "75480934",
    "hs_timestamp": "2026-10-11T14:20:00.000Z"
  }
}

スマートフォンから入力した返信も記録できますか？

記録できます。これが Coexistence 番号ならではの点です。チームの誰かが WhatsApp Business アプリから返信すると、Meta はその送信メッセージのエコーを同じ Webhook の送信先に送ります。受信メッセージとエコーの両方を処理するワークフローなら、会話の両側がタイムラインに書き込まれます。HubSpot でコンタクトを開いた営業担当者は、お客様の質問と自社の返信を一緒に確認できます。

Webhook のフィールドで処理を分岐させてください。受信メッセージは messages、スマートフォンからの返信は smb_message_echoes で届きます。前者を受信、後者を送信として記録すれば、タイムラインは時系列どおりに並びます。

ワークフロー自身が Cloud API で送る返信は、送信の時点で内容が分かっています。Webhook を待たず、送信時に記録してください。

HubSpot 独自の WhatsApp 受信トレイチャネルとは何が違いますか？

別の連携です。HubSpot の会話受信トレイは WhatsApp の番号を HubSpot 自体に接続するもので、ナレッジベースには、その番号を他の WhatsApp 連携に接続してはならないと記載されています。利用できるのは Marketing Hub または Service Hub の Professional と Enterprise です。

EasyCoexistence で接続した番号は逆の流れになります。Meta が Webhook をお客様自身の URL に送り、HubSpot は API 経由でレコードを受け取ります。会話への返信はスマートフォンまたはワークフローから行い、HubSpot はコンタクト、取引、チケットに紐づく履歴を保持する記録システムになります。

この呼び出しには、実行する非公開アプリまたは認証情報にコンタクトの書き込みスコープが必要です。ワークフローがコンタクトを作成するために、もともと必要なスコープと同じです。

ワークフローは送信者とコンタクトをどう照合すべきですか？

電話番号で照合します。ただし検索の前に正規化してください。Meta は送信者を、国番号付きで + を含まない数字だけの形式（例: 14155550188）で送ってきます。一方、HubSpot のコンタクトは手入力のため、同じ人が +1 415 555 0188 や (415) 555-0188 の形で保存されていることがあります。

確実な方法は、数字だけの番号を保持する専用のコンタクトプロパティを用意することです。ワークフローがコンタクトを作成するときにその値を設定し、検索もそのプロパティで行います。標準の電話番号フィールドを直接検索すると、ワークフローが作成したコンタクトは見つかりますが、人が作成したコンタクトの多くは見つからず、重複の原因になります。

検索で何も見つからなかった場合は、Webhook のペイロードにあるプロフィール名を名として、数字だけの番号を両方のフィールドに入れてコンタクトを作成します。統合や名前の変更は後から担当者が行えますし、会話はすでに紐づいています。

よくある間違い

受信メッセージだけを記録してしまうこと。スマートフォンで入力した返信は smb_message_echoes イベントとして届くため、記録しないとタイムラインには質問だけが残り、回答がありません。
hs_communication_logged_from を未設定のままにすること。API で communication を作成するとき、HubSpot はこの値を CRM にするよう求めます。
生の電話番号フィールドでコンタクトを検索すること。Meta の数字だけの形式は、人が入力した値とほとんど一致せず、一致しないたびに重複コンタクトが作られます。

EasyCoexistence で実現する

easycoexistence.com で番号を接続し、Webhook の送信先を n8n のワークフローに向けるだけで、HubSpot に会話が蓄積され始めます。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を追加するにつれて US$ 1 まで下がります。最初の 3 日間は無料トライアルです。

よくある質問

HubSpot の中からお客様に返信できますか？

Communications オブジェクトは記録用のため、そこからは返信できません。返信は WhatsApp Business アプリか、Cloud API を呼び出すワークフローから送ります。どちらの返信もコンタクトに記録されます。

ワークフローにはどの HubSpot の権限が必要ですか？

コンタクトの読み取りと書き込みです。HubSpot は Communications API のスコープとして crm.objects.contacts.read または crm.objects.contacts.write を挙げています。コンタクトの作成にはもともと書き込みスコープが必要です。

同じワークフローから最初のメッセージも送れますか？

送れます。n8n に別の分岐を作り、承認済みのメッセージテンプレートを、番号の `phone_number_id` とアクセストークンを使って Cloud API 経由で送信します。その後、送信済みの communication としてコンタクトに記録します。

EasyCoexistence はメッセージの内容を途中で保存しますか？

保存しません。Meta は Webhook をお客様の n8n の URL へ直接届けます。EasyCoexistence が会話の内容を保存することはありません。

続きを読む

Connect WhatsApp to n8n on the official Cloud APIRoute WhatsApp messages into an n8n workflow over Meta's official Cloud API, on a number the business still answers from the phone. No linked device.Send WhatsApp conversations to Salesforce from a Coexistence numberLog WhatsApp messages from a Coexistence number as Salesforce tasks or notes on the lead or contact, through an n8n workflow on Meta's official Cloud API.Connect WhatsApp to Pipedrive on a Coexistence numberMatch every WhatsApp sender to a Pipedrive person, create a lead for new ones and log each message as a note, through n8n on Meta's official Cloud API.Connect WhatsApp to Zoho CRM on a Coexistence numberFind or create the Zoho CRM lead for every WhatsApp sender and log each message as a note, through n8n on Meta's official Cloud API. The phone keeps working.Connect WhatsApp to GoHighLevel contacts on a Coexistence numberCreate or update the HighLevel contact for every WhatsApp sender and log each message as a note, through n8n and a Private Integration token, per sub-account.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.

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

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

無料トライアルを始める

確認日 2026-10-11