Интеграции
GoHighLevel и WhatsApp
Подключите GoHighLevel (HighLevel) к WbizTool, и ваши рабочие процессы (workflows) будут отправлять сообщения WhatsApp с вашего собственного номера WhatsApp. Входящие сообщения WhatsApp тоже могут возвращаться в HighLevel — как заметка, тег или задача в контакте.
Всё на этой странице использует функции, которые уже есть с обеих сторон: вебхуки в рабочих процессах HighLevel, а также API отправки сообщений и вебхуки входящих сообщений WbizTool. Ничего устанавливать не нужно.
Кто может это делать: в WbizTool владелец создаёт API-ключ (API-ключи), а владелец или редактор настраивает вебхуки входящих сообщений. В HighLevel их собирает тот, кто может редактировать рабочие процессы в субаккаунте. Агентство должно включить премиум-функции рабочих процессов HighLevel (см. Перед началом работы).
Что можно сделать#
| Направление | Пример | Как |
|---|---|---|
| HighLevel → WhatsApp | Отправлена форма, добавлен тег или записан приём, и контакт получает сообщение WhatsApp. | Действие Custom Webhook в рабочем процессе HighLevel вызывает API отправки сообщений WbizTool. |
| WhatsApp → HighLevel | Клиент пишет на ваш номер WhatsApp, и сообщение добавляется заметкой в его контакт HighLevel. Если контакта ещё нет, он создаётся. | Номер для входящих WbizTool отправляет каждое сообщение в триггер HighLevel Inbound Webhook. Нужно дополнение Unibox. |
Перед началом работы#
- Подключённый номер WhatsApp на странице Номера WhatsApp и его WhatsApp Client ID (ID, показанный у номера), например
678. - API-ключ WbizTool со страницы Настройки → API-ключи. В HighLevel он передаётся в заголовке
Authorization: Bearer, поэтому Client ID не нужен. См. Передача ключа в заголовке. - Премиум-функции рабочих процессов HighLevel. HighLevel относит Custom Webhook и Inbound Webhook к премиум-функциям рабочих процессов. Агентства на любом тарифе HighLevel могут их включить: в Agency View откройте Settings → Company и включите Workflow - Premium Features. HighLevel берёт плату за каждый премиум-запуск, а каждый субаккаунт получает 100 бесплатных премиум-запусков (один раз, а не каждый месяц). Агентство может перевыставлять эти расходы субаккаунту (rebilling). Цены HighLevel указаны на его собственной странице помощи.
- Только для входящих сообщений: дополнение Unibox к платному или пожизненному тарифу WbizTool (не в пробном периоде). Оно стоит $20 в месяц или $200 в год по базовым ценам в США за каждый номер WhatsApp во входящих. Его подключает владелец на странице Оплата и тарифы (см. Дополнения).
Выбор способа#
Способ через рабочие процессы HighLevel самый короткий: HighLevel вызывает WbizTool напрямую, без других инструментов посередине. Инструмент автоматизации используйте, только если ваши процессы уже работают в нём.
| Способ | Отправка (HighLevel → WhatsApp) | Получение (WhatsApp → HighLevel) | Что нужно |
|---|---|---|---|
| Рабочие процессы HighLevel (рекомендуется) | Действие Custom Webhook → API отправки сообщений | Вебхук WbizTool → триггер Inbound Webhook | Премиум-функции рабочих процессов HighLevel. Получение: дополнение Unibox. |
| Zapier | LeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp Message | WbizTool Incoming WhatsApp Message → LeadConnector Add/Update Contact или Add Task | Аккаунт Zapier. Получение: дополнение Unibox. |
| Make | Действие HighLevel Webhook → Make Webhooks → модуль HTTP | Вебхук WbizTool → Make Webhooks → API HighLevel | Аккаунт Make. Получение: дополнение Unibox. |
| n8n | Действие HighLevel Webhook → n8n Webhook → WbizTool Send Message | Вебхук WbizTool → n8n Webhook → узел HighLevel | n8n с community-узлом WbizTool. Получение: дополнение Unibox. |
| Pabbly Connect | Действие HighLevel Webhook → вебхук-триггер Pabbly → запрос API (Pabbly) | Вебхук WbizTool → вебхук-триггер Pabbly → ваш шаг HighLevel | Аккаунт Pabbly Connect. Получение: дополнение Unibox. |
Отправка сообщений WhatsApp из рабочего процесса HighLevel#
Откройте или создайте рабочий процесс
В субаккаунте HighLevel откройте Automation и создайте рабочий процесс или отредактируйте существующий. Задайте ему нужный триггер, например отправку формы, новый тег или записанный приём.
Добавьте действие Custom Webhook
Нажмите + там, где должно уходить сообщение, затем Send Data → Custom Webhook (или найдите в действиях «webhook» и выберите Custom Webhook). Простое действие Webhook не умеет задавать заголовок и тело, которые нужны этому API.
Настройте запрос
Установите Event в CUSTOM и Method в POST. Укажите URL
https://wbiztool.com/api/v1/send_msg/. В Authorization выберите Bearer Token и вставьте API-ключ WbizTool — или выберите вариант без авторизации и добавьте заголовокAuthorizationсо значениемBearer YOUR_API_KEY. Установите Content-Type вapplication/json.Вставьте тело запроса
Вставьте один из готовых блоков в Raw Body и замените
678на ваш WhatsApp Client ID. Значок тега в HighLevel добавляет в сообщение другие поля контакта.Проверьте и опубликуйте
Сохраните действие и опубликуйте рабочий процесс. Запустите его для тестового контакта со своим номером телефона. Каждый запуск виден в журналах выполнения (execution logs) процесса. Когда WbizTool принимает сообщение, он отвечает
"status": 1. Затем сообщение уходит с вашего номера WhatsApp.
Поле номера телефона#
Используйте {{contact.phone_raw}}, а не {{contact.phone}}. В HighLevel {{contact.phone}} отформатирован для чтения, например (515) 555-2345, без кода страны. {{contact.phone_raw}} — тот же номер в международном формате, например +15155552345.
WbizTool сам убирает +, пробелы, дефисы и скобки. Номер, записанный с +, уже содержит код страны, поэтому country_code отправлять не нужно. Если часть контактов сохранена без кода страны, добавьте в тело "country_code": "1" (телефонный код вашей страны). Он добавляется только к номерам, записанным без +. См. Отправка сообщения → phone.
Готовые блоки#
URL: https://wbiztool.com/api/v1/send_msg/ · Method: POST · Headers: Authorization: Bearer YOUR_API_KEY и Content-Type: application/json
{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, thanks for contacting {{location.name}}. We'll reply here on WhatsApp."
}{
"whatsapp_client": 678,
"msg_type": 1,
"phone": "{{contact.phone_raw}}",
"img_url": "https://example.com/images/welcome-offer.jpg",
"msg": "Hi {{contact.first_name}}, here is your welcome offer from {{location.name}}."
}{
"whatsapp_client": 678,
"msg_type": 2,
"phone": "{{contact.phone_raw}}",
"file_url": "https://example.com/files/price-list.pdf",
"file_name": "price-list.pdf",
"msg": "Hi {{contact.first_name}}, here is our price list."
}{
"whatsapp_client": 678,
"phone": "{{contact.phone_raw}}",
"msg": "Hi {{contact.first_name}}, a reminder of your appointment with {{location.name}} at {{appointment.start_time}}.",
"expire_after_seconds": 3600
}{
"whatsapp_client": 678,
"group_name": "Sales team",
"msg": "New lead: {{contact.name}}, {{contact.phone_raw}}, {{contact.email}}"
}whatsapp_client: ID номера, с которого идёт отправка. Его можно не указывать, только если в вашем пространстве ровно один подключённый номер.msg: до 3 000 символов. Форматирование WhatsApp работает:*bold*,_italic_. Для новой строки напишите\nвнутри текста. Настоящий перенос строки делает JSON недействительным.- Изображения и файлы: ссылки должны быть публичными.
msgстановится подписью. См. Отправка изображений и файлов. expire_after_seconds: если сообщение не ушло за это время, например потому что номер был отключён, оно помечается как просроченное и не отправляется.- Группы:
group_name— точное название группы WhatsApp, в которой состоит ваш номер. Отправляйтеgroup_nameилиphone, но никогда оба сразу. См. Отправка в группу.
Запись входящих сообщений WhatsApp в HighLevel#
Для этого направления нужно дополнение Unibox. Каждое сообщение, которое получает ваш номер WhatsApp, отправляется в триггер HighLevel Inbound Webhook. Затем рабочий процесс находит или создаёт контакт и добавляет сообщение как заметку, тег или задачу. Больше нигде в HighLevel сообщения не появляются.
Создайте рабочий процесс с триггером Inbound Webhook
В HighLevel создайте рабочий процесс и выберите триггер Inbound Webhook. Скопируйте показанный URL вебхука.
Направьте на него свой номер WhatsApp
В WbizTool откройте Номера для входящих. Нажмите Добавить номер во входящие, выберите номер и вставьте URL из HighLevel в поле URL вебхука (необязательно). Для номера, который уже во входящих, вставьте его в Настройки вебхука этого номера. В блоке Какие сообщения отправлять отметьте только Полученные сообщения. Каждая отправка — это один премиум-запуск в HighLevel, поэтому не включайте Отправленные сообщения, если они вам не нужны.
Отправьте тестовое сообщение
С другого телефона отправьте сообщение на ваш номер WhatsApp. Оно будет отправлено после следующей проверки, обычно в течение минуты-двух. В HighLevel нажмите Test Trigger, выберите запрос в Mapping Reference и сохраните триггер. Поля перечислены в разделе Полезная нагрузка.
Пропускайте группы и скрытые номера
Добавьте шаг If/Else, который продолжает, только если
eventравноmessage_received,contact.is_groupравноfalseиcontact.phoneне пустой. WhatsApp иногда скрывает номер отправителя, а сообщения из групп содержат ID группы вместо номера телефона.Найдите или создайте контакт
В действии Create/Update Contact задайте для Phone значение
+, за которым следует contact → phone из значений Inbound Webhook. WbizTool отправляет номер без+, а+сообщает HighLevel, что номер содержит код страны. Можно также сопоставить contact → name. Это имя отправителя в WhatsApp, и оно может заменить имя, которое вы изменили в HighLevel.Добавьте сообщение в контакт
Добавьте действие Add to Notes. Напишите заметку, например «Сообщение WhatsApp:», и выберите message → content и message → timestamp из значений Inbound Webhook. Можно также добавить Add Contact Tag (например,
whatsapp), задачу или внутреннее уведомление для команды.Опубликуйте
Опубликуйте рабочий процесс и отправьте ещё одно тестовое сообщение.
| Значение Inbound Webhook | Для чего |
|---|---|
contact.phone | Телефон контакта. Добавьте + в начало. |
contact.name | Имя отправителя в WhatsApp. Может быть пустым. |
message.content | Текст. Для фото, голосовых сообщений и файлов это метка вроде 📸 Image, подписи не включаются. |
message.timestamp | Когда сообщение было отправлено в WhatsApp (ISO 8601, UTC). |
message.media.url | Ссылка для скачивания фото или файла. Она истекает через 3½–7 дней, поэтому не полагайтесь на неё в заметке. |
whatsapp_phone | Какой из ваших номеров его получил, если несколько номеров отправляют в один рабочий процесс. |
event | message_received или message_sent. |
- Отправляются только новые сообщения, с момента настройки вебхука. Старые чаты не импортируются.
- Один вебхук на номер. Каждый номер для входящих отправляет на один URL. Если Zap в Zapier использует триггер Incoming WhatsApp Message для того же номера, Zap забирает вебхук себе, пока он включён.
- Ответ из HighLevel: чтобы ответить в WhatsApp из того же рабочего процесса, добавьте действие Custom Webhook с
"phone": "{{contact.phone_raw}}". - Держите URL в секрете. Inbound Webhook в HighLevel не проверяет подпись WbizTool, поэтому отправить на него запрос может любой, у кого есть URL. Если он утёк, создайте новый триггер и вставьте его URL в WbizTool.
Zapier#
Приложение HighLevel в Zapier называется LeadConnector. У него один триггер — Pipeline Stage Changed. Среди его действий есть Add/Update Contact и Add Task. Как подключить WbizTool, см. Интеграция с Zapier.
- Отправка: триггер LeadConnector Pipeline Stage Changed, затем шаг Filter by Zapier для нужного этапа, затем WbizTool Send Text-Only WhatsApp Message. Выберите номер в WhatsApp Number, сопоставьте телефон контакта с Phone Number и напишите Message. Для других событий HighLevel используйте вместо этого действие Custom Webhook.
- Получение: триггер WbizTool Incoming WhatsApp Message (нужно дополнение Unibox), затем шаг Filter by Zapier, который продолжает, только если Contact Phone Hidden и Is Group равны false. Затем LeadConnector Add/Update Contact с телефоном
+и Contact Phone, затем LeadConnector Add Task с Message Content.
Make#
Приложение HighLevel в Make называется GoHighLevel. Эти шаблоны используют только универсальные модули Make Webhooks, JSON и HTTP, поэтому подключение GoHighLevel в Make не нужно. Шаблону для получения вместо этого нужны токен Private Integration HighLevel и ваш location ID (см. ниже).
Импортируйте blueprint
Скачайте шаблон ниже. В Make создайте сценарий, откройте меню … и выберите Import blueprint.
Создайте вебхук
Откройте модуль Webhooks, нажмите Add, чтобы создать вебхук, и скопируйте его адрес.
Заполните заполнители
Замените каждый заполнитель заглавными буквами в модулях HTTP, например
YOUR_WBIZTOOL_API_KEYиYOUR_WHATSAPP_CLIENT_ID.Подключите вебхук
Отправка: в HighLevel добавьте в рабочий процесс действие Webhook с адресом Make в качестве URL. В Custom Data добавьте ключ
phone_rawсо значением{{contact.phone_raw}}. Получение: вставьте адрес Make как URL вебхука номера на странице Номера для входящих, отметив только Полученные сообщения.Запустите один раз
Нажмите Run once в Make и запустите рабочий процесс или отправьте сообщение WhatsApp на свой номер.
Шаблон для получения записывает данные в HighLevel через его API с токеном Private Integration из настроек субаккаунта, со scope contacts.write, и location ID вашего субаккаунта. Вместо этого можно использовать модули Create a Contact и Add a Note to the Contact приложения GoHighLevel.
n8n#
В n8n есть встроенный узел HighLevel. Его операция Contact → Create or Update находит контакт по телефону или email либо создаёт его и может добавить Note. Сначала установите community-узел WbizTool: см. Интеграция с n8n.
Импортируйте сценарий
Скачайте шаблон ниже. В n8n создайте сценарий (workflow) и импортируйте файл (меню … → Import from File или вставьте JSON на холст).
Добавьте учётные данные
Откройте узел WbizTool Send Message и выберите или создайте учётные данные WbizTool API. В сценарии для получения откройте узел HighLevel и выберите или создайте учётные данные HighLevel.
Подключите вебхук
Скопируйте production URL узла Webhook. Отправка: используйте его как URL действия HighLevel Webhook с ключом Custom Data
phone_raw, равным{{contact.phone_raw}}. Получение: вставьте его как URL вебхука номера на странице Номера для входящих, отметив только Полученные сообщения.Активируйте
Активируйте сценарий и проведите тест.
Pabbly Connect#
Используйте собственный вебхук-триггер Pabbly Connect и его действие API (Pabbly), настроенное как в разделе Отправка сообщений WhatsApp из любого инструмента автоматизации. Для отправки направьте действие HighLevel Webhook на URL вебхука Pabbly и сопоставьте phone_raw с phone. Для входящих сообщений вставьте URL вебхука Pabbly как URL вебхука номера на странице Номера для входящих.
Шаблоны#
| Файл | Что делает |
|---|---|
| ghl-blocks.md | Готовые блоки с этой страницы в одном файле. |
| gohighlevel-to-whatsapp.make.json | Make: вебхук HighLevel → сообщение WhatsApp. |
| whatsapp-to-gohighlevel.make.json | Make: входящее сообщение WhatsApp → контакт и заметка в HighLevel. |
| gohighlevel-to-whatsapp.n8n.json | n8n: вебхук HighLevel → сообщение WhatsApp. |
| whatsapp-to-gohighlevel.n8n.json | n8n: входящее сообщение WhatsApp → контакт HighLevel с заметкой. |
Шаблоны не содержат ключей. После импорта впишите свои в заполнители или учётные данные.
Устранение неполадок#
| Проблема | Что делать |
|---|---|
Сообщение уходит не на тот номер, или Invalid phone number | Используйте {{contact.phone_raw}}, а не {{contact.phone}}. Если у номера контакта в HighLevel нет кода страны, добавьте в тело country_code или исправьте контакт. |
Either phone or group_name parameter is required | У контакта нет номера телефона. Добавьте перед действием шаг If/Else. |
Auth Error: invalid api key | Проверьте заголовок Authorization: Bearer, пробел, затем ключ, без кавычек. Возможно, ключ был удалён. См. API-ключи. |
Invalid whatsapp client или Invalid whatsapp client id. | Используйте WhatsApp Client ID со страницы Номера WhatsApp. Он обязателен, если у вас больше одного номера. |
Invalid JSON format: … | Тело — недействительный JSON: пропущена запятая, лишняя запятая в конце, настоящий перенос строки в msg или подставленное значение с двойной кавычкой. |
"status": 1, но ничего не приходит | Сообщение ждёт в очереди, пока ваш номер WhatsApp не будет подключён. Проверьте Номера WhatsApp и Статус сообщения. |
| Нет действия Custom Webhook или Inbound Webhook | Агентство не включило премиум-функции рабочих процессов (Workflow - Premium Features), или субаккаунт израсходовал бесплатные запуски, а расходы ему не перевыставляются. Обратитесь в своё агентство. |
| Входящие сообщения не доходят до HighLevel | На странице Номера для входящих у номера должен быть статус Синхронизируется, правильный URL и отмеченный пункт Полученные сообщения. Получатель должен отвечать 2xx в течение 8 секунд. Запросы приходят с User-Agent WbizTool-Webhooks/1 (+https://wbiztool.com) — на случай, если брандмауэр фильтрует по нему. Подробнее в разделе Вебхуки входящих сообщений. |
| Нужно дополнение Unibox | Для входящих сообщений нужно дополнение Unibox к платному или пожизненному тарифу. См. Тарифы и оплата. |
| Для каждого сообщения создаётся новый контакт | Сопоставляйте Phone с + в начале, чтобы HighLevel находил существующий контакт. |
| Групповые чаты создают странные контакты | Пропускайте в шаге If/Else сообщения, где contact.is_group равно true. |
| Входящие сообщения перестали приходить после включения Zap | Zap с триггером WbizTool Incoming WhatsApp Message забирает вебхук номера себе, пока он включён. Выключите Zap или используйте другой номер. |
Связанные материалы#
- API отправки сообщений: все поля и ошибки
- Вебхуки входящих сообщений: номера для входящих, доставка, полезная нагрузка
- API-ключи и Client ID
- Интеграция с Zapier
- Интеграция с n8n
- Отправка из любого инструмента автоматизации: Make, Pabbly Connect и другие

