Как подключить WhatsApp Business к KeyCRM: пошаговая инструкция

Вторая вещь, которая ломает бюджеты: с 1 октября 2026 года Украина выходит из регионального прайса Meta на собственный тариф с повышенными ставками, а сервисные сообщения становятся платными уже и на стороне Meta. Точные цифры должны были обнародовать до 1 сентября.

Мы в Brutal Marketing — сертифицированный партнёр Key CRM в Украине, и подключаем этот канал регулярно. Ниже — обе дороги в keyCRM (официальная через Twilio и номерная через сессию), полный порядок действий в обоих кабинетах, ловушки Meta, модерация шаблонов и расчёт бюджета на 1000 диалогов, в котором Twilio, а не CRM, оказывается главной статьёй расходов.

Путаница начинается с названий. Люди говорят «подключили WhatsApp к CRM», имея в виду три разные вещи с разными последствиями.

WhatsApp Business App — бесплатное приложение на телефоне. Одно основное устройство, до четырёх привязанных, ручные ответы, каталог, быстрые ответы. Интеграции с CRM он сам по себе не даёт.

WhatsApp Business Platform (API) — официальный канал Meta для бизнеса. В keyCRM доступ к нему идёт через Twilio как провайдера. Даёт неограниченное количество менеджеров на одном номере, шаблоны, автоматизацию через триггеры, статистику доставки.

Интеграции через сессию — подключение живого номера по QR-коду, как в веб-версии WhatsApp. В keyCRM это отдельный канал «номерной WhatsApp». Быстро и без Twilio, но с другим набором рисков.

Важно для keyCRM: режим сосуществования, когда тот же номер живёт и в приложении, и в API, здесь не работает. Документация keyCRM прямо говорит: если номер уже в бизнес- или личном приложении WhatsApp, аккаунт придётся удалить — это требование Meta. Дальше рекомендуют удалить и само приложение, чтобы не путаться. То есть руководитель, который привык отвечать с телефона, с этим номером этого больше делать не будет.

Именно поэтому в keyCRM мы почти всегда советуем отдельный номер под CRM, а не тот, что уже годами работает на телефоне.

Это главная развилка, и от неё зависит и бюджет, и устойчивость канала.

Дорога первая — официальный WhatsApp Business через Twilio. Вы регистрируете отправителя в Twilio, привязываете его к Meta Business Portfolio, создаёте сервис отправки с вебхуком на keyCRM и добавляете канал типа «WhatsApp Twilio». Это полноценный API: шаблоны, рассылки, неограниченная команда, предсказуемая доставка.

Дорога вторая — номерной WhatsApp. Отдельный тип канала в keyCRM, который работает через авторизованную сессию обычного номера. Twilio не нужен, оплата — по тарифу самого канала.

Вторая дорога дешевле и быстрее, но имеет набор ограничений, которые keyCRM честно выписал в своей базе знаний, и их стоит прочитать до, а не после запуска:

• Групповые чаты не поддерживаются
• Цитирование сообщений не поддерживается
• Реакции на сообщения не поддерживаются
• Редактирование и удаление сообщений не поддерживается
• Объединить с профилем WhatsApp Business на том же номере невозможно — активным может быть только один тип профиля
• Сессия может отвалиться, и канал автоматически выключится
• Удаление канала удаляет все диалоги без возможности восстановления — если нужно остановить канал, его надо деактивировать, а не удалять

Отдельно о риске блокировки. keyCRM перечисляет причины, по которым WhatsApp приостанавливает аккаунты на номерной интеграции: спам и массовые однотипные сообщения, частая инициация диалогов с новыми контактами, использование неофициальных версий приложения, подозрительная активность. Сессия также может оборваться, если активировать интеграцию с эмулятора или подозрительного IP.

Наше правило: номерная дорога — для входящего потока и небольших объёмов. Официальная — как только появляются рассылки или больше двух менеджеров. Если вы планируете писать первыми системно, номерная интеграция рано или поздно закончится блокировкой.

Дальше — детально по официальной дороге.

Половина срывов — это не техническая проблема, а отсутствие доступов. Соберите всё заранее.

1. Платный аккаунт Twilio. Бесплатного пробного не хватит: нужен апгрейд до платной версии и прохождение верификации личности.
2. Meta Business Portfolio — официальная бизнес-страница Facebook. Если нет, создадите во время подключения.
3. Номер телефона, не привязанный ни к одному WhatsApp. Это самый важный пункт. Если номер уже в личном WhatsApp, конвертация означает потерю доступа к мобильному приложению и к истории переписок, которая там хранится. keyCRM прямо рекомендует брать отдельный номер.
4. Юридическое название компании, категория, описание, сайт — для профиля отправителя и верификации бизнеса.
5. Активный аккаунт keyCRM. Тариф единый — около $19 в месяц по факту использования, с любым количеством пользователей. В тариф входят лимиты, в частности 20 000 сообщений в чатах; за каждый следующий блок — доплата около $9.
6. Включённые всплывающие окна в браузере. Мелочь, но авторизация Meta открывается в popup, и закрытый поп-ап посреди процесса означает начать сначала.

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

Работа идёт в двух кабинетах: сначала Twilio, потом keyCRM. Всего 30–50 минут, если доступы готовы.

Шаг 1. Создайте отправителя. В Twilio Console — Messaging → Senders → WhatsApp senders, кнопка «Create new sender».

Шаг 2. Выберите номер. Twilio позволяет взять собственный номер из их пула или ввести номер вашего мобильного оператора. Нажмите «Continue».

Шаг 3. Привяжите WhatsApp Business Account к Twilio кнопкой «Continue with Facebook». Откроется всплывающее окно — не закрывайте его до конца процесса.

Шаг 4. Выберите Meta Business Account из списка или создайте новый через «Create a Business Account».

Шаг 5. Создайте WhatsApp Business Account. Если это ваш первый отправитель в этом аккаунте Twilio — выберите «Create a new WhatsApp Business Account». Если добавляете отправителя к существующему — выберите WABA, созданный ранее именно в Twilio, и дальше «Create a new WhatsApp Business profile».

Шаг 6. Заполните профиль. Здесь четыре поля, и два из них критичны:

• WhatsApp Business Account Name — внутреннее название, клиенты его не видят
• WhatsApp Business Profile Display Name — а вот это клиенты видят в карточке чата, и оно проходит модерацию
• Category — категория бизнеса
• Business Description и Website — описание и сайт

Шаг 7. Подтвердите номер. Кнопка «Add a new number», выбор страны, номер, способ подтверждения «Text message», код из SMS. Учтите: если на номере установлен Viber, код может прийти туда.

Шаг 8. Дожмите «Continue» до закрытия окна. Новый отправитель появится в списке WhatsApp senders.

Шаг 9. Создайте Messaging Service. Раздел Messaging → Services, кнопка «Create Messaging Service». Назовите сервис и в поле назначения выберите «Engage in a discussion».

Шаг 10. Добавьте отправителя. Кнопка «Add senders», тип «WhatsApp Number», «Continue», дальше выберите зарегистрированный на шаге 7 номер.

Шаг 11. Настройте интеграцию — это самый технический шаг. Нажмите «Step 3. Set up integration» и сделайте три вещи:

• Поставьте галочку «Defer to sender's webhook»
• В поле «Callback URL» вставьте https://messaging.keyCRM.app/webhooks/whatsapp_twilio
• Поставьте галочку «Send a webhook», вставьте ту же ссылку и выберите метод HTTP POST

Шаг 12. Сохраните. «Step 4: Add compliance info» → «Complete Messaging Service Setup».

Шаг 13. Создайте канал коммуникации. В keyCRM — «Настройки» → «Коммуникации» → вкладка «Чаты / SMS / Email» → «Добавить новый канал». На вкладке «Общие» заполните:

• Название — произвольное, для внутреннего пользования
• Тип канала — «WhatsApp Twilio»
• Twilio Account SID — из Account Dashboard в Twilio
• Twilio Auth Token — оттуда же
• Телефон — номер зарегистрированного отправителя
• Webhook URL — та же ссылка из настроек сервиса отправки

Шаг 14. Нажмите «Добавить». Канал появится в списке и в разделе чатов.

Шаг 15. Настройте доступы и тест. Распределите доступ пользователей к каналу, задайте дополнительные параметры, потом напишите на рабочий номер с личного и проверьте: появился ли чат, привязался ли к клиенту, сработал ли триггер, пришло ли уведомление.

На шаге выбора WhatsApp Business Account Twilio показывает список аккаунтов из вашего бизнес-портфолио. Не выбирайте WABA, созданный не в Twilio. Если у вас уже есть верифицированный номер WhatsApp, работающий с другим сервисом, его надо именно переносить, а не пытаться подтянуть существующий аккаунт — иначе получите ошибку на этапе добавления номера и начнёте всё сначала.

Название, которое видят клиенты, должно соответствовать названию компании в привязанном Meta Business Portfolio. Не «похоже», а соответствовать. «Продажи 2024», «Менеджер Елена» или название направления вместо названия юрлица — типичная причина отклонения, после которой подключение застревает на несколько дней.

Наша рекомендация проста: берите название компании из портфолио и не импровизируйте.

Лимит 1600 символов на одно сообщение. Для живого диалога это много, для длинных инструкций или условий доставки — может не хватить. Разбивайте на два сообщения или выносите в файл.

Без верификации бизнеса в Meta доступ будет ограниченным. Верификация занимает от нескольких дней до двух недель, поэтому запускайте её параллельно с настройкой, а не после.

Здесь keyCRM жёстче многих других CRM, и лучше знать об этом до старта.

Сценарий 1. Номер в личном WhatsApp. Конвертировать можно, но вы потеряете доступ к мобильному приложению на этом номере и к истории переписок, которая там хранится. keyCRM прямо советует брать отдельный номер. Мы с этим согласны: сохранить можно контакты, договорённости и факты — выгрузите резервную копию чатов и занесите ключевое в CRM. Саму переписку в API не перенести.

Сценарий 2. Номер в WhatsApp Business App. Аккаунт придётся удалить из приложения — это требование Meta. После этого keyCRM рекомендует удалить и само приложение, чтобы избежать ошибок и путаницы. Режима сосуществования здесь нет.

Сценарий 3. Номер уже в WhatsApp Business API другой компании или другого провайдера. Номер можно перенести. Условие — доступ к действующему WABA и отключённая двухфакторная аутентификация на время переноса. И помните про ловушку: под Twilio создавайте новый WhatsApp Business Account, а не подтягивайте старый.

Последняя строка — самая важная. В номерном канале keyCRM удаление канала стирает все диалоги без возможности восстановления. Если вы переходите с номерной интеграции на официальную, старый канал надо именно деактивировать. Мы видели, как эту кнопку нажимали «чтобы не мешал» — и теряли полугодовую переписку с базой.

Главное правило переноса: делайте его в самый тихий час недели. В окне между удалением старого аккаунта и регистрацией номера входящие сообщения не доставляются — они просто исчезают.

Написать клиенту первым — то есть вне открытого окна — можно только утверждённым шаблоном. В официальной дороге keyCRM шаблоны сначала регистрируются в Twilio, и уже потом подтягиваются в CRM. Это отдельный шаг, который легко пропустить и потом удивляться, почему рассылка не идёт.

Три категории, от которых зависит цена:

• Utility — транзакционные: подтверждение заказа, статус доставки, напоминание о визите. Дешёвые.
• Authentication — коды подтверждения и одноразовые пароли. Дешёвые, отдельные правила формата.
• Marketing — всё остальное: акции, скидки, реактивация, анонсы. Самая дорогая категория, скидок за объём не имеет никогда.

Граница между utility и marketing — это намерение. «Ваш заказ №1024 передан в доставку» — utility. «Ваш заказ передан в доставку, а вот промокод на следующий» — уже marketing, в том же предложении.

1. Переменные в начале или в конце текста. {{1}}, приветствуем! — отклонение. Переменная должна быть окружена текстом с обеих сторон.
2. Две переменные подряд. {{1}} {{2}} Meta читает как попытку обойти модерацию.
3. Пустой или непонятный пример значения. Если в примере к {{1}} стоит «текст» — шаблон не пройдёт. Пишите реальное: «Елена», «№1024».
4. Категория не совпадает с содержанием. Заявили utility, а внутри скидка — отклонение или автоматическая перекатегоризация в marketing со сменой тарифа.
5. Обещания и гарантии. «Гарантируем рост продаж на 40%» — стоп-сигнал для модерации.
6. Ошибки и разметка. Лишние символы, нерабочие ссылки, HTML-теги, обрезанный текст.

Пример, который отклонят:
{{1}}, у нас скидка 50%! Только сегодня! Пиши {{2}}

Тот же смысл, который проходит:
Здравствуйте, {{1}}. До 15 августа действует скидка 50% на онлайн-курс «Основы». Чтобы забронировать место, нажмите кнопку ниже. [Кнопка: Забронировать]

Разница не в вежливости, а в структуре: переменная внутри текста, конкретный срок, конкретное действие, никаких каскадов восклицаний.

Модерация обычно занимает от нескольких минут до суток. Подавайте шаблоны пачкой за 2–3 дня до старта кампании, а не в день запуска.

Держите живыми 5–8 базовых шаблонов под повторяющиеся сценарии: реактивация, напоминание о встрече, подтверждение заказа, статус доставки, сбор отзыва. Для e-commerce, под который keyCRM заточен лучше всего, самый дорогой по отдаче шаблон — это не акция, а статус заказа: он снимает нагрузку с менеджеров и при этом тарифицируется как utility.

Механика Meta простая. Клиент написал вам — открылось окно обслуживания на 24 часа. Внутри окна вы пишете в свободной форме, без шаблонов, и Meta за это не берёт денег. Окно перезапускается с каждым новым сообщением клиента. Закрылось — дальше только шаблон и только платно.

Отдельный случай: если клиент пришёл из рекламы Click-to-WhatsApp или с кнопки на странице Facebook, открывается бесплатное окно на 72 часа, в котором не тарифицируются даже шаблоны.

А теперь деталь, специфичная для keyCRM. Twilio берёт свои $0.005 за каждое сообщение — входящее и исходящее, внутри окна и вне его. Для Meta ваш диалог из 15 реплик внутри окна стоит ноль. Для Twilio — $0.075. Умножьте на тысячу диалогов, и вы получите главную строку своего счёта.

Практический вывод, который противоречит всем общим инструкциям по WhatsApp: в связке keyCRM + Twilio длинный диалог — это расход, а не бесплатный бонус. Не «переписывайтесь больше, пока бесплатно», а «доводите до целевого действия за меньшее число реплик». Один точный шаблон с кнопкой выгоднее пяти уточняющих сообщений.

Добавьте к этому $0.001 за каждое сообщение, завершившееся статусом Failed, — на грязной базе это заметная сумма.

Сегодня ответы менеджера внутри окна бесплатны на стороне Meta. С 1 октября 2026 Meta начинает тарифицировать сервисные сообщения по ставке, равной utility-тарифу соответствующего рынка, без скидок за объём. Параллельно с 1 августа 2026 действует отдельная тарификация для Meta Business Agent.

Для пользователей keyCRM это значит, что стоимость диалога внутри окна сложится из двух частей вместо одной: $0.005 Twilio плюс ставка Meta. Точных цифр для Украины нет — их должны были опубликовать до 1 сентября 2026.

Сначала — три факта, которые ломают старые расчёты.

Факт первый. С 1 июля 2025 Meta отказалась от оплаты за 24-часовые разговоры и перешла на оплату за каждое доставленное шаблонное сообщение. Калькуляторы «за диалогами» устарели.

Факт второй. Цена Meta зависит от страны получателя, а не от того, где зарегистрирован ваш бизнес.

Факт третий, самый важный для keyCRM. У вас три счёта, а не один: тариф keyCRM, платформенная комиссия Twilio за каждое сообщение и проходные сборы Meta за шаблоны.

Возьмём типичный месяц: 1000 диалогов, в среднем 8 сообщений в каждом (входящие + исходящие), из них 400 диалогов инициируете вы.

Обратите внимание на пропорцию: комиссия Twilio больше тарифа CRM вдвое и больше всех сборов Meta вчетверо. Это переворачивает привычную логику экономии. В большинстве CRM оптимизируют количество шаблонов. Здесь оптимизировать надо общее количество сообщений в диалоге.

Ставки Meta в таблице — планировочный ориентир для региона Rest of Central & Eastern Europe, к которому пока относится Украина. Прайс пересматривается ежеквартально, а с 1 октября 2026 Украина получает отдельный тариф с повышенными ставками — закладывайте запас.

Сценарий А. Сервисный бизнес, короткие диалоги. 1000 диалогов по 5 сообщений = 5000 сообщений, $25 Twilio. Полный бюджет около $55. Самая дешёвая конфигурация.

Сценарий Б. Консультационные продажи, длинные диалоги. 1000 диалогов по 15 сообщений = 15 000 сообщений, $75 Twilio. Плюс Meta и CRM — около $105. Тот же тысячный поток, но вдвое дороже.

Сценарий В. Интернет-магазин, 4000 диалогов. 32 000 сообщений = $160 Twilio, плюс превышение лимита keyCRM (20 000 в тарифе) — ещё около $9, плюс сборы Meta. Итого около $190–200. Здесь уже имеет смысл считать альтернативных провайдеров без комиссии за сообщение.

Мы не продаём канал и не продаём CRM, которые вам не нужны, поэтому скажем прямо.

Посредник в цепочке. keyCRM не работает с Meta напрямую — между вами два поставщика, два кабинета и два счёта. Это не плохо само по себе, но означает, что при сбое причину придётся искать в трёх местах, а комиссия за сообщение никуда не денется.

Нет режима сосуществования. Номер либо в приложении, либо в API. Для владельца, который привык отвечать с телефона, это ощутимая смена привычки. Решение — отдельный номер под CRM.

Лимит 1600 символов на сообщение.

Номерная дорога имеет реальный риск блокировки. Особенно если писать первыми системно.

Украинская специфика канала. В Украине WhatsApp уступает Telegram и Viber по проникновению среди внутренней аудитории. Если вы продаёте внутри страны, WhatsApp вряд ли станет основным каналом — он станет третьим, после Telegram и Viber, которые в keyCRM подключаются проще и дешевле. Где WhatsApp даёт больше всего: экспорт, продажи на Etsy, eBay и Amazon, туризм и релокация, услуги для диаспоры, B2B с Латинской Америкой, Индией и Ближним Востоком. Для e-commerce, работающего на внешние рынки, — это часто основной канал общения с покупателем.

Оплата. Twilio и Meta списывают средства с карты, поддерживающей международные платежи. Закройте этот вопрос с бухгалтерией до подключения, а не когда канал остановится.

Скорость изменений. За последние полтора года модель тарификации Meta изменилась дважды, и третье изменение уже назначено на октябрь.

Если вы ещё выбираете систему, у нас есть разбор того же подключения в CRM, где интеграция идёт напрямую с Meta без посредника: как подключить WhatsApp Business к Kommo. Там нет комиссии за сообщения, но тариф считается за каждого пользователя — и на команде из 10 человек математика переворачивается в пользу keyCRM.

Мы в Brutal Marketing подберем для вас лучшую программу CRM, которую вы сможете использовать в своем бизнесе. Мы с удовольствием расскажем вам о возможностях программы и покажем, какие настройки точно помогут вам достичь желаемых финансовых результатов.

Мы сертифицированный партнёр Key CRM в Украине и берём на себя всю цепочку: регистрацию и верификацию в Twilio и Meta, выбор между официальной и номерной дорогой под ваш объём, настройку вебхуков, согласование шаблонов и триггеры под вашу воронку.

Заказать внедрение Key CRM с WhatsApp — на бесплатной консультации посчитаем ваш реальный бюджет с комиссией Twilio и скажем честно, нужен ли вам этот канал. Если сначала хотите посмотреть на цифры сами — вот разбор тарифных планов Key CRM.