Запись сообщений WhatsApp в HubSpot с номера Coexistence

Как сообщение WhatsApp попадает в контакт HubSpot?

За три шага. Meta доставляет сообщение на адрес вебхука, который вы задали для номера, в данном случае это узел Webhook в n8n. Рабочий процесс ищет в HubSpot контакт с номером телефона отправителя и создаёт его, если совпадений нет. Затем он создаёт запись communication с текстом сообщения и связывает её с этим контактом.

HubSpot создал объект Communications именно для такого случая. Он описывает сообщение в WhatsApp, LinkedIn или SMS, которое было отправлено или получено вне HubSpot, и отображается в хронологии записи так же, как залогированный звонок или письмо. Обязательные свойства: тип канала, hs_communication_logged_from со значением CRM, текст, владелец и время.

Приложение из маркетплейса HubSpot для этого не нужно. Узел HTTP Request в n8n может использовать те же учётные данные HubSpot, которые вы уже настроили для узла HubSpot, а вызов сводится к одному POST на каждое сообщение.

{
  "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 отправляет эхо этого исходящего сообщения на тот же адрес вебхука. Рабочий процесс, который обрабатывает и входящие сообщения, и эхо, записывает в хронологию обе стороны переписки. Менеджер, открыв контакт в HubSpot, видит, о чём спросил клиент и что ему ответил магазин.

Разделяйте ветки по полю вебхука. Входящие сообщения приходят в messages, а ответы с телефона приходят в smb_message_echoes. Записывайте первые как полученные, вторые как отправленные, и хронология будет идти по порядку.

Ответы, которые рабочий процесс сам отправляет через Cloud API, ему уже известны, поэтому записывайте их в момент отправки, не дожидаясь вебхука.

А как же собственный канал WhatsApp во входящих HubSpot?

Это другая интеграция. Раздел разговоров HubSpot подключает номер WhatsApp к самому HubSpot, и, согласно его базе знаний, номер не должен быть подключён к другой интеграции WhatsApp. Канал доступен в Marketing Hub или Service Hub уровней Professional и Enterprise.

Номер, подключённый через EasyCoexistence, работает иначе: Meta направляет его вебхуки на адрес, которым владеете вы, а HubSpot получает записи через свой API. Отвечают на сообщения с телефона или рабочий процесс, а HubSpot служит системой учёта, где история хранится рядом с контактом, сделкой или тикетом.

Для вызова нужны права на запись контактов в приватном приложении или учётных данных, от имени которых он выполняется. Это те же права, которые рабочему процессу и так нужны для создания контакта.

Как рабочему процессу сопоставить отправителя с контактом?

По номеру телефона, приведённому к единому виду перед поиском. Meta передаёт отправителя цифрами с кодом страны и без плюса, например 14155550188. Контакты в HubSpot вводят вручную, поэтому один и тот же человек может храниться как +1 415 555 0188 или (415) 555-0188.

Надёжный подход: завести отдельное свойство контакта с номером только из цифр, заполнять его при создании контакта рабочим процессом и искать по этому свойству. Поиск напрямую по текстовому полю телефона работает для контактов, созданных рабочим процессом, и пропускает многие контакты, созданные людьми, из-за чего появляются дубликаты.

Если поиск ничего не вернул, создайте контакт, указав имя профиля из данных вебхука как имя, а номер только из цифр в оба поля. Позже контакт можно объединить или переименовать, а переписка уже будет привязана.

Распространённые ошибки

• Запись только входящих сообщений. Тогда в хронологии видны вопросы без ответов, потому что ответы с телефона приходят как события smb_message_echoes.
• Пропуск hs_communication_logged_from. При создании записи communication через API HubSpot требует значение CRM.
• Поиск контактов по необработанному полю телефона. Формат Meta из одних цифр редко совпадает с тем, что ввёл человек, и каждый промах создаёт дубликат контакта.

Часто задаваемые вопросы

Читайте дальше