Перейти к содержимому
WbizTool

Интеграции

HubSpot и WhatsApp

Свяжите HubSpot с вашим номером WhatsApp в обоих направлениях:

  • HubSpot → WhatsApp: когда создаётся контакт или сделка переходит на этап, отправьте этому человеку сообщение WhatsApp со своего номера.
  • WhatsApp → HubSpot: когда кто-то пишет на ваш номер WhatsApp, добавьте сообщение заметкой в его контакт HubSpot и создайте контакт, если его ещё нет.

У WbizTool нет приложения для HubSpot. Эти рецепты связывают их через Zapier, Make, n8n, Pabbly Connect или рабочий процесс (workflow) HubSpot, с готовыми шаблонами для Make и n8n.

Кто может это делать: в WbizTool владелец создаёт API-ключ на странице Настройки → API-ключи (см. API-ключи); владельцы и редакторы настраивают Номера для входящих для направления WhatsApp → HubSpot. В HubSpot нужны права на подключение приложений или редактирование рабочих процессов; для каждого способа ниже указано, что ему нужно.

Перед началом работы#

  • Подключённый номер WhatsApp на странице Номера WhatsApp. См. Подключение номера WhatsApp.
  • Ваш API-ключ, а для некоторых инструментов и Client ID, со страницы Настройки → API-ключи, а также WhatsApp Client ID номера, с которого идёт отправка (его ID на странице Номера WhatsApp).
  • Только для WhatsApp → HubSpot: дополнение Unibox. Входящие сообщения попадают в HubSpot через вебхук номеров для входящих, а ему нужно дополнение Unibox: $20 в месяц или $200 в год по базовым ценам в США за каждый номер для входящих, к платному или пожизненному тарифу (не в пробном периоде). Для отправки сообщений оно не нужно.

Выбор способа#

СпособHubSpot → WhatsAppWhatsApp → HubSpotЧто нужно
ZapierТриггер New Contact или Updated Deal Stage, затем действие отправки WbizToolТриггер WbizTool Incoming WhatsApp Message, затем HubSpot Find Contact и Create EngagementАккаунт Zapier. Вебхук настраивать не нужно.
MakeHubSpot CRM Watch Contacts, затем модуль HTTPCustom webhook в Make, затем HTTP-запросы к API HubSpotАккаунт Make. Приложения WbizTool в Make нет: модуль HTTP вызывает API WbizTool.
n8nHubSpot Trigger, затем WbizTool Send MessageУзел Webhook, затем узел HubSpot и HTTP-запросы к HubSpotn8n с community-узлом WbizTool. HubSpot Trigger требует аккаунт разработчика HubSpot и приложение.
Pabbly ConnectТриггер HubSpot, затем API (Pabbly)Webhook by Pabbly, затем API-запросы к HubSpotАккаунт Pabbly Connect. Работает через шаги HTTP и вебхуков Pabbly.
Рабочий процесс HubSpotДействие Send a webhook вызывает API WbizTool напрямуюИспользуйте другой способData Hub Professional или Enterprise. Другие инструменты не нужны.

Номера телефонов#

Два направления записывают номера по-разному, поэтому проверьте это, прежде чем сопоставлять поля.

HubSpot → WhatsApp. Сопоставьте Phone number (или Mobile phone number) контакта с phone получателя. WbizTool сам убирает пробелы, дефисы, точки и скобки, поэтому +1 (212) 555-0120 подходит. Номер, сохранённый с + или 00, содержит код страны. Номеру, сохранённому без него, например 2125550120, нужен код страны: заполните Country Code в Zapier и n8n или country_code в HTTP-запросе, например 1 или 91. Номер, сохранённый с кодом страны, но без +, например 12125550120, работает как есть. См. phone и country_code в разделе Отправка сообщения.

WhatsApp → HubSpot. Вебхук передаёт отправителя международными цифрами без + в contact.phone, например 12125550120. HubSpot ищет номера телефонов только по коду города и местному номеру, без кода страны. Поэтому перед поиском уберите код своей страны в начале: 12125550120 превращается в 2125550120. Шаблоны делают это для одного кода страны, который вы задаёте. При создании контакта сохраняйте номер как + и цифры, например +12125550120, чтобы HubSpot знал страну.

Отправка сообщения WhatsApp из HubSpot#

Через Zapier#

Используйте нужный триггер HubSpot, затем действие WbizTool. Подключите WbizTool с вашими Client ID и API-ключом (см. Интеграция с Zapier).

Когда создаётся контакт:

  1. Триггер: HubSpot, New Contact

    Выберите HubSpot и триггер New Contact и подключите свой аккаунт HubSpot.

  2. Filter by Zapier

    Продолжайте, только если номер телефона контакта exists. Контакты без номера не пройдут следующий шаг.

  3. Действие: WbizTool, Send Text-Only WhatsApp Message

    Выберите номер для отправки в WhatsApp Number. Сопоставьте Phone Number с номером телефона контакта. Заполняйте Country Code, только если номера в HubSpot сохранены без него. Напишите Message, например Hi {first name}, thanks for getting in touch. You can reach us here on WhatsApp.

  4. Проверьте и опубликуйте

    Успешный шаг означает, что сообщение поставлено в очередь. Затем WbizTool отправляет его с вашего номера.

Когда сделка переходит на этап:

  1. Триггер: HubSpot, Updated Deal Stage

    Выберите Updated Deal Stage, а также воронку и этап, например Closed won.

  2. Найдите контакт сделки

    В сделке нет номера телефона — он есть у её контакта. Добавьте HubSpot Get Contact с ID контакта, связанного со сделкой. Если в данных триггера нет ID контакта, сначала добавьте HubSpot Find Associations, чтобы получить контакты сделки.

  3. Отфильтруйте, затем отправьте

    Добавьте шаг Filter by Zapier, который продолжает, если номер телефона существует, затем Send Text-Only WhatsApp Message, как выше. В тексте можно использовать поля сделки, например её название.

Через Make#

Приложения WbizTool в Make нет. Модуль Make HTTP вызывает API отправки сообщения. Из двух шаблонов Make этот использует подключение HubSpot в Make (Watch Contacts); шаблон для WhatsApp → HubSpot использует только встроенные модули Make и сервисный ключ HubSpot.

  1. Импортируйте шаблон или начните сценарий

    Импортируйте hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint в новом сценарии) или соберите его по шагам ниже.

  2. HubSpot CRM, Watch Contacts

    Добавьте модуль HubSpot CRM Watch Contacts и подключите HubSpot. Сначала Super Admin вашего аккаунта HubSpot должен одобрить приложение Make. Make спросит, с чего начать: выберите From now on, чтобы писать только новым контактам.

  3. HTTP, Make a request

    Method POST, URL https://wbiztool.com/api/v1/send_msg/. Добавьте заголовок Authorization со значением Bearer YOUR_API_KEY. Body type application/x-www-form-urlencoded с такими полями:

    ПолеЗначение
    whatsapp_clientВаш WhatsApp Client ID, например 678
    phonePhone number контакта из модуля HubSpot
    country_codeТолько если номера сохранены без него, например 1
    msgВаш текст с подставленными полями, например именем
  4. Добавьте фильтр и запустите один раз

    На связи между двумя модулями добавьте фильтр, который пропускает, только если номер телефона существует. Запустите сценарий один раз: ответ с "status": 1 означает, что сообщение поставлено в очередь.

Поля формы продолжают работать, даже если в подставленном значении есть кавычки или переносы строк, которые могут сломать сырое тело JSON. JSON тоже работает; см. Поля тела запроса. Для этапа сделки в Make используйте рабочий процесс HubSpot, который отправляет данные в custom webhook Make, или способ через Zapier либо n8n.

Через n8n#

Шаблон hubspot-to-whatsapp.n8n.json обрабатывает оба события в одном сценарии: новый контакт и сделку, перешедшую на этап.

  1. Установите узел WbizTool

    Установите n8n-nodes-wbiztool и создайте учётные данные WbizTool API. См. Интеграция с n8n.

  2. Создайте учётные данные HubSpot

    HubSpot Trigger требует учётные данные HubSpot Developer API: аккаунт разработчика HubSpot, приложение со scope на чтение контактов и сделок и redirect URL n8n в этом приложении (см. страницу n8n об учётных данных HubSpot). Остальные шаги HubSpot используют учётные данные HubSpot Service Key: в HubSpot откройте Development → Keys → Service keys, нажмите Create service key и добавьте scope на чтение контактов и сделок.

  3. Импортируйте сценарий

    В n8n импортируйте файл и выберите свои учётные данные в каждом узле HubSpot, HTTP Request и WbizTool.

  4. Задайте этап и сообщение

    В узле Deal stage is замените closedwon на внутреннее значение вашего этапа. Отредактируйте текст в двух узлах WbizTool Send Message и задайте там Country Code, только если номера сохранены без него.

  5. Активируйте

    После этого триггер регистрирует свой вебхук в HubSpot.

Что делает сценарий:

  1. HubSpot Trigger с двумя событиями: Contact Created и Deal Property Changed для свойства Deal Stage.
  2. Узел IF направляет события контактов в одну сторону, а события сделок — в другую.
  3. Для сделки он проверяет новый этап, затем читает сделку и связанные с ней контакты через HTTP Request к HubSpot.
  4. HubSpot → Search Contacts читает имя и номера телефонов контакта.
  5. WbizTool Send Message отправляет текст на номер телефона или на мобильный номер, если телефон пустой.

Через рабочий процесс HubSpot#

На Data Hub Professional или Enterprise рабочий процесс может сам вызывать API WbizTool действием Send a webhook. Другие инструменты не участвуют.

  1. Создайте рабочий процесс на основе контактов

    В HubSpot откройте Automation → Workflows и создайте рабочий процесс для контактов с нужным триггером, например создание контакта или смена его этапа жизненного цикла.

  2. Добавьте Send a webhook

    Нажмите + и в разделе Data ops выберите Send a webhook. Method POST, URL вебхука https://wbiztool.com/api/v1/send_msg/.

  3. Настройте аутентификацию

    Выберите тип аутентификации API key. Добавьте секрет со значением Bearer YOUR_API_KEY (с вашим ключом WbizTool), укажите имя API-ключа Authorization и расположение Request header.

  4. Настройте тело запроса

    Выберите Customize request body и добавьте:

    КлючЗначение
    phoneСвойство: Phone number
    whatsapp_clientСтатическое значение: ваш WhatsApp Client ID, например 678
    msgСтатическое значение: ваше сообщение
    country_codeСтатическое значение, только если номера сохранены без него
  5. Проверьте

    Протестируйте действие на контакте с вашим собственным номером. WbizTool отвечает {"status": 1, "message": "Created", "msg_id": …}, когда поставил сообщение в очередь.

  • В сообщение нельзя подставить имя контакта. В Customize request body каждый ключ принимает либо одно свойство HubSpot, либо одно статическое значение, поэтому msg — фиксированный текст, одинаковый для всех контактов. Для персонального приветствия используйте Zapier, Make или n8n.
  • Повторы: HubSpot повторяет неудачный вебхук до трёх дней. Ответы 4xx, кроме 429, он не повторяет, поэтому отклонённое сообщение, например с Invalid phone number, повторно не отправляется. Чтобы повтор после тайм-аута не отправил сообщение дважды, добавьте ключ idempotency_key со свойством Record ID, если рабочий процесс пишет каждому контакту не чаще раза в день. См. Безопасный повтор запроса.
  • Сделки: эти шаги используют рабочий процесс на основе контактов, потому что номер телефона хранится в контакте, а не в сделке. Для сообщений по этапу сделки используйте Zapier или n8n.

Через Pabbly Connect#

Pabbly Connect запускает сценарий по событиям HubSpot, например New Contact Added или Deal Updated. Затем добавьте API (Pabbly) → Execute API Request с POST на https://wbiztool.com/api/v1/send_msg/, как в разделе Отправка сообщений WhatsApp из любого инструмента автоматизации, и сопоставьте номер телефона контакта с phone.

Запись входящих сообщений WhatsApp в HubSpot#

Каждое сообщение, которое кто-то отправляет на ваш номер, становится заметкой в его контакте HubSpot. Для этого направления нужно дополнение Unibox ($20 в месяц или $200 в год по базовым ценам в США за каждый номер для входящих, к платному или пожизненному тарифу), потому что сообщения покидают WbizTool через вебхук номеров для входящих.

Рецепт одинаков в любом инструменте:

  1. Пропустите групповые чаты (contact.is_group равно true) и контакты, чей номер WhatsApp скрывает (contact.phone_hidden равно true).
  2. Уберите код своей страны в начале contact.phone (см. Номера телефонов).
  3. Найдите контакты HubSpot, у которых Phone number или Mobile phone number равен этому номеру.
  4. Если таких нет, создайте контакт с Phone number + и contact.phone и First name contact.name.
  5. Создайте в контакте заметку с сообщением: message.content, на время message.timestamp.

Через Zapier#

URL вебхука нигде указывать не нужно: триггер WbizTool подключается к Zapier, когда вы публикуете Zap.

  1. Триггер: WbizTool, Incoming WhatsApp Message

    Выберите номер в WhatsApp Number. Zap занимает один из ваших номеров для входящих (см. Требования триггера). Его запускают только сообщения, которые вам присылают.

  2. Filter by Zapier

    Продолжайте, только если Contact Phone Hidden равно false и Is Group равно false.

  3. Formatter by Zapier: уберите код страны

    Выберите Formatter, action event Numbers, transform Format Phone Number. Input: + и Contact Phone. В To Format выберите национальный формат без символов, чтобы +12125550120 превратился в 2125550120.

  4. HubSpot, Find Contact

    Ищите по Phone Number с результатом Formatter. Отметьте вариант создавать контакт, если он не найден, с Phone Number + и Contact Phone и First Name из Contact Name.

  5. HubSpot, Create Engagement

    Тип Note, связанный с ID контакта из шага Find Contact. Body: WhatsApp from Contact Name: Message Content.

Через Make#

  1. Импортируйте шаблон

    Импортируйте hubspot-whatsapp-to-note.make.json в новый сценарий.

  2. Добавьте сервисный ключ HubSpot

    В HubSpot откройте Development → Keys → Service keys, нажмите Create service key и добавьте scope на чтение и запись контактов. В каждом модуле HTTP сценария замените YOUR_HUBSPOT_SERVICE_KEY в заголовке Authorization этим ключом.

  3. Создайте вебхук

    В модуле Webhooks → Custom webhook нажмите Add, дайте ему имя и скопируйте адрес.

  4. Добавьте адрес к номеру для входящих

    В WbizTool откройте Номера для входящих, нажмите Настройки вебхука на карточке номера (или Добавить номер во входящие), вставьте адрес в поле URL вебхука (необязательно) и нажмите Сохранить. Оставьте отмеченными Полученные сообщения; отметьте также Отправленные сообщения, если хотите видеть свои ответы в HubSpot.

  5. Задайте код страны

    В модуле Search the contact by phone шаблон убирает 1 в начале номера (/^1/, дважды). Замените 1 на код своей страны, например 91.

  6. Включите сценарий

    Отправьте сообщение на свой номер WhatsApp с другого телефона. Оно придёт в течение минуты-двух, и Make узнает из него поля вебхука: один раз проверьте сопоставления.

Сценарий: Custom webhook → HTTP-запрос к поиску контактов HubSpot → маршрутизатор (router). Если контакт найден, HTTP-запрос добавляет ему заметку. Если нет, один запрос создаёт контакт, а другой добавляет заметку. Шаги JSON → Transform to JSON превращают сообщение и имя в текст JSON, чтобы кавычки и переносы строк не ломали запросы.

Через n8n#

  1. Импортируйте сценарий

    Импортируйте hubspot-whatsapp-to-note.n8n.json и выберите учётные данные HubSpot Service Key в узлах HubSpot и HTTP Request. Ключу нужны scope на чтение и запись контактов.

  2. Задайте код страны

    В узле National number укажите в countryCode код своей страны, например 91.

  3. Активируйте и скопируйте адрес

    Активируйте сценарий и скопируйте Production URL узла WbizTool webhook.

  4. Добавьте адрес к номеру для входящих

    Вставьте его как вебхук номера на странице Номера для входящих, как в шагах для Make выше.

У узла HubSpot в n8n нет действия для заметок, поэтому сценарий создаёт контакт и заметку узлами HTTP Request с теми же учётными данными HubSpot. Узел Webhook отвечает сразу, с большим запасом укладываясь в 8 секунд, которые ждёт WbizTool.

Через Pabbly Connect#

Начните с Webhook by Pabbly и вставьте его URL как вебхук номера на странице Номера для входящих. Затем вызывайте API HubSpot через API (Pabbly) → Execute API Request с сервисным ключом HubSpot в качестве токена Bearer: POST https://api.hubapi.com/crm/objects/2026-09/contacts/search, чтобы найти контакт, POST …/contacts, чтобы создать его, и POST …/notes, чтобы добавить заметку (см. Запросы вашего сервера).

На своём сервере#

Принимайте вебхук, как описано в разделе Вебхуки входящих сообщений, проверяйте его подпись, сразу отвечайте 200, а затем делайте эти вызовы API HubSpot с сервисным ключом.

Запросы вашего сервера

ШагЗапросТело
Найти контактPOST https://api.hubapi.com/crm/objects/2026-09/contacts/searchfilterGroups с phone EQ номер без кода страны и вторая группа с mobilephone; limit 1
Создать, если его нетPOST https://api.hubapi.com/crm/objects/2026-09/contactsproperties: phone +12125550120, firstname из contact.name
Добавить заметкуPOST https://api.hubapi.com/crm/objects/2026-09/notesproperties: hs_timestamp из message.timestamp, hs_note_body с текстом; associations к контакту с associationCategory HUBSPOT_DEFINED и associationTypeId 202 (заметка к контакту)
{
  "properties": {
    "hs_timestamp": "2026-10-15T10:30:04+00:00",
    "hs_note_body": "WhatsApp from Emma Thompson (+12125550120): Can I add a gift note to it?"
  },
  "associations": [
    {
      "to": { "id": "CONTACT_ID" },
      "types": [{ "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 202 }]
    }
  ]
}

Эндпоинты поиска HubSpot допускают пять запросов в секунду на аккаунт. Пропускайте message.id, который уже записали: в редких случаях WbizTool может отправить сообщение дважды.

Шаблоны#

ФайлИнструментЧто делает
hubspot-new-contact-to-whatsapp.make.jsonMakeНовый контакт HubSpot → сообщение WhatsApp
hubspot-whatsapp-to-note.make.jsonMakeВходящее сообщение WhatsApp → заметка в контакте (нужно дополнение Unibox)
hubspot-to-whatsapp.n8n.jsonn8nНовый контакт или этап сделки → сообщение WhatsApp
hubspot-whatsapp-to-note.n8n.jsonn8nВходящее сообщение WhatsApp → заметка в контакте (нужно дополнение Unibox)

Шаблоны не содержат ключей. После импорта выберите свои подключения или учётные данные в каждом шаге и замените YOUR_API_KEY, YOUR_HUBSPOT_SERVICE_KEY, WhatsApp Client ID 678 и код страны своими.

Устранение неполадок#

ПроблемаЧто проверить
Invalid phone numberТелефон контакта пустой, содержит буквы или в нём меньше 6 или больше 17 цифр. Добавьте фильтр, который пропускает контакты без номера.
Сообщение уходит не на тот номерНомер сохранён без кода страны, и код не был отправлен. Заполните Country Code или country_code либо сохраняйте номера в HubSpot с +.
Auth Error: invalid api keyКлюч удалён или введён с ошибкой. В рабочем процессе HubSpot значение секрета должно быть Bearer и ключ, а имя API-ключа — Authorization.
Invalid whatsapp clientИспользуйте ID номера со страницы Номера WhatsApp.
В действиях рабочего процесса нет Send a webhookНужен Data Hub Professional или Enterprise. Используйте вместо этого Zapier, Make, n8n или Pabbly Connect.
Make не может подключиться к HubSpotСначала Super Admin аккаунта HubSpot должен одобрить приложение Make.
В HubSpot не появляются заметкиПроверьте, что у номера на странице Номера для входящих статус Синхронизируется, что URL вебхука взят из вашего инструмента и отмечены Полученные сообщения. Отправьте сообщение с другого телефона: ответы из входящих Unibox не отправляются.
Вебхуки не приходят, или хостинг их отклоняетПолучатель должен отвечать 2xx в течение 8 секунд и не делать редирект. Некоторые брандмауэры хостинга блокируют неизвестных клиентов: вебхуки WbizTool приходят с User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com), поэтому разрешите его.
Для человека, который уже есть в HubSpot, создаётся новый контактHubSpot не нашёл номер. Проверьте, что убираемый код страны правильный и номер контакта указан в Phone number или Mobile phone number. Для клиентов из многих стран см. Номера телефонов.
Сообщение записано дваждыВ редких случаях WbizTool может отправить сообщение дважды. Пропускайте message.id, который уже записали.
Для некоторых сообщений нет заметкиГрупповые чаты и контакты, чей номер WhatsApp скрывает, пропускаются намеренно. Сообщения за время, когда номер был остановлен, не отправляются.

Связанные материалы#