Интеграции
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 → WhatsApp | WhatsApp → HubSpot | Что нужно |
|---|---|---|---|
| Zapier | Триггер New Contact или Updated Deal Stage, затем действие отправки WbizTool | Триггер WbizTool Incoming WhatsApp Message, затем HubSpot Find Contact и Create Engagement | Аккаунт Zapier. Вебхук настраивать не нужно. |
| Make | HubSpot CRM Watch Contacts, затем модуль HTTP | Custom webhook в Make, затем HTTP-запросы к API HubSpot | Аккаунт Make. Приложения WbizTool в Make нет: модуль HTTP вызывает API WbizTool. |
| n8n | HubSpot Trigger, затем WbizTool Send Message | Узел Webhook, затем узел HubSpot и HTTP-запросы к HubSpot | n8n с 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).
Когда создаётся контакт:
Триггер: HubSpot, New Contact
Выберите HubSpot и триггер New Contact и подключите свой аккаунт HubSpot.
Filter by Zapier
Продолжайте, только если номер телефона контакта exists. Контакты без номера не пройдут следующий шаг.
Действие: 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.Проверьте и опубликуйте
Успешный шаг означает, что сообщение поставлено в очередь. Затем WbizTool отправляет его с вашего номера.
Когда сделка переходит на этап:
Триггер: HubSpot, Updated Deal Stage
Выберите Updated Deal Stage, а также воронку и этап, например Closed won.
Найдите контакт сделки
В сделке нет номера телефона — он есть у её контакта. Добавьте HubSpot Get Contact с ID контакта, связанного со сделкой. Если в данных триггера нет ID контакта, сначала добавьте HubSpot Find Associations, чтобы получить контакты сделки.
Отфильтруйте, затем отправьте
Добавьте шаг Filter by Zapier, который продолжает, если номер телефона существует, затем Send Text-Only WhatsApp Message, как выше. В тексте можно использовать поля сделки, например её название.
Через Make#
Приложения WbizTool в Make нет. Модуль Make HTTP вызывает API отправки сообщения. Из двух шаблонов Make этот использует подключение HubSpot в Make (Watch Contacts); шаблон для WhatsApp → HubSpot использует только встроенные модули Make и сервисный ключ HubSpot.
Импортируйте шаблон или начните сценарий
Импортируйте hubspot-new-contact-to-whatsapp.make.json (⋯ → Import Blueprint в новом сценарии) или соберите его по шагам ниже.
HubSpot CRM, Watch Contacts
Добавьте модуль HubSpot CRM Watch Contacts и подключите HubSpot. Сначала Super Admin вашего аккаунта HubSpot должен одобрить приложение Make. Make спросит, с чего начать: выберите From now on, чтобы писать только новым контактам.
HTTP, Make a request
Method
POST, URLhttps://wbiztool.com/api/v1/send_msg/. Добавьте заголовокAuthorizationсо значениемBearer YOUR_API_KEY. Body type application/x-www-form-urlencoded с такими полями:Поле Значение whatsapp_clientВаш WhatsApp Client ID, например 678phonePhone number контакта из модуля HubSpot country_codeТолько если номера сохранены без него, например 1msgВаш текст с подставленными полями, например именем Добавьте фильтр и запустите один раз
На связи между двумя модулями добавьте фильтр, который пропускает, только если номер телефона существует. Запустите сценарий один раз: ответ с
"status": 1означает, что сообщение поставлено в очередь.
Поля формы продолжают работать, даже если в подставленном значении есть кавычки или переносы строк, которые могут сломать сырое тело JSON. JSON тоже работает; см. Поля тела запроса. Для этапа сделки в Make используйте рабочий процесс HubSpot, который отправляет данные в custom webhook Make, или способ через Zapier либо n8n.
Через n8n#
Шаблон hubspot-to-whatsapp.n8n.json обрабатывает оба события в одном сценарии: новый контакт и сделку, перешедшую на этап.
Установите узел WbizTool
Установите
n8n-nodes-wbiztoolи создайте учётные данные WbizTool API. См. Интеграция с n8n.Создайте учётные данные 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 на чтение контактов и сделок.
Импортируйте сценарий
В n8n импортируйте файл и выберите свои учётные данные в каждом узле HubSpot, HTTP Request и WbizTool.
Задайте этап и сообщение
В узле Deal stage is замените
closedwonна внутреннее значение вашего этапа. Отредактируйте текст в двух узлах WbizTool Send Message и задайте там Country Code, только если номера сохранены без него.Активируйте
После этого триггер регистрирует свой вебхук в HubSpot.
Что делает сценарий:
- HubSpot Trigger с двумя событиями: Contact Created и Deal Property Changed для свойства Deal Stage.
- Узел IF направляет события контактов в одну сторону, а события сделок — в другую.
- Для сделки он проверяет новый этап, затем читает сделку и связанные с ней контакты через HTTP Request к HubSpot.
- HubSpot → Search Contacts читает имя и номера телефонов контакта.
- WbizTool Send Message отправляет текст на номер телефона или на мобильный номер, если телефон пустой.
Через рабочий процесс HubSpot#
На Data Hub Professional или Enterprise рабочий процесс может сам вызывать API WbizTool действием Send a webhook. Другие инструменты не участвуют.
Создайте рабочий процесс на основе контактов
В HubSpot откройте Automation → Workflows и создайте рабочий процесс для контактов с нужным триггером, например создание контакта или смена его этапа жизненного цикла.
Добавьте Send a webhook
Нажмите + и в разделе Data ops выберите Send a webhook. Method
POST, URL вебхукаhttps://wbiztool.com/api/v1/send_msg/.Настройте аутентификацию
Выберите тип аутентификации API key. Добавьте секрет со значением
Bearer YOUR_API_KEY(с вашим ключом WbizTool), укажите имя API-ключаAuthorizationи расположение Request header.Настройте тело запроса
Выберите Customize request body и добавьте:
Ключ Значение phoneСвойство: Phone number whatsapp_clientСтатическое значение: ваш WhatsApp Client ID, например 678msgСтатическое значение: ваше сообщение country_codeСтатическое значение, только если номера сохранены без него Проверьте
Протестируйте действие на контакте с вашим собственным номером. 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 через вебхук номеров для входящих.
Рецепт одинаков в любом инструменте:
- Пропустите групповые чаты (
contact.is_groupравноtrue) и контакты, чей номер WhatsApp скрывает (contact.phone_hiddenравноtrue). - Уберите код своей страны в начале
contact.phone(см. Номера телефонов). - Найдите контакты HubSpot, у которых Phone number или Mobile phone number равен этому номеру.
- Если таких нет, создайте контакт с Phone number
+иcontact.phoneи First namecontact.name. - Создайте в контакте заметку с сообщением:
message.content, на времяmessage.timestamp.
Через Zapier#
URL вебхука нигде указывать не нужно: триггер WbizTool подключается к Zapier, когда вы публикуете Zap.
Триггер: WbizTool, Incoming WhatsApp Message
Выберите номер в WhatsApp Number. Zap занимает один из ваших номеров для входящих (см. Требования триггера). Его запускают только сообщения, которые вам присылают.
Filter by Zapier
Продолжайте, только если Contact Phone Hidden равно false и Is Group равно false.
Formatter by Zapier: уберите код страны
Выберите Formatter, action event Numbers, transform Format Phone Number. Input:
+и Contact Phone. В To Format выберите национальный формат без символов, чтобы+12125550120превратился в2125550120.HubSpot, Find Contact
Ищите по Phone Number с результатом Formatter. Отметьте вариант создавать контакт, если он не найден, с Phone Number
+и Contact Phone и First Name из Contact Name.HubSpot, Create Engagement
Тип Note, связанный с ID контакта из шага Find Contact. Body:
WhatsApp fromContact Name: Message Content.
Через Make#
Импортируйте шаблон
Импортируйте hubspot-whatsapp-to-note.make.json в новый сценарий.
Добавьте сервисный ключ HubSpot
В HubSpot откройте Development → Keys → Service keys, нажмите Create service key и добавьте scope на чтение и запись контактов. В каждом модуле HTTP сценария замените
YOUR_HUBSPOT_SERVICE_KEYв заголовкеAuthorizationэтим ключом.Создайте вебхук
В модуле Webhooks → Custom webhook нажмите Add, дайте ему имя и скопируйте адрес.
Добавьте адрес к номеру для входящих
В WbizTool откройте Номера для входящих, нажмите Настройки вебхука на карточке номера (или Добавить номер во входящие), вставьте адрес в поле URL вебхука (необязательно) и нажмите Сохранить. Оставьте отмеченными Полученные сообщения; отметьте также Отправленные сообщения, если хотите видеть свои ответы в HubSpot.
Задайте код страны
В модуле Search the contact by phone шаблон убирает
1в начале номера (/^1/, дважды). Замените1на код своей страны, например91.Включите сценарий
Отправьте сообщение на свой номер WhatsApp с другого телефона. Оно придёт в течение минуты-двух, и Make узнает из него поля вебхука: один раз проверьте сопоставления.
Сценарий: Custom webhook → HTTP-запрос к поиску контактов HubSpot → маршрутизатор (router). Если контакт найден, HTTP-запрос добавляет ему заметку. Если нет, один запрос создаёт контакт, а другой добавляет заметку. Шаги JSON → Transform to JSON превращают сообщение и имя в текст JSON, чтобы кавычки и переносы строк не ломали запросы.
Через n8n#
Импортируйте сценарий
Импортируйте hubspot-whatsapp-to-note.n8n.json и выберите учётные данные HubSpot Service Key в узлах HubSpot и HTTP Request. Ключу нужны scope на чтение и запись контактов.
Задайте код страны
В узле National number укажите в
countryCodeкод своей страны, например91.Активируйте и скопируйте адрес
Активируйте сценарий и скопируйте Production URL узла WbizTool webhook.
Добавьте адрес к номеру для входящих
Вставьте его как вебхук номера на странице Номера для входящих, как в шагах для 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/search | filterGroups с phone EQ номер без кода страны и вторая группа с mobilephone; limit 1 |
| Создать, если его нет | POST https://api.hubapi.com/crm/objects/2026-09/contacts | properties: phone +12125550120, firstname из contact.name |
| Добавить заметку | POST https://api.hubapi.com/crm/objects/2026-09/notes | properties: 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.json | Make | Новый контакт HubSpot → сообщение WhatsApp |
| hubspot-whatsapp-to-note.make.json | Make | Входящее сообщение WhatsApp → заметка в контакте (нужно дополнение Unibox) |
| hubspot-to-whatsapp.n8n.json | n8n | Новый контакт или этап сделки → сообщение WhatsApp |
| hubspot-whatsapp-to-note.n8n.json | n8n | Входящее сообщение 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 скрывает, пропускаются намеренно. Сообщения за время, когда номер был остановлен, не отправляются. |

