ВойтиНачать бесплатный пробный период
Meta Tech Provider

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 за минуты, поэтому ваш агент получает официальный доступ, а бизнес сохраняет приложение.

Tech Provider

Что Meta требует от того, кто подключает номер, который остаётся в приложении WhatsApp Business: статус Tech Provider или Solution Partner.

2 videos

App Review просит одно видео отправки сообщения из вашего приложения и одно видео, где ваше приложение создаёт шаблон.

Advanced access

Какие права App Review выдаёт на whatsapp_business_messaging и whatsapp_business_management, обе необходимы, чтобы стать Tech Provider.

October 15, 2026

Когда Meta объявила устаревшими Embedded Signup v2 и v3 и попросила интеграции перейти на v4.

20 msg/s

Фиксированная пропускная способность номера, который используется и в приложении WhatsApp Business, и в Cloud API.

1 hour

Как долго действует размещённая ссылка для подключения, когда платформа подключает номер клиента через 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 днях без активности.

1Business verificationName, address, phone, email and website checked by Meta
2Meta appThe WhatsApp use case and a connected business portfolio
3App ReviewTwo videos, then advanced access to both WhatsApp permissions
4Embedded SignupVersion 4 or later, with WhatsApp Business app onboarding
5Your backendToken exchange, webhooks, routing and monitoring

Какой путь короче?

Подключить номер через провайдера, который уже прошёл этот процесс. В easyCoexistence бизнес запускает Embedded Signup от Meta и сканирует код приложением WhatsApp Business, это занимает около двух минут. Номер присоединяется к Cloud API в собственном Business Portfolio бизнеса, а приложение продолжает работать. Затем агент получает доступ в том виде, который ему понятен: инструменты MCP для ассистента, такого как ChatGPT, Claude, Claude Code или Codex, либо учётные данные номера и вебхуки для вашего кода.

Connect through easyCoexistenceBecome a Tech Provider
Meta app and App ReviewNot needed: the number joins through oursYours to build and pass
Embedded SignupHosted, with the QR scan in the appYou integrate version 4 and host the flow
First number connectedMinutes after signing upAfter verification and review
Webhook trustA secret in your URL, or X-EC-Signature on forwarded messagesYour app secret signs Meta's deliveries
Disconnection alertsEvery number watched 24/7, 14-day rule includedMonitoring you build and run
Who owns the WhatsApp Business AccountThe business, in its own portfolioThe business

Как агент получает учётные данные номера?

Через get_api_credentials или на странице номера в панели управления. Инструмент возвращает базовый URL Graph API, WhatsApp Business Account ID, phone number ID, эндпоинт отправки и, если он есть, собственный токен доступа бизнеса, ограниченный его активами WhatsApp. Если клиентский токен не выдан, токен возвращается как null с пометкой, что переподключение номера из панели выдаёт его, не заменяя рабочий токен. Секрет приложения получать не нужно: Meta подписывает вебхуки секретом приложения easyCoexistence, который никому не передаётся. Инструмент требует активного тарифа, потому что токен умеет отправлять сообщения.

Send a reply with the returned credentials
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 часов после подключения.
Настройка с EasyCoexistence

Агент работает через более 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 на Node.js и Python на номере CoexistenceКод на Node.js и Python для ИИ-агента на номере Coexistence: проверка подписанных событий, пауза при ответе человека, пропуск дублей и проверка окна.Как сообщения WhatsApp доходят до вашего сервера: напрямую или через управляемый режим, и проверка подписиНапрямую: Meta шлёт вебхуки на ваш сервер. Через сервис: автоматизации отвечают, подписанная копия уходит на Forward URL.Разрешены ли AI-чат-боты в WhatsApp в 2026 году? Правило Meta, ЕС и БразилияРаздел 4.7 условий Meta запрещает универсальных AI-ассистентов, а не бизнес с AI для своих клиентов. Даты, ЕС, Италия и решения CADE в Бразилии.Коннектор WhatsApp для Claude: работа с WhatsApp и автоматизация из ClaudeДобавьте WhatsApp в Claude как пользовательский коннектор в Customize > Connectors на тарифах Free и платных, с командами для Claude Code и Codex.Что означает статус Meta Tech Provider и почему это важноЧто означает статус Meta Tech Provider, какие требования он предъявляет и что меняет для клиента.Неофициальные API WhatsApp: из-за чего блокируют номераНеофициальные шлюзы WhatsApp входят как подключённое устройство и нарушают условия Meta. Узнайте о рисках и официальном варианте.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный период

Проверено по состоянию на