No install? Use cloud.anythingmcp.com directly.
Sign in, install the WhatsApp Business Cloud API in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → WhatsApp Business, вставьте постоянный System User access token + ID WhatsApp Business Account, выпустите MCP API key — готово. Без Docker, без
git clone, без локального сервера. Можете пропустить шаги локальной установки ниже и перейти прямо к разделу подключения клиента.
WhatsApp Business в Model Context Protocol
WhatsApp Business Cloud API — официальный хостируемый шлюз Meta для программной отправки сообщений WhatsApp: текст, предварительно одобренные шаблоны, медиа, метки геолокации, интерактивные кнопочные потоки и управление бизнес-профилем. AnythingMCP оборачивает его как MCP-сервер, чтобы любой агент — Claude, ChatGPT, Copilot, ваш собственный — управлял им на естественном языке.
WhatsApp adapter встроен. Нет SDK для поддержки и нет клиентского кода для написания: движок обрабатывает Bearer-аутентификацию и формирует запросы, точно соответствующие схеме Meta messaging_product=whatsapp для каждого типа сообщения.
Почему WhatsApp неудобен без AnythingMCP
| Шаг | Что требует WhatsApp Cloud API |
|---|---|
| 1 | Сгенерировать постоянный System User access token в Meta Business Suite (≠ временный 24-часовой dev-токен) с правами whatsapp_business_messaging + whatsapp_business_management |
| 2 | Найти phoneNumberId каждого отправляющего номера в вашем WhatsApp Business Account (WABA) |
| 3 | Собрать правильное JSON-тело для каждого типа сообщения — text/template/image/audio/video/document/location/interactive — каждый со своей схемой и особенностями расположения полей |
| 4 | Оставаться на поддерживаемой версии Graph API (v15 закрыта, v20 истекает в сентябре 2026; adapter использует v22.0) |
| 5 | Соблюдать 24-часовое окно клиентского сервиса — вне его можно отправлять только предварительно одобренные шаблоны |
Всё это — профиль аутентификации BEARER_TOKEN + 14 инструментов message-shape, объявленные один раз в JSON-спеке adapter'а. Никакого клиентского кода для поддержки.
Установка
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
Откройте http://localhost:3000/connectors/store, выберите WhatsApp Business и введите:
| Поле | Значение |
|---|---|
WHATSAPP_ACCESS_TOKEN | постоянный System User access token |
WHATSAPP_BUSINESS_ACCOUNT_ID | ваш WABA ID (например, 123456789012345) |
Выпустите MCP API key в Profile → MCP API Keys и направьте агента на http://localhost:4000/mcp.
Доступные инструменты (14)
| Инструмент | Что делает |
|---|---|
whatsapp_list_phone_numbers | Находит phoneNumberId каждого номера в вашем WABA |
whatsapp_list_message_templates | Список одобренных шаблонов с их компонентами |
whatsapp_get_message_template | Получает один шаблон по ID |
whatsapp_send_text_message | Отправляет свободный текст (только в 24-часовом окне) |
whatsapp_send_template_message | Отправляет предварительно одобренный шаблон (всегда разрешено) |
whatsapp_send_image | Отправляет JPG/PNG по публичному URL или media ID |
whatsapp_send_audio | Отправляет аудиофайл — OGG-Opus отображается как настоящее голосовое сообщение |
whatsapp_send_video | Отправляет видео MP4/3GPP |
whatsapp_send_document | Отправляет PDF/DOC/XLS с опциональным именем файла |
whatsapp_send_location | Отправляет геолокацию |
whatsapp_send_interactive_buttons | Отправляет 1–3 кнопки ответа |
whatsapp_mark_message_as_read | Отправляет подтверждение прочтения (двойная синяя галочка) |
whatsapp_get_business_profile | Читает публичный бизнес-профиль |
whatsapp_update_business_profile | Обновляет about/адрес/email/сайты |
24-часовое окно, объяснение
WhatsApp применяет окно клиентского сервиса: свободные сообщения (текст, медиа, интерактивные, геолокация) разрешены только в течение 24 часов после последнего входящего сообщения пользователя на ваш номер. Вне этого окна разрешены только предварительно одобренные шаблоны — вы создаёте их в Meta Business Suite, ждёте одобрения, затем вызываете whatsapp_send_template_message с именем шаблона и кодом языка.
Adapter не отслеживает окно за вас. Он просто вызывает API; Meta возвращает ошибку 131047 «Re-engagement message», если вы пытаетесь отправить свободный текст вне окна. Поле instructions adapter'а объясняет это правило, чтобы агент знал, когда переходить к шаблону.
Медиа — URL vs загрузка
WhatsApp принимает медиа двумя способами: сначала загрузить бинарный файл на /PHONE_NUMBER_ID/media, чтобы получить media_id, или передать публичный HTTPS link. AnythingMCP рекомендует путь link, потому что REST-движок не оркестрирует танец multipart upload + send в одном вызове инструмента. Разместите файл на CDN или bucket с подписанным URL и передайте URL в whatsapp_send_image / audio / video / document. Поле mediaId доступно как выход, если вы загружаете файл заранее в другом месте.
Входящие сообщения — вне области применения
Этот коннектор работает только на отправку. WhatsApp доставляет входящие сообщения через webhook, который нужно хостить самостоятельно, а текущая архитектура AnythingMCP — request/response. Если вам нужен чат-бот, отвечающий на сообщения пользователей, запустите небольшой webhook-приёмник рядом с AnythingMCP и используйте этот коннектор для отправки (плюс whatsapp_mark_message_as_read для подтверждений прочтения).