Перейти к содержимому
OmniChannels.ai
Меню

Интеграция WhatsApp с CRM: 3 способа подключения

Интеграция WhatsApp с CRM: готовые коннекторы, посредники или API с вебхуками. Потоки данных, сопоставление полей, синхронизация согласий и чек-лист выбора.

Обновлено 10 мин чтения

Автор: OmniChannels.ai Editorial Team · Проверил: BroadNet Messaging Solutions Team

Интеграции

Короткий ответ

Интеграция WhatsApp с CRM связывает WhatsApp Business API с вашей CRM, чтобы входящие сообщения, статусы доставки и исходящие отправки привязывались к карточкам контактов. Её можно построить тремя способами: готовым коннектором, через посредника или инструменты автоматизации либо напрямую через API и вебхуки. Выбирайте по сложности логики, по тому, кто будет поддерживать решение, и по строгости синхронизации согласий.

На этой странице
  1. Что такое интеграция WhatsApp с CRM?
  2. Что нужно подготовить до старта?
  3. Какие есть три способа интегрировать WhatsApp с CRM?
  4. Как движутся данные? Пошаговая картина
  5. Какие поля сопоставлять между WhatsApp и CRM?
  6. Как синхронизировать согласия между WhatsApp и CRM?
  7. Как сделать интеграцию надёжной?
  8. Какие CRM и инструменты мы описываем?
  9. Могут ли ИИ-агенты работать с CRM и WhatsApp?
  10. Пример: агентство недвижимости в Джидде
  11. Каких ошибок избегать?
  12. Чем помогает OmniChannels.ai

Главное

  • Интеграция WhatsApp с CRM — это два потока данных: CRM запускает исходящие сообщения через API, а входящие сообщения и статусы доставки возвращаются вебхуками и обновляют контакт.
  • Три подхода: готовый коннектор (быстрее всего, меньше гибкости), посредник или инструменты автоматизации (золотая середина) и прямая работа через API и вебхуки (максимум контроля, нужны разработчики).
  • Сопоставляйте людей по нормализованному номеру в формате E.164, а не по имени, и храните источник и время согласия в полях CRM.
  • События вебхуков могут приходить дважды или не по порядку, поэтому сохраняйте исходное событие, подтверждайте приём быстро и обрабатывайте асинхронно с дедупликацией.
  • Сообщения по инициативе бизнеса вне 24-часового окна обслуживания требуют одобренных шаблонов, поэтому CRM должна хранить время последнего входящего сообщения.

Это руководство для специалистов по продажам, администраторов CRM и разработчиков, которые хотят, чтобы диалоги и сообщения WhatsApp хранились в CRM. Здесь три способа подключения, данные, которые должны передаваться в каждую сторону, и правила по согласиям и надёжности, которые чаще всего упускают.

Что такое интеграция WhatsApp с CRM?

Интеграция WhatsApp с CRM — это связь между WhatsApp Business API и CRM, благодаря которой сообщения, статусы доставки и согласия привязываются к нужному контакту, лиду или обращению.

Она всегда включает два потока:

  • Исходящий: событие в CRM (отправка формы, этап сделки, дата) запускает сообщение WhatsApp через API.
  • Входящий: ответы клиентов и статусы доставки приходят вебхуком, сопоставляются с контактом и записываются в CRM.

Не путайте её с виджетом в боковой панели, который показывает чаты. Ценность дают два потока и точное сопоставление контактов. Подробнее о механике вебхуков читайте в статье Как подключить CRM к омниканальному инбоксу через вебхуки.

Что нужно подготовить до старта?

Вам понадобятся номер WhatsApp Business API, одобренные шаблоны для сообщений по инициативе бизнеса, CRM, умеющая вызывать API или запускать вебхуки, и описанный процесс получения согласий.

Чек-лист:

  1. Зарегистрированный номер на WhatsApp Business Platform (не бесплатное приложение Business; см. API и приложение Business). См. как подключить WhatsApp Business API и чек-лист готовности.
  2. Одобренные шаблоны для сообщений, которые будет запускать CRM, в правильной категории.
  3. Телефонные номера в формате E.164 (код страны, без пробелов и ведущих нулей).
  4. Запись об opt-in для каждого контакта.
  5. Ответственный за интеграцию и канал оповещений о сбоях.

Какие есть три способа интегрировать WhatsApp с CRM?

Можно использовать готовый коннектор, посредника или инструменты автоматизации либо прямую работу через API и вебхуки. Эти варианты обменивают скорость на контроль.

Готовый коннектор Посредник или инструмент автоматизации Прямой API и вебхуки
Что это Готовое приложение или встроенная функция, связывающая провайдера сообщений с CRM Визуальный конструктор сценариев (например, Zapier, Make или n8n) между CRM и API Ваш собственный код, который вызывает REST API и принимает вебхуки
Скорость старта Максимальная Высокая Самая низкая
Гибкость Ограничена возможностями коннектора Высокая для типовых сценариев Наибольшая
Кто поддерживает Вендор коннектора Бизнес-аналитик Ваши разработчики
Типичное ограничение Фиксированное сопоставление полей; может не покрывать все каналы и пользовательские объекты Лимиты задач, задержки и ограничения на запуск в инструменте Нужны время инженеров, мониторинг и тесты
Лучше всего для Стандартных задач на поддерживаемой CRM Команд без разработчиков; прототипов Сложной логики, больших объёмов, строгих правил согласия

Относитесь с осторожностью к заявлениям, что коннектор «просто работает». Спросите, что он делает, когда вебхук приходит дважды, когда номер совпадает с двумя контактами и как проверяется согласие.

О нашем подходе: OmniChannels.ai интегрируется через REST API, вебхуки и инструменты автоматизации, и на наших страницах интеграций прямо сказано, что приложений в маркетплейсах этих CRM нет.

Какой подход выбрать?

  1. Если у вашей CRM есть коннектор, закрывающий ваш сценарий и поля согласий, начните с него.
  2. Если нужны триггеры и обновление полей без собственного кода, используйте посредника.
  3. Если нужны собственная логика, большой объём или аудит, работайте с API напрямую, возможно, начав с посредника.
  4. Что бы вы ни выбрали, сначала тестируйте на собственных проверенных номерах.

Как движутся данные? Пошаговая картина

Словами поток выглядит так.

Исходящее

  1. Срабатывает сценарий CRM (например, новый лид с согласием).
  2. Сценарий или посредник проверяет согласие и время последнего входящего сообщения.
  3. Он вызывает API сообщений с номером контакта в формате E.164 и одобренным шаблоном либо с сообщением в свободной форме, если 24-часовое окно открыто.
  4. API возвращает идентификатор сообщения, который вы сохраняете в истории контакта.

Входящее и статусы 5. WhatsApp доставляет ответ клиента платформе, которая отправляет событие на URL вашего вебхука. 6. Ваш эндпоинт сохраняет исходное тело, отвечает кодом 2xx и ставит событие в очередь. 7. Обработчик сопоставляет номер отправителя с контактом, при необходимости создаёт его (если процесс это допускает) и записывает сообщение. 8. События статуса (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED в нашем нормализованном формате) обновляют сохранённое сообщение, но никогда не возвращают статус назад. 9. Срабатывают правила: назначить ответственного, создать задачу, сменить этап сделки или поставить тег контакту.

Meta описывает вебхук сообщений WhatsApp как охватывающий сообщения от пользователей и статус отправленных вами сообщений. В нашей документации по вебхукам описаны статусы доставки, повторные попытки и действия при потере событий. Поля в данных различаются по каналам, поэтому логируйте исходные события и сопоставляйте по реальным примерам из вашего аккаунта.

Какие поля сопоставлять между WhatsApp и CRM?

Сопоставляйте небольшой набор стабильных идентификаторов и полей состояния, а содержимое сообщений не храните в CRM без необходимости.

Поле CRM (рекомендуемое) Источник Направление Примечания
Мобильный телефон (E.164) CRM или форма CRM → API Нормализуйте перед отправкой; при необходимости проверяйте через lookup
Согласие WhatsApp (да/нет/отозвано) Сбор opt-in CRM — источник истины Проверяйте перед каждой маркетинговой отправкой
Источник и время согласия Форма, QR-код, чат или флажок CRM Сохраняйте формулировку, показанную клиенту
Предпочитаемый язык CRM CRM → API Определяет язык шаблона
Время последнего входящего сообщения Вебхук API → CRM Показывает, открыто ли 24-часовое окно
Статус последнего сообщения Вебхук API → CRM Обновления только вперёд
Идентификатор сообщения Ответ API API → CRM Нужен для сопоставления статусов с записями истории
Ссылка на диалог Инбокс API → CRM Позволяет менеджеру открыть переписку в один клик
Владелец или назначенный оператор CRM или инбокс В обе стороны Определите, какая система побеждает при конфликте
Этап жизненного цикла или теги CRM CRM → инбокс Показывает операторам контекст сделки

Создайте эти пользовательские свойства заранее: менять тип поля после запуска мучительно.

Как синхронизировать согласия между WhatsApp и CRM?

Считайте CRM источником истины об opt-in и проверяйте его перед каждым маркетинговым сообщением по инициативе бизнеса. Бизнес-политика WhatsApp разрешает писать людям только если они сообщили вам номер и согласились получать сообщения, и требует уважать просьбы заблокировать, прекратить общение или отписаться.

Рабочий набор правил:

  1. Получайте согласие с понятным описанием того, что человек будет получать и в каком канале.
  2. Храните согласие по каналам, с источником, временем и формулировкой.
  3. Обновляйте согласие сразу при сообщении об отписке или блокировке.
  4. Пусть шаг отправки читает поле, а не кешированный список.
  5. Разделяйте сервисные диалоги (ответы на собственное сообщение клиента) и маркетинговые отправки.

Прочитайте материал про opt-in и согласие в мультиканальных кампаниях и подготовьте формулировки в генераторе согласия на рассылку.

Как сделать интеграцию надёжной?

Подтверждайте вебхуки быстро, сохраняйте до обработки и делайте обработку идемпотентной.

  • Сначала сохраните, потом подтвердите, потом обработайте. Медленные вызовы CRM внутри обработчика вызывают повторы и дубликаты.
  • Дедуплицируйте по идентификатору сообщения; повторное событие должно приводить к пустой операции.
  • Ожидайте события не по порядку. Запоздавший SENT не должен перезаписывать DELIVERED.
  • Ограничивайте частоту вызовов CRM и делайте паузы при ошибках.
  • Сопоставляйте контакты аккуратно. Нормализуйте номера, продуманно обрабатывайте два контакта с одним номером и никогда не объединяйте только по имени.
  • Никогда не отправляйте повторно из обработчика вебхука. Решение о повторах принимайте в отдельной задаче после проверки статуса.
  • Защитите эндпоинт. Используйте HTTPS, неугадываемый путь и проверку формы тела запроса. Meta описывает mTLS для собственных вебхуков; для наших см. страницу про вебхуки.
  • Мониторьте. Настройте оповещения о сбоях вебхуков, длине очереди и падении числа входящих событий.

Какие CRM и инструменты мы описываем?

На страницах интеграций мы описываем сценарии для нескольких систем. Ни одна из них не означает приложение в маркетплейсе; в каждой объясняется, как использовать REST API и вебхуки с этим продуктом.

Система Типичный сценарий Страница
HubSpot Пользовательский код в сценарии, действие-вебхук или инструмент автоматизации HubSpot
Salesforce HTTP-вызов во Flow или вызов из Apex с Named Credential Salesforce
Zoho CRM Вебхук в сценарии или функция Deluge Zoho CRM
Microsoft Dynamics 365 Поток Power Automate Dynamics 365
Zendesk Вебхук по триггеру; инструмент автоматизации для ответов Zendesk
Freshdesk Вебхук правила автоматизации; инструмент автоматизации для ответов Freshdesk
Инструменты автоматизации Zapier, Make, n8n Zapier, Make, n8n

Какие действия доступны внутри CRM, зависит от вашего тарифа у этого вендора, поэтому уточняйте в его документации.

Могут ли ИИ-агенты работать с CRM и WhatsApp?

Да, если дать агенту контролируемые инструменты. Model Context Protocol (MCP) — открытый стандарт, позволяющий ИИ-ассистентам вызывать внешние инструменты. Наш MCP-сервер открывает клиентам MCP API сообщений (отправка, шаблоны, отчёты о доставке) с правами выданного вами токена; для чтения и обновления записей CRM нужен коннектор, который вы контролируете. Начните с поиска только на чтение, добавляйте действия записи по одному и логируйте всё. См. руководство по MCP-серверу WhatsApp и ИИ-агентов для клиентского сервиса.

Пример: агентство недвижимости в Джидде

«Red Sea Homes» — условное агентство — хочет, чтобы на каждый запрос по объекту приходил ответ в WhatsApp, а каждый диалог отображался в карточке лида.

  1. Запрос с портала создаёт лид с телефоном в формате E.164 и флажком согласия из формы.
  2. Сценарий проверяет согласие, затем отправляет одобренный служебный шаблон с подтверждением запроса и сохраняет идентификатор сообщения.
  3. Клиент отвечает; вебхук обновляет «время последнего входящего» и назначает ответственного за лид.
  4. Ответственный отвечает 24 часа из инбокса сообщениями в свободной форме. После паузы следующее напоминание уходит одобренным шаблоном нужной категории и при наличии согласия.
  5. Смена этапа на «просмотр назначен» отправляет шаблон-напоминание за день до просмотра.
  6. Раз в неделю команда разбирает неудачные отправки и несовпавшие номера.

О самих сообщениях читайте в материале работа с лидами в недвижимости через WhatsApp.

Каких ошибок избегать?

  • Сопоставлять контакты по имени или по неформатированным номерам.
  • Пропускать поле согласия и полагаться на память.
  • Обрабатывать событие прямо в обработчике вебхука и упираться в тайм-аут.
  • Отправлять маркетинговый контент в шаблоне категории utility; категорию определяет Meta.
  • Забывать, что вне 24-часового окна можно отправлять только шаблоны.
  • Позволять двум системам править одно поле без правила, чья версия главнее.
  • Не настраивать оповещения, из-за чего сломанный вебхук остаётся незамеченным неделями.

Чем помогает OmniChannels.ai

OmniChannels.ai на платформе BroadNet Technologies предлагает REST/JSON API, вебхуки для статусов доставки, Omni Inbox для диалогов операторов и MCP-сервер для ИИ-агентов. BroadNet — официальный бизнес-провайдер решений Meta (Meta Business Solution Provider), а наша команда вместе с вами занимается подключением и регистрациями WhatsApp. Разработчики могут начать с документации по API и руководства по WhatsApp API; тестовый доступ открывается на ваши собственные проверенные номера, мгновенной самостоятельной регистрации нет.

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

Что такое интеграция WhatsApp с CRM?

Это связь между WhatsApp Business API и CRM, при которой диалоги, статусы сообщений и согласия привязаны к нужному контакту или лиду. Обычно CRM запускает исходящие сообщения из сценариев, а вебхуки возвращают входящие сообщения и статусы доставки, обновляя записи и историю. У одного приложения WhatsApp Business такого API-подключения нет.

Можно ли подключить приложение WhatsApp Business к CRM?

Как правило, нет. Интеграции с CRM работают через WhatsApp Business Platform — API, которым пользуются бизнес-провайдеры решений, а не через бесплатное приложение Business. Вы регистрируете номер на платформе, и это меняет способ его использования. Прежде чем переносить номер, с которым сейчас работают операторы на телефоне, изучите наше сравнение API и приложения Business.

Какие CRM можно подключить к WhatsApp?

Любая CRM, которая умеет вызывать HTTP API или запускать вебхуки, подключается к WhatsApp Business API напрямую или через инструмент автоматизации. На страницах интеграций мы описываем сценарии для HubSpot, Salesforce, Zoho CRM, Microsoft Dynamics 365, Zendesk и Freshdesk. Доступность встроенных действий зависит от тарифа вашей CRM, поэтому проверьте свой план.

Нужен ли разработчик для интеграции WhatsApp с CRM?

Не всегда. Простые триггеры, например отправку шаблона при смене этапа сделки, можно настроить в инструменте автоматизации или в сценарии CRM. Разработчик нужен для собственной логики полей, двусторонней синхронизации с дедупликацией, проверок согласия, повторных попыток и всего, что должно масштабироваться. В любом случае заложите мониторинг: без оповещений интеграции ломаются молча.

Как учитывать opt-in и согласия в CRM?

Храните поле согласия по каждому каналу, а также источник, время и показанную формулировку. Проверяйте его перед каждой маркетинговой отправкой и сразу обновляйте при отказе. Бизнес-политика WhatsApp разрешает писать людям только если они сами сообщили вам номер и дали согласие, поэтому CRM должна быть источником истины об этом статусе.

Может ли ИИ-агент читать и обновлять мою CRM из WhatsApp?

ИИ-агент может искать и обновлять записи с помощью инструментов, если подключить его к вашим системам, например через Model Context Protocol (MCP). Дайте ему узкие права, логируйте каждое действие и сохраняйте путь к живому оператору. Наш MCP-сервер открывает клиентам MCP API сообщений; для действий в CRM нужен коннектор, который вы контролируете.

Источники

  1. WhatsApp Business Messaging Policy
  2. Webhooks overview: WhatsApp Business Platform, Meta for Developers
  3. Send messages and the customer service window, Meta for Developers
  4. Template categorization, Meta for Developers