WhatsApp + GoHighLevel интеграция: синхронизируйте данные в обоих направлениях через Whapi.Cloud

Как работает интеграция WhatsApp + GoHighLevel

Что вы можете синхронизировать между WhatsApp и GoHighLevel

• Контакты: номер телефона из WhatsApp → GHL находит или создаёт контакт; имя, фамилия и пользовательские поля синхронизируются односторонне (WhatsApp → GHL) или двусторонне, если GHL имеет исходящий вебхук.
• Сообщения: входящее сообщение WhatsApp → беседа GHL создана или обновлена; рабочий процесс GHL достигает действия «отправить сообщение WhatsApp» → вызов API Whapi отправляет сообщение обратно клиенту.
• События группы: участник присоединяется к группе WhatsApp, участник уходит, участник повышен — вебхук Whapi срабатывает → триггер входящего вебхука GHL запускает рабочий процесс (пометьте его, назначьте владельца, отправьте приветствие, создайте задачу).
• Теги и пользовательские поля: GHL может помечать контакты по поведению WhatsApp (например, тег «whatsapp-group-member»); эти теги могут запускать последующие рабочие процессы (последовательности развития, правила назначения, фильтры отчётов).
• Триггеры рабочих процессов: любой рабочий процесс GHL может слушать тип события входящего вебхука и выполнять действия на основе полезной нагрузки (условная логика, вызовы API, многошаговые последовательности).

Архитектура двусторонней синхронизации

INBOUND (WhatsApp → Whapi → GHL):

1. Customer acts on WhatsApp
   (sends message, joins group, updates status, etc.)

2. Whapi.Cloud receives the event
   and fires a webhook to your GHL inbound webhook URL
   Payload: { event, phone, name, group_id, timestamp, ... }

3. GHL Inbound Webhook Trigger
   receives the JSON payload
   Validates it (optional signature check)
   Extracts data: phone, name, event type

4. GHL Workflow executes
   Find or Create Contact (by phone)
   Add Tags (e.g., "whatsapp-group-member")
   Update Custom Fields
   Trigger nested workflows (send email, SMS, WhatsApp, assign owner)

OUTBOUND (GHL → Whapi → WhatsApp):

5. GHL Workflow Action fires
   (e.g., "Send WhatsApp Message" custom webhook)

6. Custom Webhook Calls Whapi API
   POST https://gate.whapi.cloud/messages/text
   Body: { to: phone, body: message_text }
   Headers: Authorization: Bearer YOUR_WHAPI_TOKEN

7. Whapi sends the message via WhatsApp
   to the customer's number

8. Customer receives the message on WhatsApp
   (no app notification, just appears in chat)

9. (Optional) Whapi webhook fires back to GHL
   marking the message as delivered/read
   GHL conversation updates with delivery status
  

Шаг 1: Подключение событий WhatsApp к GoHighLevel

1. Перейдите в Workflows → создайте новый рабочий процесс (или откройте существующий).
2. Добавьте Trigger: поищите «Inbound Webhook».
3. GHL генерирует уникальный URL вебхука — он выглядит так: https://api.gohighlevel.com/webhooks/[WORKSPACE_ID]/[TRIGGER_ID]
4. Скопируйте этот URL. Вы вставите его в параметры Whapi.

1. Перейдите в Settings → Webhooks.
2. Добавьте новый URL вебхука. Вставьте скопированный выше URL входящего вебхука GHL.
3. Выберите типы событий, которые вы хотите получать:
   • message.created (входящие сообщения)
   • group.member.joined (события членства в группе)
   • contact.status_changed (онлайн/оффлайн, печать и т.д.)
4. Сохраните. Whapi протестирует вебхук, отправив тестовое событие в GHL.
5. Если GHL получит его, вы увидите зелёную галочку. Если нет, проверьте, активен ли триггер рабочего процесса GHL.

Шаг 2: Создание и обновление контактов GHL из WhatsApp

1. Добавьте действие: Find or Create Contact.
2. Установите поле совпадения как Phone.
3. Сопоставьте номер телефона входящего полезной нагрузки вебхука с полем телефона контакта.
   • Путь полезной нагрузки: ${trigger.body.data.phone} (подстройте в зависимости от формы полезной нагрузки вебхука Whapi)
4. Если контакт с этим телефоном существует, GHL находит его. Если нет, GHL создаёт новый контакт с:
   • Phone: ${trigger.body.data.phone}
   • First Name: ${trigger.body.data.name} (опционально; установите значение по умолчанию, если не предоставлено)

Шаг 3: Синхронизация сообщений WhatsApp с беседами GHL

1. Custom Webhook (или «Send HTTP Request»).
2. Установите метод POST.
3. URL: https://gate.whapi.cloud/messages/text
4. Заголовки:
   • Authorization: Bearer YOUR_WHAPI_TOKEN
   • Content-Type: application/json
5. Body (JSON):
   • to: номер телефона контакта (например, ${contact.phone})
   • body: текст сообщения (например, "Welcome to our group!")

{
  "to": "+1234567890",
  "body": "Welcome to the group, John! We are excited to have you. Check pinned messages for important updates."
}
  

Реальный пример: присоединение к группе WhatsApp → рабочий процесс GHL → приветственное сообщение

{
  "event": "group.member.joined",
  "phone": "+1987654321",
  "name": "Sarah Martinez",
  "group_id": "[email protected]",
  "group_name": "Real Estate Team - North Region",
  "timestamp": 1695283200
}
  

1. Trigger: входящий вебхук получает событие group.member.joined.
2. Find or Create Contact: поиск по номеру телефона +1987654321. Сара новая, поэтому GHL создаёт контакт с именем «Sarah Martinez».
3. Add Tags: добавьте теги "whatsapp-group-member" и "realtor-north-region" к контакту Сары.
4. Assign Owner: направить менеджеру Северного региона (например, через правило рабочего процесса: если тег = «realtor-north-region», назначить владельцу «[email protected]»).
5. Create Task: «Приветствовать Сару в команде — отправить документы адаптации».
6. Custom Webhook (Send WhatsApp): вызовите API Whapi для отправки персонализированного приветственного сообщения на номер Сары.
   • Сообщение: "Welcome, ${contact.firstName}! You are now part of the Real Estate Team. Check your email for onboarding docs. Questions? Reply here."
7. Log Note: добавьте примечание к контакту Сары: «Присоединилась к группе WhatsApp [дата]. Рабочий процесс выполнен.»

Построение дополнительных рабочих процессов GoHighLevel с триггерами WhatsApp

• Новое сообщение клиента → создание билета: входящее сообщение WhatsApp запускает создание билета; если открытого билета не существует, направить в очередь поддержки и отправить автоответ: «Мы получили ваше сообщение. Поддержка отвечает за 2 часа.»
• Рабочий процесс заброшенного контакта: контакт не активен в WhatsApp 30 дней → GHL отправляет повторное привлечение сообщения WhatsApp, последующее электронное письмо, создать задачу продаж.
• Обновления статуса заказа: клиент с пометкой «has-active-order» → GHL отправляет ежедневное сообщение WhatsApp: «Ваш заказ отправляется завтра. Отслеживание: [URL].»
• Поток квалификации лида: новый контакт присоединяется к группе → GHL задаёт квалификационные вопросы через WhatsApp → помечает их «hot-lead» или «cold-lead» на основе ответов → направляет в соответствующий рабочий процесс продаж.
• Обмен сообщениями на основе разрешений: поле контакта «consent-marketing» = true → GHL отправляет рекламное сообщение WhatsApp; если false, только транзакционные сообщения. Соответствие встроено в рабочий процесс.

Избегаем проблем синхронизации и дублирующихся событий

Контрольный список интеграции WhatsApp + GoHighLevel

• URL вебхука Whapi работает в GHL — протестируйте, отправив сообщение WhatsApp с другого номера; подтвердите, что GHL получает входящий вебхук (проверьте логи вебхуков GHL).
• Совпадение контактов работает — создайте тестовый контакт в GHL с известным номером, отправьте сообщение WhatsApp с этого номера, подтвердите, что GHL находит существующий контакт (не создавая дубликат).
• Исходящие сообщения WhatsApp отправляются успешно — выполните действие «Send WhatsApp» вебхука в GHL, подтвердите, что сообщение доходит в WhatsApp. Следите за ошибками 401 или 403 (проблема с токеном аутентификации) и ошибками 404 (номер не подключен в Whapi).
• Рабочие процессы идемпотентны — вручную запустите одну и ту же полезную нагрузку вебхука дважды; подтвердите, что задачи, теги и сообщения не дублируются.
• Формат номера телефона согласован — все номера телефонов в GHL используют один и тот же формат (например, +1234567890 с префиксом +). Проверьте, запросив несколько контактов и сравнив с полезными нагрузками вебхука Whapi.
• Обработка ошибок на месте — рабочий процесс GHL включает условие «if webhook fails» (например, токен Whapi истёк, номер WhatsApp не подключен); добавьте действие отката, например «send SMS» или «log error and alert admin».
• Соблюдаются ограничения скорости — если отправляю 100+ сообщений/час, раздвигаю их (добавляю 1-секундную задержку между отправками в GHL или используя очередь). Отслеживайте количество вызовов API на панели Whapi и предупреждения о rate-limit WhatsApp.
• Логирование и мониторинг включены — GHL логирует каждый входящий вебхук и действие исходящего сообщения (проверьте логи выполнения GHL); панель Whapi показывает статус доставки вебхука и подтверждения доставки сообщения.