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

Интеграции

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.
ZapierLeadConnector Pipeline Stage Changed → WbizTool Send Text-Only WhatsApp MessageWbizTool 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 → узел HighLeveln8n с community-узлом WbizTool. Получение: дополнение Unibox.
Pabbly ConnectДействие HighLevel Webhook → вебхук-триггер Pabbly → запрос API (Pabbly)Вебхук WbizTool → вебхук-триггер Pabbly → ваш шаг HighLevelАккаунт Pabbly Connect. Получение: дополнение Unibox.

Отправка сообщений WhatsApp из рабочего процесса HighLevel#

  1. Откройте или создайте рабочий процесс

    В субаккаунте HighLevel откройте Automation и создайте рабочий процесс или отредактируйте существующий. Задайте ему нужный триггер, например отправку формы, новый тег или записанный приём.

  2. Добавьте действие Custom Webhook

    Нажмите + там, где должно уходить сообщение, затем Send Data → Custom Webhook (или найдите в действиях «webhook» и выберите Custom Webhook). Простое действие Webhook не умеет задавать заголовок и тело, которые нужны этому API.

  3. Настройте запрос

    Установите 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.

  4. Вставьте тело запроса

    Вставьте один из готовых блоков в Raw Body и замените 678 на ваш WhatsApp Client ID. Значок тега в HighLevel добавляет в сообщение другие поля контакта.

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

    Сохраните действие и опубликуйте рабочий процесс. Запустите его для тестового контакта со своим номером телефона. Каждый запуск виден в журналах выполнения (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

Raw Body для действия Custom Webhook
{
  "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: 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 сообщения не появляются.

  1. Создайте рабочий процесс с триггером Inbound Webhook

    В HighLevel создайте рабочий процесс и выберите триггер Inbound Webhook. Скопируйте показанный URL вебхука.

  2. Направьте на него свой номер WhatsApp

    В WbizTool откройте Номера для входящих. Нажмите Добавить номер во входящие, выберите номер и вставьте URL из HighLevel в поле URL вебхука (необязательно). Для номера, который уже во входящих, вставьте его в Настройки вебхука этого номера. В блоке Какие сообщения отправлять отметьте только Полученные сообщения. Каждая отправка — это один премиум-запуск в HighLevel, поэтому не включайте Отправленные сообщения, если они вам не нужны.

  3. Отправьте тестовое сообщение

    С другого телефона отправьте сообщение на ваш номер WhatsApp. Оно будет отправлено после следующей проверки, обычно в течение минуты-двух. В HighLevel нажмите Test Trigger, выберите запрос в Mapping Reference и сохраните триггер. Поля перечислены в разделе Полезная нагрузка.

  4. Пропускайте группы и скрытые номера

    Добавьте шаг If/Else, который продолжает, только если event равно message_received, contact.is_group равно false и contact.phone не пустой. WhatsApp иногда скрывает номер отправителя, а сообщения из групп содержат ID группы вместо номера телефона.

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

    В действии Create/Update Contact задайте для Phone значение +, за которым следует contact → phone из значений Inbound Webhook. WbizTool отправляет номер без +, а + сообщает HighLevel, что номер содержит код страны. Можно также сопоставить contact → name. Это имя отправителя в WhatsApp, и оно может заменить имя, которое вы изменили в HighLevel.

  6. Добавьте сообщение в контакт

    Добавьте действие Add to Notes. Напишите заметку, например «Сообщение WhatsApp:», и выберите message → content и message → timestamp из значений Inbound Webhook. Можно также добавить Add Contact Tag (например, whatsapp), задачу или внутреннее уведомление для команды.

  7. Опубликуйте

    Опубликуйте рабочий процесс и отправьте ещё одно тестовое сообщение.

Значение Inbound WebhookДля чего
contact.phoneТелефон контакта. Добавьте + в начало.
contact.nameИмя отправителя в WhatsApp. Может быть пустым.
message.contentТекст. Для фото, голосовых сообщений и файлов это метка вроде 📸 Image, подписи не включаются.
message.timestampКогда сообщение было отправлено в WhatsApp (ISO 8601, UTC).
message.media.urlСсылка для скачивания фото или файла. Она истекает через 3½–7 дней, поэтому не полагайтесь на неё в заметке.
whatsapp_phoneКакой из ваших номеров его получил, если несколько номеров отправляют в один рабочий процесс.
eventmessage_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 (см. ниже).

  1. Импортируйте blueprint

    Скачайте шаблон ниже. В Make создайте сценарий, откройте меню … и выберите Import blueprint.

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

    Откройте модуль Webhooks, нажмите Add, чтобы создать вебхук, и скопируйте его адрес.

  3. Заполните заполнители

    Замените каждый заполнитель заглавными буквами в модулях HTTP, например YOUR_WBIZTOOL_API_KEY и YOUR_WHATSAPP_CLIENT_ID.

  4. Подключите вебхук

    Отправка: в HighLevel добавьте в рабочий процесс действие Webhook с адресом Make в качестве URL. В Custom Data добавьте ключ phone_raw со значением {{contact.phone_raw}}. Получение: вставьте адрес Make как URL вебхука номера на странице Номера для входящих, отметив только Полученные сообщения.

  5. Запустите один раз

    Нажмите 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.

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

    Скачайте шаблон ниже. В n8n создайте сценарий (workflow) и импортируйте файл (меню … → Import from File или вставьте JSON на холст).

  2. Добавьте учётные данные

    Откройте узел WbizTool Send Message и выберите или создайте учётные данные WbizTool API. В сценарии для получения откройте узел HighLevel и выберите или создайте учётные данные HighLevel.

  3. Подключите вебхук

    Скопируйте production URL узла Webhook. Отправка: используйте его как URL действия HighLevel Webhook с ключом Custom Data phone_raw, равным {{contact.phone_raw}}. Получение: вставьте его как URL вебхука номера на странице Номера для входящих, отметив только Полученные сообщения.

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

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

Pabbly Connect#

Используйте собственный вебхук-триггер Pabbly Connect и его действие API (Pabbly), настроенное как в разделе Отправка сообщений WhatsApp из любого инструмента автоматизации. Для отправки направьте действие HighLevel Webhook на URL вебхука Pabbly и сопоставьте phone_raw с phone. Для входящих сообщений вставьте URL вебхука Pabbly как URL вебхука номера на странице Номера для входящих.

Шаблоны#

ФайлЧто делает
ghl-blocks.mdГотовые блоки с этой страницы в одном файле.
gohighlevel-to-whatsapp.make.jsonMake: вебхук HighLevel → сообщение WhatsApp.
whatsapp-to-gohighlevel.make.jsonMake: входящее сообщение WhatsApp → контакт и заметка в HighLevel.
gohighlevel-to-whatsapp.n8n.jsonn8n: вебхук HighLevel → сообщение WhatsApp.
whatsapp-to-gohighlevel.n8n.jsonn8n: входящее сообщение 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.
Входящие сообщения перестали приходить после включения ZapZap с триггером WbizTool Incoming WhatsApp Message забирает вебхук номера себе, пока он включён. Выключите Zap или используйте другой номер.

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