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

Создайте бота для WhatsApp с Claude Code или Codex на номере, который остаётся в приложении

Добавьте MCP-сервер WhatsApp в Claude Code или Codex и поручите агенту настройку: он читает учётные данные Cloud API номера, создаёт приёмник вебхука, направляет входящие сообщения в него и отправляет тестовый ответ тому, кто написал за последние 24 часа. В итоге вы получаете собственного агента, который работает как ваш код на вашем сервере.

easyCoexistence подключает номер WhatsApp Business, который остаётся в приложении, к Cloud API Meta через Coexistence и даёт Claude Code и Codex более 30 MCP-инструментов для сборки: учётные данные, маршрутизацию, шаблоны, тестовые отправки и автоматизации.

--scope user

Флаг Claude Code, который загружает сервер во все ваши проекты; локальная область по умолчанию загружает его только там, где он был добавлен.

codex mcp login

Команда Codex, которая сохраняет вход OAuth для сервера; если учётных данных нет, Codex может подключиться без аутентификации.

HTTPS

Что должен использовать прямой адрес вебхука, и он обязан возвращать hub.challenge в GET-проверке Meta.

20 seconds

Время, которое шаг Call my webhook ждёт ответа {"reply"} от вашего эндпоинта, прежде чем шаг завершится ошибкой.

24 hours

Окно обслуживания клиентов длится 24 часа после последнего сообщения пользователя; за его пределами Meta принимает только шаблонные сообщения.

20 msg/s

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

Что нужно кодинг-агенту, чтобы собрать агента WhatsApp?

Четыре вещи. Номер WhatsApp Business, подключённый к Cloud API Meta через Coexistence, чтобы приложение оставалось на телефоне, а код мог отправлять и получать сообщения. Подключение MCP от Claude Code или Codex к этому номеру, которое позволяет агенту читать учётные данные, менять маршрутизацию и отправлять тестовые сообщения без открытия панели управления. Публичный HTTPS-адрес для приёмника на хостинге, куда вы развёртываете код, или туннель на время разработки. И ключ модели для агента, которого вы создаёте.

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

Как добавить инструменты WhatsApp в Claude Code и Codex?

Для каждого нужен один URL в терминале и вход через OAuth, поэтому ключ не попадает ни в один файл. В Claude Code добавьте сервер с --scope user, чтобы он загружался во всех проектах, затем запустите claude, выполните /mcp, выберите easycoexistence и войдите в браузере. В Codex добавьте сервер и выполните codex mcp login, который сохраняет вход; codex mcp list показывает, что настроено. Codex хранит запись в ~/.codex/config.toml, который также читают настольное приложение ChatGPT и расширение Codex для IDE.

Проверьте, что всё работает: попросите то, на что могут ответить только инструменты, например «покажи мои номера WhatsApp». Агент вызовет list_numbers и получит connection_id каждого номера, который принимают все остальные инструменты.

Add the server, then sign in
# Claude Code: then start claude and run /mcp to sign in
claude mcp add --transport http easycoexistence --scope user https://easycoexistence.com/api/mcp

# Codex: add, store the OAuth sign-in, check
codex mcp add easycoexistence --url https://easycoexistence.com/api/mcp
codex mcp login easycoexistence
codex mcp list

Какой маршрут должен построить агент?

Три маршрута доставляют сообщение клиента в ваш код, и различаются они тем, сколько работы остаётся коду. Для первой версии самый короткий шаг Call my webhook: easyCoexistence пропускает дубликаты, уступает, когда вы отвечаете с телефона, и проверяет окно 24 часа до вызова вашего эндпоинта, поэтому коду остаётся только написать ответ. Переходите на Forward URL или на прямой адрес получения, когда агенту нужны все события, а не только сообщения, которые выбрала автоматизация.

Call my webhook stepAn automation POSTs the message and the chat's last 10 messages, signed; return {"reply": "..."} within 20 seconds
Forward URL (Automations on)A signed copy of each Meta event goes to your code; automations keep running; you send through the Graph API
Direct destinationMeta posts straight to your endpoint; easyCoexistence never sees the messages; automations stop for that number

Что стоит попросить у кодинг-агента?

Сразу задайте маршрут, язык и правила и попросите план до написания кода. Скажите, какие вызовы инструментов он может делать сам: чтение учётных данных и документации безопасно, а смена адреса доставки влияет на живой номер. get_docs возвращает документацию easyCoexistence, включая то, как приёмник аутентифицирует доставки, поэтому агент может читать правила, а не угадывать их. Запрос такого вида даёт приёмник, который вы проверите за один присест:

A request for Claude Code or Codex
Build a WhatsApp agent in Node.js for my number +55 11 4000 1234.
1. Call list_numbers, then get_api_credentials for that number.
   Put send_endpoint and access_token in .env, never in code.
2. Scaffold an HTTPS server with POST /wa/<long random path>.
   Verify X-EC-Signature (HMAC-SHA256 of "<t>.<raw body>").
   Skip message ids already handled.
   On smb_message_echoes, stay quiet on that chat for 4 hours.
3. Reply with my model only within 24 hours of the
   customer's last message.
4. Write tests for the signature check and the 24-hour rule.
Do not call set_inbound_mode or set_webhook_destination
until I say so.

Как подключить приёмник и проверить его?

Запустите сервер там, где Meta и easyCoexistence смогут обратиться к нему по HTTPS, затем пусть агент настроит маршрутизацию. Для маршрута Forward URL он вызывает set_inbound_mode с вашим URL для номера с автоматизациями в режиме on; секрет пересылки возвращается один раз, и агент записывает его в ваш .env. Для прямого маршрута эндпоинт сначала должен ответить на GET-проверку Meta, затем агент вызывает set_webhook_destination с URL, длинным случайным секретом в пути и вашим токеном верификации.

Для проверки напишите на бизнес-номер со своего телефона и смотрите логи: приёмник должен увидеть событие, модель должна ответить, а ответ должен появиться в чате. Поскольку вы только что написали, окно 24 часа открыто, поэтому кодинг-агент может также попробовать send_message на ваш номер.

Нужен ли готовому агенту MCP-сервер?

Нет. MCP-сервер является инструментом строителя, вошедшим от вашего имени. Развёрнутый агент отправляет через Graph API Meta, используя send_endpoint и access_token, которые вернул get_api_credentials: это собственный токен бизнеса, ограниченный активами WhatsApp, а получает он сообщения через маршрут, который вы настроили. Если access_token пришёл как null, переподключение номера из панели управления выдаёт новый, не заменяя токен, который уже работает.

MCP-подключение оставьте для работы вокруг агента: создания шаблонов через create_template, проверки get_number_health, когда что-то выглядит неправильно, и чтения журнала запуска любой автоматизации, которая передаёт сообщения вашему коду.

Как настроить

  1. Connect your numberAt easycoexistence.com, run Meta's Embedded Signup and scan the code with the WhatsApp Business app; the app keeps its chats.
  2. Add the server to your coding agentRun the claude mcp add or codex mcp add command, then sign in with /mcp in Claude Code or codex mcp login in Codex.
  3. Ask for credentials and a planHave the agent call list_numbers and get_api_credentials, store the values in .env and propose the receiver before writing it.
  4. Expose the receiver over HTTPSDeploy it, or run a tunnel while developing, and confirm the URL answers from outside your machine.
  5. Route the messagesLet the agent call set_inbound_mode with a Forward URL, or set_webhook_destination for the direct route, once you approve.
  6. Test from your phoneSend the business number a message and check that your agent's reply arrives in the same chat.

Распространённые ошибки

  • Сохранение временного туннеля как прямого адреса получения в первые 24 часа. Одноразовый импорт контактов и до 6 месяцев чатов от Meta уходит на этот URL и теряется при закрытии туннеля.
  • Установка прямого адреса на номере, который работает с автоматизациями. Номер переключается на прямой режим, и его автоматизации останавливаются; используйте Forward URL в автоматизациях в режиме on, чтобы сохранить оба.
  • Коммит .env, который записал агент. Сначала добавьте его в .gitignore, потому что любой, кто знает токен доступа, может писать клиентам от имени бизнеса.
  • Тест send_message контакту, который не писал последние 24 часа. Meta отклоняет свободный текст вне окна, поэтому сначала напишите на номер со своего телефона.
Настройка с EasyCoexistence

Ваш агент затем работает на вашем сервере, а каждый номер находится под круглосуточным мониторингом с оповещениями. От US$ 9 до US$ 0,75 за подключённый номер в месяц, с падением по мере добавления номеров, первые 3 дня в бесплатном пробном периоде.

Часто задаваемые вопросы

Работает ли это в Cursor и других инструментах для программирования?

Да. Любой MCP-клиент, который подключается к удалённым серверам по Streamable HTTP с OAuth, может использовать тот же URL, включая Cursor, VS Code, Gemini CLI и Antigravity. Меняется только формат настройки от клиента к клиенту.

На каком языке должен писать агент?

На любом, который умеет работать с HTTPS и вычислять HMAC-SHA256. Чаще всего выбирают Node.js и Python. Проверенные примеры для обоих, с проверкой подписи, обработкой дубликатов и паузой при ответе с телефона, есть на странице агента Node.js и Python.

Нужно ли мне собственное приложение Meta или App Review?

Нет. Номер подключается к Cloud API через приложение Meta от easyCoexistence и остаётся в собственном Business Portfolio бизнеса. Токен, которым отправляет ваш код, принадлежит бизнесу, поэтому собственное приложение Meta здесь не нужно.

Может ли кодинг-агент создать нужные агенту шаблоны?

Да, через create_template, затем get_template_status, пока Meta не ответит, обычно в течение минут и самое большее около 24 часов. Агенту нужен одобренный шаблон, чтобы начать разговор или написать после закрытия окна 24 часа.

Читайте дальше

ИИ-агент для WhatsApp на Node.js и Python на номере CoexistenceКод на Node.js и Python для ИИ-агента на номере Coexistence: проверка подписанных событий, пауза при ответе человека, пропуск дублей и проверка окна.WhatsApp в любом MCP-клиенте: Gemini CLI, VS Code, Cursor, Devin Desktop (Windsurf) и другиеДобавьте удалённый WhatsApp MCP-сервер в Cursor, VS Code, Gemini CLI, Antigravity, Zed, Cline или Devin: нужный ключ конфигурации и вход через OAuth.Инструменты WhatsApp не появляются в ChatGPT или Claude: исправленияКак вернуть инструменты WhatsApp в ChatGPT, Claude, Claude Code и Codex: вход, переключатель в чате, лимиты тарифа, устаревший список и отказы биллинга.Лучшие способы подключить ИИ к WhatsApp в 2026 годуПять способов подключить ИИ к WhatsApp Business в 2026 году: MCP, ответы ИИ на вашем ключе, вебхуки, своё приложение Meta и неофициальные библиотеки.Как сообщения WhatsApp доходят до вашего сервера: напрямую или через управляемый режим, и проверка подписиНапрямую: Meta шлёт вебхуки на ваш сервер. Через сервис: автоматизации отвечают, подписанная копия уходит на Forward URL.Подключите WhatsApp к Claude Code через MCPОдна команда добавляет EasyCoexistence в Claude Code: агент отправляет сообщения WhatsApp, управляет шаблонами и настраивает вебхуки из терминала.

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

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

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

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