WhatsApp API для AI-агентов: официальный доступ за минуты, без статуса Tech Provider
AI-агент получает официальный доступ к WhatsApp через Cloud API от Meta, а номер, который остаётся в приложении WhatsApp Business, подключается через Tech Provider или Solution Partner. Стать им можно самостоятельно: пройти верификацию бизнеса, записать видео для App Review и собрать Embedded Signup. Или подключиться через провайдера, который уже им является: номер подключается за минуты, а агент получает инструменты MCP или учётные данные API.
easyCoexistence является независимым Meta Tech Provider: он подключает номер WhatsApp Business к Cloud API через Coexistence за минуты, поэтому ваш агент получает официальный доступ, а бизнес сохраняет приложение.
Что Meta требует от того, кто подключает номер, который остаётся в приложении WhatsApp Business: статус Tech Provider или Solution Partner.
App Review просит одно видео отправки сообщения из вашего приложения и одно видео, где ваше приложение создаёт шаблон.
Какие права App Review выдаёт на whatsapp_business_messaging и whatsapp_business_management, обе необходимы, чтобы стать Tech Provider.
Когда Meta объявила устаревшими Embedded Signup v2 и v3 и попросила интеграции перейти на v4.
Фиксированная пропускная способность номера, который используется и в приложении WhatsApp Business, и в Cloud API.
Как долго действует размещённая ссылка для подключения, когда платформа подключает номер клиента через Partner API.
Что нужно AI-агенту, чтобы официально использовать WhatsApp?
Четыре вещи из Cloud API от Meta. Phone number ID и токен доступа с правом whatsapp_business_messaging, чтобы агент мог вызывать эндпоинт messages. Эндпоинт вебхука, на который Meta доставляет входящие сообщения, а для номера, общего с приложением, ещё smb_message_echoes для ответов, которые человек набирает на телефоне. Одобренные шаблоны, потому что свободный текст доходит только до тех, кто написал за последние 24 часа. И способ узнать, что подключение сломалось: приложение на телефоне продолжает работать, даже когда сторона API остановилась.
Самый быстрый путь, который люди находят первым, это автоматизация WhatsApp Web, которая входит как связанное устройство. Это нарушает условия WhatsApp и ставит номер под угрозу блокировки, что бы ни делал агент поверх.
Что включает путь через Tech Provider?
Последовательность Meta, в таком порядке. Каждый шаг бесплатен, и ни один нельзя ускорить за деньги: проверки идут по графику Meta, а Meta не публикует сроков, поэтому закладывайте недели, а не дни, до подключения номера первого клиента. После этого бэкенд должен продолжать работать: обмен токенов после каждой регистрации, приёмник вебхуков, маршрутизация по номерам и мониторинг отключений, например правило Meta о 14 днях без активности.
Какой путь короче?
Подключить номер через провайдера, который уже прошёл этот процесс. В easyCoexistence бизнес запускает Embedded Signup от Meta и сканирует код приложением WhatsApp Business, это занимает около двух минут. Номер присоединяется к Cloud API в собственном Business Portfolio бизнеса, а приложение продолжает работать. Затем агент получает доступ в том виде, который ему понятен: инструменты MCP для ассистента, такого как ChatGPT, Claude, Claude Code или Codex, либо учётные данные номера и вебхуки для вашего кода.
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
Как агент получает учётные данные номера?
Через get_api_credentials или на странице номера в панели управления. Инструмент возвращает базовый URL Graph API, WhatsApp Business Account ID, phone number ID, эндпоинт отправки и, если он есть, собственный токен доступа бизнеса, ограниченный его активами WhatsApp. Если клиентский токен не выдан, токен возвращается как null с пометкой, что переподключение номера из панели выдаёт его, не заменяя рабочий токен. Секрет приложения получать не нужно: Meta подписывает вебхуки секретом приложения easyCoexistence, который никому не передаётся. Инструмент требует активного тарифа, потому что токен умеет отправлять сообщения.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'Как входящие сообщения доходят до агента?
У каждого номера два режима, переключаются они через set_inbound_mode или на странице номера. Напрямую на ваш сервер: set_webhook_destination направляет Meta прямо на ваш HTTPS-эндпоинт, который должен отвечать на GET-рукопожатие Meta, и easyCoexistence сообщений не видит, поэтому автоматизации отключены. Поскольку Meta подписывает эти доставки секретом нашего приложения, поместите длинный случайный секрет в путь URL и отклоняйте запросы без него.
Автоматизации включены: Meta доставляет сообщения в easyCoexistence, автоматизации могут отвечать, а необязательный «Forward URL» получает исходную полезную нагрузку (payload) Meta под ключом "value". Она подписана заголовком X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 от «<t>.<body>»> с секретом, который показывается один раз. Шаг автоматизации «Call my webhook» также передаёт вашему агенту сообщение и последние 10 сообщений чата, а его ответ отправляется, если ваш ответ имеет вид {"reply": "..."} в течение 20 секунд.
Какие лимиты должен учитывать агент?
Лимиты Meta, и они одинаковы через любого провайдера. Агент, который знает их заранее, избегает сбоев, которые выглядят как баги:
- 20 сообщений в секунду на номер, установлено Meta для номеров, общих с приложением WhatsApp Business.
- Свободный текст только в течение 24 часов после последнего сообщения клиента; после этого только одобренный шаблон.
- Шаблоны отправляются только через API, потому что приложение на номере Coexistence не умеет их отправлять.
- Ответы, которые человек набирает в приложении, приходят как
smb_message_echoes; приостанавливайте агента в этом чате, иначе клиент получит два ответа. - Групповые чаты не синхронизируются с API, поэтому агент работает в личных чатах.
- Контакты и до 6 месяцев личных чатов импортируются один раз, только если прямой адрес вебхука сохранён в течение 24 часов после подключения; у номера с включёнными автоматизациями импорта не будет.
- Голосовые и видеозвонки работают в приложении, но Cloud API не передаёт звонки на номере Coexistence, поэтому агент работает текстом.
Может ли платформа подключать номера собственных клиентов таким способом?
Да, через Partner API. Так SaaS или агентство подключает своих клиентов, не имея собственного статуса Tech Provider. Создайте ключ через create_api_key (он начинается с ec_live_ и показывается один раз), затем вызовите POST /api/v1/connect-sessions с вашего бэкенда или create_connect_link из ассистента, чтобы получить размещённую ссылку, действующую 1 час. Клиент проходит там всплывающее окно Meta и сканирование QR-кода и возвращается на ваш redirect_url с connection_id. Затем GET /api/v1/connections/:id?credentials=1 возвращает собственный токен клиента, а события статуса, такие как connection.disconnected, приходят подписанными заголовком X-EC-Signature. Каждый номер оплачивается с вашего аккаунта по тем же ценовым диапазонам за номер.
Распространённые ошибки
- Проверка X-Hub-Signature-256 на прямом адресе. Meta подписывает секретом приложения easyCoexistence, который никому не передаётся, поэтому подлинные доставки не проходят проверку. Доверяйте длинному случайному секрету в URL или используйте пересылку с X-EC-Signature.
- Приём через узел WhatsApp Trigger в n8n. Он ожидает собственное приложение Meta; вместо него используйте общий узел Webhook с секретом в URL.
- Игнорирование smb_message_echoes. Агент тогда отвечает поверх человека, который уже ответил с телефона, и клиент видит два ответа.
- Сохранение прямого адреса вебхука спустя несколько дней после подключения или номер, оставленный с автоматизациями. Единовременный импорт контактов и до 6 месяцев чатов от Meta требует прямого адреса, сохранённого в течение 24 часов после подключения.
Агент работает через более 30 инструментов MCP или через учётные данные и вебхуки каждого номера, а каждый номер мониторится круглосуточно с оповещениями. От US$ 9 за номер в месяц, до US$ 0,75 по мере добавления номеров; первые 3 дня бесплатно.
Часто задаваемые вопросы
Нужно ли мне собственное приложение Meta?
Нет. Номер подключается через приложение Meta от easyCoexistence и остаётся в собственном Business Portfolio и WhatsApp Business Account бизнеса. Ваш код отправляет сообщения с собственным токеном бизнеса из get_api_credentials, поэтому ваше приложение не задействовано, пока вы сами его не создадите.
Могут ли агент и команда использовать номер одновременно?
Да. Meta синхронизирует сообщения между Cloud API и приложением WhatsApp Business, поэтому отправленное агентом появляется в ветке чата в приложении на телефоне, а то, что команда набирает в приложении, поступает в вашу систему как smb_message_echoes.
Какие фреймворки агентов работают с этим?
Любой клиент, который говорит по MCP через HTTP с OAuth, например ChatGPT, Claude, Claude Code, Codex и Cursor, и любой код, который вызывает Graph API от Meta: Node.js, Python, n8n, LangChain, OpenAI Agents SDK или Vercel AI SDK. Под капотом лежит API самой Meta, поэтому внутри агента ничего проприетарного нет.
Разрешён ли универсальный AI-ассистент в WhatsApp?
Раздел 4.7 Business Solution Terms от Meta запрещает провайдерам универсальных AI-ассистентов предлагать их на платформе WhatsApp Business там, где AI является основной функцией, по определению Meta. Правило действует с 15 января 2026 года. Бизнес, который использует AI для собственных клиентов, для поддержки, продаж или записи, под это правило не попадает, а регуляторы ЕС и Бразилии обязали Meta приостановить или отменить его для сторонних ассистентов.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на