Подключение WhatsApp к контактам GoHighLevel на номере с Coexistence

Как сообщение из WhatsApp попадает в контакт HighLevel?

Meta отправляет каждое сообщение на номере в тот адрес вебхука, который вы указали, в нашем случае это узел Webhook в n8n. Сценарий передаёт номер отправителя и имя профиля WhatsApp в узел HighLevel в n8n. У его ресурса контактов есть операция «создать или обновить», поэтому новый отправитель становится контактом, а известный находится и не дублируется.

Когда идентификатор контакта известен, узел HTTP Request отправляет текст сообщения на /contacts/{contactId}/notes. Заметка появляется в карточке контакта, и любой, кто её откроет, увидит, что написал клиент. Если сообщение требует действия, узел HighLevel может также создать задачу по контакту или сделку (opportunity) в воронке: обе операции он поддерживает напрямую.

Команда при этом продолжает отвечать из приложения WhatsApp Business.

Какой токен использовать в сценарии?

Токен Private Integration. К API v2 HighLevel обращаются через OAuth или через такие токены, а старые ключи API v1 больше не поддерживаются. Токен Private Integration создаётся в настройках субаккаунта, ограничивается отмеченными вами правами и передаётся в заголовке Authorization, как любой токен доступа.

Он не обновляется сам, и для автоматизации это удобно: токен работает, пока кто-то не выполнит ротацию. При ротации HighLevel оставляет старый и новый токены действующими вместе на семь дней. Это время, чтобы вставить новый токен в n8n до того, как старый перестанет работать.

Отметьте только нужные сценарию права: контакты, заметки и, если вы их используете, сделки и задачи. Если Private Integrations нет в настройках, HighLevel советует включить эту функцию в Labs.

Как один сценарий обслуживает несколько клиентских субаккаунтов?

Через маршрутизацию по номеру-получателю. Каждый вебхук от Meta содержит phone_number_id бизнес-номера, который принял сообщение. Направьте номера всех клиентов на один и тот же вебхук n8n, храните небольшую таблицу, где каждому phone_number_id соответствуют субаккаунт клиента и его токен, и в начале каждого запуска ищите токен по ней.

Так поддерживать нужно один сценарий для всех клиентов, а для агентства это важнее, чем для кого-либо. Исправление в логике сопоставления или в формате заметки сразу действует для всех.

Ограничения частоты запросов считаются на приложение и на субаккаунт, поэтому клиенты не расходуют лимиты друг друга: у каждого свои 100 запросов за десять секунд и 200 000 в сутки.

Попадают ли в HighLevel ответы, набранные на телефоне?

Да, могут. На номере с Coexistence приложение WhatsApp Business остаётся в работе, и когда кто-то отвечает из него, Meta отправляет эхо исходящего сообщения на тот же адрес вебхука, в поле smb_message_echoes.

Добавьте ветку для этих эхо-сообщений и записывайте их заметками с пометкой «отправлено». Тогда в карточке контакта по порядку лежат реплики клиента и ответы компании, и именно это клиент ожидает увидеть, открыв свою CRM.

Когда сам сценарий отправляет сообщение через Cloud API, например одобренный шаблон после записи на приём, создавайте заметку в момент отправки. Текст и идентификатор контакта к этому моменту уже есть в сценарии.

Распространённые ошибки

• Использование ключа API v1. API v1 HighLevel больше не поддерживается: для API v2 нужен токен Private Integration или OAuth.
• Ротация токена Private Integration без обновления n8n в течение семи дней перекрытия. Как только старый токен перестанет действовать, все вызовы будут завершаться ошибкой.
• Запись сообщений всех клиентов токеном одного субаккаунта. Сначала сопоставьте phone_number_id с нужным субаккаунтом, иначе записи попадут не к тому клиенту.

Часто задаваемые вопросы

Читайте дальше