Как подключить WhatsApp Business API из России

Подключить официальный WhatsApp Business API российской компании в 2026 году можно только после отдельной проверки аккаунта, платежей, закона и фактической доступности канала. В правилах Meta нет найденного общего запрета на российское юрлицо или номер +7, но это не гарантирует регистрацию из РФ: WhatsApp заблокирован на уровне российских сетей, интерфейсы Meta и иностранный биллинг могут быть недоступны. Безопасный вариант — прямой Cloud API с собственным Business Portfolio либо российский агрегатор с прозрачным официальным WABA и рублевым договором. Если подключение требует скрыть страну, использовать чужие документы, платежи или обычный WhatsApp Web по QR вместо WABA, запуск нужно остановить.

Что именно нужно подключать

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

Обычное приложение WhatsApp Business

Это бесплатное мобильное приложение для небольшой компании. В нем есть профиль, каталог, быстрые ответы и метки. Оно подходит владельцу или малой команде, но само по себе не дает серверный API для CRM, очередей операторов и надежных автоматических уведомлений.

Некоторые сервисы подключают это приложение к CRM как связанное устройство WhatsApp Web. Номер авторизуют обычным QR-кодом, а сервис имитирует работу браузера. Такое подключение не становится официальным API из-за наличия REST-методов или слова «Business» в тарифе.

Официальный Meta Cloud API

Cloud API — облачная часть WhatsApp Business Platform. Meta хранит и обслуживает транспорт сообщений, а компания или ее подрядчик разрабатывает операторское окно, бота, связь с CRM и обработчик webhook-событий.

У официального канала есть проверяемые активы:

• Business Portfolio компании;
• WhatsApp Business Account, или WABA;
• идентификатор бизнес-номера Phone Number ID;
• шаблоны со статусами модерации и качества;
• приложение или партнерское решение с разрешениями Meta;
• события о входящих сообщениях, доставке, качестве и ограничениях.

Эти активы должны быть видны владельцу бизнеса в WhatsApp Manager. Один лишь API-ключ от посредника этого не доказывает.

Solution Partner, Tech Provider и агрегатор

Solution Partner — современное название роли, которую часто продолжают называть BSP, Business Solution Provider. Такой партнер может проводить Embedded Signup, давать бизнесу свою кредитную линию Meta и эскалировать инциденты.

Tech Provider предоставляет программный продукт и получает разрешения на работу с активами клиента. Он может работать вместе с Solution Partner либо оставить оплату сообщений на стороне клиента. Поэтому фраза «официальный провайдер» не отвечает на главные вопросы: кто держит кредитную линию, кому принадлежит WABA, кто хранит переписку и кто отвечает за обращение в Meta.

Российский омниканальный агрегатор добавляет операторское окно, CRM-интеграции, ботов, аналитику, договор в рублях и закрывающие документы. Его официальный канал может идти через прямой Cloud API, 360dialog, Gupshup или другую партнерскую цепочку. Эту цепочку нужно зафиксировать в заказе.

Неофициальный WhatsApp Web-шлюз

У такого шлюза обычно нет WABA, Phone Number ID и модерации шаблонов. Он просит отсканировать QR как для связанного устройства и обещает писать кому угодно без правил Meta. Результат — разлогины, потеря истории, ограничения или бан номера без нормальной партнерской эскалации.

QR-код не всегда означает серую схему. Официальный режим Coexistence тоже может использовать вход через приложение. Проверяйте результат: в официальном потоке появляются WABA, бизнес-номер, партнерское решение и Cloud API webhooks. Если этих активов нет, это не WABA.

Можно ли подключить Cloud API российской компании

На 4 сентября 2026 года ответ состоит из двух частей.

Со стороны WhatsApp российский рынок не исключен целиком. В официальной таблице цен и правил Meta есть отдельные ставки для России. Россия также добавлена в географию Coexistence, а русскоязычные документы принимаются при бизнес-верификации. Это позволяет рассматривать российское юрлицо и номер +7, но не дает автоматического права на любой аккаунт, платежный способ или функцию.

Со стороны РФ канал нельзя считать стабильно доступным. В феврале 2026 года российские власти объявили о блокировке WhatsApp, а сервис сообщил о попытке полной блокировки; это подтверждали Reuters и другие международные источники. Даже если серверный запрос Cloud API проходит, клиент в российской мобильной или домашней сети может не получить или не открыть сообщение.

Решение 2022 года о признании деятельности Meta экстремистской не распространялось на WhatsApp. Сетевая блокировка 2026 года и специальные запреты для отраслей — отдельные ограничения. С 1 июня 2025 года банкам, некредитным финансовым организациям, операторам связи, владельцам маркетплейсов, госорганам и другим перечисленным субъектам запрещено информировать граждан и общаться с ними через иностранные мессенджеры; норму разъясняла Государственная Дума.

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

Сравнение способов и провайдеров

Цены ниже — публичный снимок на 04.09.2026, а не оферта. До оплаты нужен письменный расчет именно для официального WABA, с актуальной тарификацией Meta за каждое доставленное сообщение.

Путь	Реальная модель	Публичная базовая цена	Кому подходит	Что проверить до оплаты
Прямой Meta Cloud API	официальный API; WABA, приложение, биллинг и webhooks контролирует бизнес	отдельной абонплаты Meta за API не заявлено; оплачиваются сообщения	продуктовая команда с разработчиками и собственным операторским интерфейсом	доступность Meta UI, KYC и платежа для реальных данных компании; поддерживаемая валюта; legal review
360dialog	Solution Partner/BSP, Embedded Signup, кредитная линия, прямой Cloud API	от €49 за номер в месяц + сборы Meta	разработчики и SaaS, которым нужен официальный upstream и API без операторской CRM	принимает ли партнер российское юрлицо и способ оплаты; договор, страны обработки, тариф поддержки. На Regular заявлен первый ответ менее чем за 4 часа, но срок решения не гарантирован
1MSG	Tech/API-слой с собственным WABA и Bring Your Own WABA; публичный SDK проксирует Meta/360dialog-операции	3 045 ₽ за номер в месяц для API; 4 900 ₽ за полный набор; сообщения отдельно	компании, которым нужны рублевый договор, API, webchat или готовые интеграции	Solution ID и upstream, владение WABA, текущая наценка. На сайте осталась старая терминология «диалоговых сессий», поэтому нужен новый расчет за сообщение
RetailCRM	CRM-модуль, официальный WABA идет через 360dialog	3 000 ₽ за канал в месяц + тариф RetailCRM + сообщения	e-commerce, уже работающий в RetailCRM	полный TCO с лицензией CRM; право на перенос WABA; рублевые ставки провайдера и их дата
Chat2Desk	омниканальный чат-центр; поддерживает Gupshup, 360dialog и прямой Meta Cloud API	на продуктовой странице 8 000 ₽ за первый номер, 7 000 ₽ за последующие; депозит от 5 000 ₽	поддержка с очередями, ботами, аналитикой и несколькими каналами	какой upstream включен в заказ; кто выставляет Meta fees. Основная страница еще описывает оплату за сессии, поэтому устный прайс недостаточен
Wazzup	отдельный официальный WABA-канал и отдельная обычная WhatsApp-интеграция; CRM-интерфейс	6 000 ₽/месяц, 5 400 ₽ при оплате на полгода, 4 800 ₽ при оплате на год + сообщения	продажи из amoCRM, Битрикс24 и других CRM	не перепутать WABA с QR-каналом; upstream/Solution ID, владение активами. Инструкция предлагает пользователям из РФ смену IP — этот шаг не следует использовать как обход блокировки
GREEN-API: WABA	отдельный шаблонный WABA-продукт; у компании также есть обычный QR-шлюз	калькулятор WABA показывает $100/месяц + сообщения; заявлена оплата в рублях, тенге и долларах	разработчики, которым подходит API и российский договор	WABA ID, Phone Number ID, партнерская роль и upstream. Тариф 690 ₽ на главной относится к обычному шлюзу, а не к WABA

Если бизнес уже пользуется одной из этих CRM, встроенный официальный модуль часто проще отдельного BSP. Если нужна собственная платформа или SaaS для многих клиентов, важнее прямой API, переносимость WABA, webhook-контракт и партнерская поддержка. Для отдела поддержки без команды разработки приоритетны операторские очереди, роли, аналитика и SLA, а не минимальная цена номера.

Как выбрать поставщика без маркетинговых ловушек

Попросите ответить письменно на один набор вопросов. Сравнивать ответы удобно до демо и счета.

• Кто является Solution Partner, кто Tech Provider, а кто операторским интерфейсом?
• Какой Solution ID и партнерское решение появятся в Business Portfolio?
• WABA создается в портфолио заказчика или в аккаунте посредника?
• Получит ли заказчик WABA ID, Phone Number ID и доступ к WhatsApp Manager?
• Кто платит Meta: сам заказчик или партнерская кредитная линия?
• Из чего состоит наценка: процент, фиксированная ставка, курс, НДС, депозит?
• Есть ли прямой API и webhooks, или только работа в кабинете?
• Какие CRM входят в цену, а какие требуют отдельной лицензии?
• Где хранятся сообщения, медиа, webhook-логи и резервные копии? Какие есть субпроцессоры?
• Как перенести номер и WABA к другому подрядчику? Есть ли плата и простой?
• Что означает SLA: доступность платформы, время первого ответа или срок восстановления?
• Кто открывает обращение в Meta при блокировке шаблона, номера или портфолио?

Красные флаги — обещание «никогда не будет банов», рассылка по холодной базе, отсутствие WABA в портфолио заказчика, секретный upstream, тариф «безлимит» без сборов Meta и отказ назвать страны обработки данных.

Что подготовить до регистрации

Юридический и операционный допуск

Назначьте владельца канала и ответственного за персональные данные. Проверьте отраслевые запреты, рекламное согласие, локализацию базы, трансграничную передачу и договоры поручения обработки. WhatsApp не должен быть единственным способом поддержки, восстановления доступа, получения кода или критичного уведомления для клиента в РФ.

Опишите резервный маршрут: MAX, SMS, email, телефон, личный кабинет или другой доступный канал. На сайте и в приложении покажите его рядом с WhatsApp.

Business Portfolio и документы

Подготовьте:

• юридическое название точно как в регистрационных документах;
• адрес и рабочий телефон;
• публичный сайт на собственном домене с HTTPS;
• страницу контактов и понятное описание бизнеса;
• политику обработки персональных данных и механизм отказа от сообщений;
• корпоративный email на домене;
• документы, подтверждающие название, адрес или телефон;
• минимум двух администраторов с двухфакторной аутентификацией.

Business verification подтверждает компанию, но не выдает автоматически синюю или зеленую отметку. Значок Official Business Account рассматривается отдельно и не нужен для запуска API.

Номер

Номер должен принимать международное SMS или голосовой код. Подойдет мобильный, городской или виртуальный номер, если проверочный вызов проходит напрямую. На время голосовой проверки автоматическое меню может мешать.

До любых действий зафиксируйте текущее состояние номера:

• номер нигде не используется;
• зарегистрирован в обычном WhatsApp;
• зарегистрирован в WhatsApp Business app;
• уже подключен к другому WABA или BSP.

Не удаляйте приложение и аккаунт заранее. Для свежего номера, миграции и Coexistence нужны разные потоки. Ошибочный выбор может создать простой или усложнить возврат.

Согласия и шаблоны

Meta требует, чтобы человек передал свой номер и согласился получать сообщения от конкретной компании. Форма должна называть компанию и цель коммуникации. Для России дополнительно учитывайте требования к рекламе и персональным данным.

Храните доказательство: текст согласия и его версию, дату, источник, номер, категории сообщений и событие отписки. Отказ должен сразу попадать в единый suppression list, которым пользуются CRM, бот и массовые кампании.

Подготовьте минимальный набор шаблонов:

• подтверждение заказа или заявки — utility;
• изменение доставки или записи — utility;
• одноразовый код — authentication;
• акция или персональное предложение — marketing;
• понятная команда отказа и ответ на нее.

Если в utility-шаблон добавить рекламу, Meta может переклассифицировать его в marketing. Закладывайте в бюджет фактическую категорию, а не желаемую.

Пошаговое подключение без отправки форм

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

1. Зафиксируйте бизнес-сценарии: поддержка, уведомления, аутентификация, маркетинг, число операторов, страны получателей и ожидаемый объем доставленных сообщений.
2. Получите письменный legal go/no-go для отрасли, 152-ФЗ, рекламы и трансграничной передачи. Если канал запрещен вашему типу организации или целевому сообщению, остановитесь.
3. Проверьте доступность WhatsApp у целевой аудитории в реальных российских сетях и подготовьте резервный канал. Тест должен быть отдельным согласованным этапом после подключения, а не рассылкой по базе.
4. Выберите прямой Cloud API или связку агрегатор — Tech Provider — Solution Partner. Запросите схему ролей, договор, DPA, тариф, курс, налоги и процедуру переноса.
5. Подготовьте Business Portfolio, сайт, корпоративный email, администраторов и документы. Не вводите сведения, которые отличаются от реального юрлица.
6. Проверьте номер и выберите поток: новый номер, миграция существующего WABA либо Coexistence для активного WhatsApp Business app.
7. Откройте официальный Embedded Signup Meta из кабинета выбранного партнера или настройте собственное приложение для прямого Cloud API. До отправки проверьте, какое бизнес-портфолио, WABA, номер, партнерское решение и кредитная линия будут связаны.
8. Убедитесь, что WABA и бизнес-номер появились у заказчика в WhatsApp Manager. Сохраните WABA ID и Phone Number ID. Если провайдер показывает только свой внутренний «instance ID», приемку не продолжайте.
9. Настройте двухэтапный PIN бизнес-номера, роли с минимальными правами и секреты. Токены храните в менеджере секретов, не в CRM-полях и таблицах.
10. Подключите webhook-адрес, проверьте подпись событий, статусы отправлено/доставлено/прочитано/ошибка, повторную доставку и дедупликацию.
11. Отправьте подготовленные шаблоны на модерацию только после утверждения текстов юристом и владельцем процесса. На этом этапе статьи формы и шаблоны фактически не отправлялись.
12. Проведите ограниченный пилот на сотрудниках и добровольных тестовых клиентах. Проверьте входящее сообщение, ответ в 24-часовом окне, один utility-шаблон, отписку, резервный канал и отражение статусов в CRM.
13. Запускайте объем постепенно. Контролируйте качество шаблонов, жалобы, лимит портфолио, стоимость доставки и доступность по российским сетям.

Как сохранить действующий WhatsApp Business через Coexistence

Coexistence позволяет одному номеру одновременно работать в приложении WhatsApp Business и Cloud API. Сообщения из API отображаются в приложении, а отправленные из приложения могут приходить в API как echo-события. Историю можно синхронизировать, если это поддерживает конкретный поток.

У режима есть ограничения:

• доступность определяется Meta для конкретного аккаунта; новый или проблемный аккаунт может не пройти eligibility;
• провайдер должен поддерживать официальный Coexistence onboarding;
• подключенные устройства могут быть отвязаны, после чего совместимые устройства подключают заново;
• приложение нельзя удалять; его нужно периодически открывать, у ряда провайдеров указан интервал не реже одного раза в 13 дней;
• сообщения из приложения остаются бесплатными, а сообщения Cloud API тарифицируются по правилам платформы;
• Coexistence-номер может иметь ограничения на перенос между WABA;
• значок в приложении не обязательно переносится в API-профиль.

Не принимайте старую инструкцию «сначала удалите WhatsApp Business» как универсальную. Сначала партнер проверяет eligibility Coexistence и объясняет откат. Если этот путь недоступен, согласуйте окно миграции, экспорт нужной истории, переключение webhook и CRM, а также резервную линию поддержки.

Шаблоны, окно 24 часа, качество и лимиты

Когда клиент пишет компании, открывается 24-часовое окно обслуживания с момента его последнего сообщения. До 30 сентября 2026 года внутри окна бесплатны обычные нешаблонные ответы и utility-шаблоны. Маркетинговые шаблоны платны даже в открытом окне. После закрытия окна бизнес может написать только одобренным шаблоном.

Meta оценивает шаблоны по использованию, жалобам, блокировкам, прочтению и вовлеченности. У шаблона бывает состояние качества UNKNOWN, GREEN, YELLOW или RED. Низкокачественный шаблон сначала могут приостановить на три часа, при повторе — на шесть часов, затем отключить. Систематические проблемы затрагивают номер и WABA.

Лимит считается на уровне всего Business Portfolio, а не отдельно для каждого номера. Новый портфель обычно начинает с 250 уникальных получателей бизнес-инициированных сообщений за скользящие 24 часа. Верификация компании, partner-led verification или успешный качественный объем могут поднять лимит до 2 000. Дальше доступны автоматические уровни 10 000, 100 000 и Unlimited. Для роста Meta учитывает качество всех номеров и шаблонов и использование как минимум половины текущего лимита за семь дней.

Высокая пропускная способность API не отменяет лимит аудитории. Даже если канал технически отправляет до 80 сообщений в секунду, портфель не получает право мгновенно написать всей базе.

API, webhooks и CRM: что проверить разработчику

Операторский интерфейс — только верхний слой. Надежность определяется обработкой событий и владельцами данных.

• Принимайте webhook только по HTTPS и проверяйте подпись выбранного API.
• Сохраняйте идентификатор WhatsApp-сообщения и делайте обработку идемпотентной: одно событие может прийти повторно.
• Разделяйте статусы accepted, sent, delivered, read и failed. HTTP 200 при отправке еще не означает доставку и списание.
• Не используйте телефон как единственный первичный ключ клиента. WhatsApp развивает внутренние идентификаторы и usernames; храните WhatsApp user ID и таблицу соответствий.
• Создайте очередь исходящих сообщений, ограничение скорости, экспоненциальные повторы и dead-letter queue для неисправимых ошибок.
• Не повторяйте маркетинговое сообщение автоматически после неизвестного результата: сначала сверяйте webhook и историю, иначе возможны дубль и двойная оплата.
• Подпишитесь на изменение статуса шаблона, качества номера, capability/limit и account update, а не только на входящие сообщения.
• Разведите секреты production и sandbox, включите ротацию токенов и журнал действий администраторов.
• Передавайте в поддержку минимальный набор данных. Полные токены, переписку и персональные данные нельзя отправлять в обычный чат поддержки без основания и защищенного канала.
• Сделайте мониторинг задержки webhook, доли ошибок, доставляемости, жалоб, отписок, расхода и остатка кредитной линии.

В SLA отдельно фиксируют доступность агрегатора, время первого человеческого ответа, время эскалации в Meta и целевой срок восстановления. Фраза «поддержка 24/7» не обещает устранение сбоя за час.

Где хранятся данные и что делать с 152-ФЗ

Cloud API работает в дата-центрах Meta. Сообщение между пользователем и Cloud API шифруется, но Cloud API расшифровывает его, чтобы передать бизнесу, и управляет ключами от имени бизнеса. При стандартной конфигурации Meta может хранить сообщения до 30 дней для работы сервиса и повторной доставки.

Поэтому схему нужно оценивать целиком:

клиент → WhatsApp → Meta Cloud API → BSP → агрегатор → webhook → CRM → аналитика и резервные копии.

Для данных граждан РФ база первичного сбора должна выполнять требования локализации части 5 статьи 18 закона № 152-ФЗ. Передача Meta, иностранному BSP или зарубежной поддержке может быть трансграничной передачей по статье 12. До запуска оператор определяет правовое основание, страны и получателей, получает сведения о защите данных и при необходимости направляет отдельное уведомление Роскомнадзору. Для страны вне перечня адекватной защиты действует период ожидания, если нет законного исключения.

Meta предлагает Local Storage и No Storage, но они не превращают архитектуру автоматически в российскую. При Local Storage данные во время обработки могут находиться в международных дата-центрах до часа. No Storage сокращает хранение контента примерно до часа, зато сокращает окно повторной доставки webhook и медиа: при долгом падении endpoint событие можно потерять.

До договора зафиксируйте:

• роль каждого участника как оператора или обработчика;
• страны и субпроцессоров;
• сроки хранения сообщений, медиа, логов и резервных копий;
• удаление после расторжения и перенос WABA;
• доступ сотрудников поддержки;
• уведомление об инциденте;
• порядок исполнения запроса клиента на доступ или удаление данных.

Надпись «серверы в России» у агрегатора подтверждает только его часть системы. Meta, upstream BSP, техническая поддержка и резервные копии могут оставаться за рубежом.

Как посчитать полную стоимость

Месячная стоимость складывается так:

сборы Meta + наценка/курс/налоги BSP + плата за номер + CRM и места операторов + интеграция и сопровождение + комплаенс и резервный канал.

Meta берет деньги за доставленные сообщения, а не за HTTP-запросы и не за «открытие диалога». С 1 июля 2026 года для получателя с российским кодом действуют ставки в долларах:

Категория	Ставка за доставленное сообщение до 30.09.2026
Marketing	$0.0802
Utility вне 24-часового окна	$0.0400
Authentication	$0.0400
Нешаблонный service-ответ в открытом окне	$0
Utility в открытом окне	$0

Пример для одного номера:

• 5 000 marketing: 5 000 × $0.0802 = $401;
• 8 000 utility вне окна: 8 000 × $0.0400 = $320;
• 6 000 обычных ответов внутри окна: $0;
• сборы Meta: $721.

Официальный курс Банка России на 04.09.2026 — 86,8872 ₽ за доллар. База Meta в примере равна 62 645,67 ₽. Если письменный тариф 1MSG подтвердит 7% наценки, добавится 4 385,20 ₽; API-подписка — 3 045 ₽. Если разработка за 60 000 ₽ амортизируется за год, это еще 5 000 ₽ в месяц. Итого получится около 75 075,87 ₽ без лицензий CRM, мест операторов и дополнительных услуг.

Этот расчет нельзя переносить на другого поставщика. RetailCRM публикует собственные рублевые ставки, 360dialog заявляет нулевую наценку на Meta fees, а у омниканальных платформ часть стоимости спрятана в общем тарифе или депозите.

Важное изменение с октября 2026 года

С 1 октября 2026 года Meta объявила платными service-сообщения и utility-шаблоны внутри 24-часового окна. Для service вводится 1 000 бесплатных сообщений на бизнес-номер в месяц, остальные тарифицируются по ставке рынка. Сентябрьскую смету нужно пересчитать непосредственно перед запуском и обновить правила CRM, которые сейчас считают ответы бесплатными.

Когда нужно остановить подключение

Не продолжайте регистрацию или оплату, если выполняется хотя бы одно условие:

• отраслевой запрет или заключение юриста не разрешает сценарий;
• Meta или партнер не принимает реальную страну, документы, Business Portfolio или платежный способ;
• подрядчик предлагает номинала, чужую компанию, чужую карту или сокрытие страны;
• WABA создается в портфолио подрядчика без доступа и права переноса заказчика;
• вместо WABA дают только QR-инстанс и не показывают WABA ID, Phone Number ID и партнерское решение;
• партнер не раскрывает upstream и страны обработки;
• цена все еще считается «за диалог», а актуального помодельного расчета за доставленные сообщения нет;
• нет доказуемых opt-in и общего списка отписок;
• целевая аудитория в российских сетях не получает сообщения стабильно;
• нет резервного канала для критичных обращений.

Остановка в этих случаях — часть нормального запуска. Она защищает номер, данные клиентов и бизнес-процесс от зависимости, которую трудно быстро заменить.

Как принять результат подключения

До промышленного трафика проведите read-back:

• WABA и номер видны в портфолио заказчика;
• администраторы и двухфакторная защита настроены;
• название и номер имеют ожидаемые статусы;
• платежная сторона и кредитная линия совпадают с договором;
• входящий webhook приходит один раз в CRM после дедупликации;
• статус доставки меняется по реальным событиям;
• обычный ответ проходит только в открытом окне;
• за пределами окна отправляется только одобренный шаблон;
• команда видит качество, лимит и расходы;
• отписка блокирует дальнейшую кампанию во всех системах;
• резервный канал опубликован и работает;
• прописан перенос WABA и выгрузка данных при расторжении.

После пилота сохраните конфигурацию, версии шаблонов, схему данных и контакты эскалации. Это позволит сменить интерфейс или BSP без потери контроля над номером.