Интеграция WhatsApp с CRM: 3 способа подключения
Интеграция WhatsApp с CRM: готовые коннекторы, посредники или API с вебхуками. Потоки данных, сопоставление полей, синхронизация согласий и чек-лист выбора.
Автор: OmniChannels.ai Editorial Team · Проверил: BroadNet Messaging Solutions Team
Интеграции
Короткий ответ
Интеграция WhatsApp с CRM связывает WhatsApp Business API с вашей CRM, чтобы входящие сообщения, статусы доставки и исходящие отправки привязывались к карточкам контактов. Её можно построить тремя способами: готовым коннектором, через посредника или инструменты автоматизации либо напрямую через API и вебхуки. Выбирайте по сложности логики, по тому, кто будет поддерживать решение, и по строгости синхронизации согласий.
На этой странице
- Что такое интеграция WhatsApp с CRM?
- Что нужно подготовить до старта?
- Какие есть три способа интегрировать WhatsApp с CRM?
- Как движутся данные? Пошаговая картина
- Какие поля сопоставлять между WhatsApp и CRM?
- Как синхронизировать согласия между WhatsApp и CRM?
- Как сделать интеграцию надёжной?
- Какие CRM и инструменты мы описываем?
- Могут ли ИИ-агенты работать с CRM и WhatsApp?
- Пример: агентство недвижимости в Джидде
- Каких ошибок избегать?
- Чем помогает 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 или запускать вебхуки, и описанный процесс получения согласий.
Чек-лист:
- Зарегистрированный номер на WhatsApp Business Platform (не бесплатное приложение Business; см. API и приложение Business). См. как подключить WhatsApp Business API и чек-лист готовности.
- Одобренные шаблоны для сообщений, которые будет запускать CRM, в правильной категории.
- Телефонные номера в формате E.164 (код страны, без пробелов и ведущих нулей).
- Запись об opt-in для каждого контакта.
- Ответственный за интеграцию и канал оповещений о сбоях.
Какие есть три способа интегрировать WhatsApp с CRM?
Можно использовать готовый коннектор, посредника или инструменты автоматизации либо прямую работу через API и вебхуки. Эти варианты обменивают скорость на контроль.
| Готовый коннектор | Посредник или инструмент автоматизации | Прямой API и вебхуки | |
|---|---|---|---|
| Что это | Готовое приложение или встроенная функция, связывающая провайдера сообщений с CRM | Визуальный конструктор сценариев (например, Zapier, Make или n8n) между CRM и API | Ваш собственный код, который вызывает REST API и принимает вебхуки |
| Скорость старта | Максимальная | Высокая | Самая низкая |
| Гибкость | Ограничена возможностями коннектора | Высокая для типовых сценариев | Наибольшая |
| Кто поддерживает | Вендор коннектора | Бизнес-аналитик | Ваши разработчики |
| Типичное ограничение | Фиксированное сопоставление полей; может не покрывать все каналы и пользовательские объекты | Лимиты задач, задержки и ограничения на запуск в инструменте | Нужны время инженеров, мониторинг и тесты |
| Лучше всего для | Стандартных задач на поддерживаемой CRM | Команд без разработчиков; прототипов | Сложной логики, больших объёмов, строгих правил согласия |
Относитесь с осторожностью к заявлениям, что коннектор «просто работает». Спросите, что он делает, когда вебхук приходит дважды, когда номер совпадает с двумя контактами и как проверяется согласие.
О нашем подходе: OmniChannels.ai интегрируется через REST API, вебхуки и инструменты автоматизации, и на наших страницах интеграций прямо сказано, что приложений в маркетплейсах этих CRM нет.
Какой подход выбрать?
- Если у вашей CRM есть коннектор, закрывающий ваш сценарий и поля согласий, начните с него.
- Если нужны триггеры и обновление полей без собственного кода, используйте посредника.
- Если нужны собственная логика, большой объём или аудит, работайте с API напрямую, возможно, начав с посредника.
- Что бы вы ни выбрали, сначала тестируйте на собственных проверенных номерах.
Как движутся данные? Пошаговая картина
Словами поток выглядит так.
Исходящее
- Срабатывает сценарий CRM (например, новый лид с согласием).
- Сценарий или посредник проверяет согласие и время последнего входящего сообщения.
- Он вызывает API сообщений с номером контакта в формате E.164 и одобренным шаблоном либо с сообщением в свободной форме, если 24-часовое окно открыто.
- 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 разрешает писать людям только если они сообщили вам номер и согласились получать сообщения, и требует уважать просьбы заблокировать, прекратить общение или отписаться.
Рабочий набор правил:
- Получайте согласие с понятным описанием того, что человек будет получать и в каком канале.
- Храните согласие по каналам, с источником, временем и формулировкой.
- Обновляйте согласие сразу при сообщении об отписке или блокировке.
- Пусть шаг отправки читает поле, а не кешированный список.
- Разделяйте сервисные диалоги (ответы на собственное сообщение клиента) и маркетинговые отправки.
Прочитайте материал про 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, а каждый диалог отображался в карточке лида.
- Запрос с портала создаёт лид с телефоном в формате E.164 и флажком согласия из формы.
- Сценарий проверяет согласие, затем отправляет одобренный служебный шаблон с подтверждением запроса и сохраняет идентификатор сообщения.
- Клиент отвечает; вебхук обновляет «время последнего входящего» и назначает ответственного за лид.
- Ответственный отвечает 24 часа из инбокса сообщениями в свободной форме. После паузы следующее напоминание уходит одобренным шаблоном нужной категории и при наличии согласия.
- Смена этапа на «просмотр назначен» отправляет шаблон-напоминание за день до просмотра.
- Раз в неделю команда разбирает неудачные отправки и несовпавшие номера.
О самих сообщениях читайте в материале работа с лидами в недвижимости через 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 нужен коннектор, который вы контролируете.
Источники
Читайте дальше
Ещё руководстваИнтеграции
Вебхуки WhatsApp: события, безопасность и повторные доставки
Как работают вебхуки WhatsApp: события сообщений и статусов, надёжный обработчик, проверка подписи Meta, повторы, идемпотентность и пропущенные события.
10 мин чтения
Интеграции
Отправка сообщения WhatsApp через API: cURL, Node, Python, PHP
Как отправить сообщение WhatsApp через API: рабочие примеры на cURL, Node.js, Python и PHP для шаблонов и сессионных сообщений, отслеживание статусов и ошибки.
10 мин чтения
WhatsApp
Коды ошибок WhatsApp Cloud API: значения и способы исправления
Частые коды ошибок WhatsApp Cloud API — от 131047 и 131026 до 132001 и 130429: что они значат, как их исправить и когда не нужно повторять отправку.
8 мин чтения
