Как подключить WhatsApp Business к Claude — отправляйте WhatsApp из Claude через MCP

Q: Что произойдёт, если отправить свободный текст вне 24-часового окна?

Meta возвращает код ошибки `131047` («Re-engagement message»). Используйте `whatsapp_send_template_message`.

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.

Open Cloud

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → WhatsApp Business, вставьте постоянный System User access token + ID WhatsApp Business Account, выпустите MCP API key — готово. Без Docker, без git clone, без локального сервера. Можете пропустить шаги локальной установки ниже и перейти прямо к разделу подключения клиента.

Подключение WhatsApp Business к Claude

WhatsApp Business Cloud API — хостируемый Meta шлюз для программной отправки сообщений WhatsApp: текст, шаблоны, медиа, голосовые сообщения, интерактивные кнопки, геолокация. С AnythingMCP вы управляете всем этим из Claude Desktop, Claude Code или claude.ai на естественном языке. Без SDK для склеивания, без JSON вручную для каждого типа сообщения.

Что вы можете делать

«Отправь 'Ваш заказ отправлен — отслеживание на https://acme.com/t/12345' на +7 905 123 4567.»
«Отправь шаблон order_confirmation (en_US) на +1 555 123 4567, заполни 'John' и 'ORD-9912'.»
«Отправь PDF счёта с https://acme.com/inv/9912.pdf клиенту с подписью 'Invoice 9912'.»
«Перечисли одобренные шаблоны на моём WABA, затем отправь приветственный на итальянском этому новому лиду.»

Предварительные требования

WhatsApp Business Account (WABA) хотя бы с одним верифицированным отправляющим номером.
Постоянный System User access token с правами whatsapp_business_messaging + whatsapp_business_management (временный 24-часовой dev-токен работает для тестирования, но истекает).
AnythingMCP, запущенный локально или на cloud.anythingmcp.com (настройка за 3 минуты).
Claude Desktop, Claude Code или аккаунт claude.ai.

Шаг 1 — Получите учётные данные WhatsApp Business

Откройте https://developers.facebook.com/ → ваше приложение → WhatsApp → API Setup. Запишите WhatsApp Business Account ID (WABA ID).
Перейдите в Meta Business Suite → Business Settings → System Users, создайте System User, назначьте WABA и Сгенерируйте новый токен с правами whatsapp_business_messaging + whatsapp_business_management. Скопируйте его — повторно увидеть не получится.
Убедитесь, что ваш отправляющий номер верифицирован в API Setup (тестовый номер работает сразу; для продакшена добавьте и верифицируйте свой).

Шаг 2 — Установите adapter WhatsApp Business

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 токен
`WHATSAPP_BUSINESS_ACCOUNT_ID`	ваш WABA ID (например, `123456789012345`)

Нажмите Install — adapter теперь в вашем каталоге с 14 инструментами.

Шаг 3 — Найдите ваш phoneNumberId один раз

Попросите Claude вызвать whatsapp_list_phone_numbers (с вашим WABA ID в качестве businessAccountId). Вы получите id каждого отправляющего номера — зафиксируйте это значение, каждый инструмент отправки требует его как phoneNumberId.

Шаг 4 — Добавьте коннектор в Claude (без кода, 4 клика)

Рекомендуемый путь — работает в claude.ai web без правки конфигурационных файлов.

Откройте claude.ai/customize/connectors.
Нажмите "Add custom connector".
Заполните:
- Name: WhatsApp Business
- URL: https://cloud.anythingmcp.com/mcp
- Authentication: Bearer token → вставьте ваш MCP API key (из AnythingMCP → Profile → MCP API Keys → New Key)
Нажмите Connect для авторизации.

Готово. Все 14 инструментов WhatsApp появляются в чате — начинайте писать промпты.

Продвинутое: Claude Desktop / Claude Code (JSON / CLI)

Claude Desktop — отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %AppData%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "whatsapp-business": {
      "url": "https://cloud.anythingmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

Перезапустите Claude Desktop. Инструменты WhatsApp появятся в меню 🔧.

Claude Code — одна CLI-команда:

claude mcp add whatsapp-business \
  --transport http \
  --url https://cloud.anythingmcp.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_API_KEY"

Проверьте с claude mcp list.

Доступные инструменты (14 всего)

Группа	Инструменты
Discovery	`whatsapp_list_phone_numbers`, `whatsapp_list_message_templates`, `whatsapp_get_message_template`
Текст и шаблон	`whatsapp_send_text_message`, `whatsapp_send_template_message`
Медиа (URL или media ID)	`whatsapp_send_image`, `whatsapp_send_audio`, `whatsapp_send_video`, `whatsapp_send_document`
Интерактивные и геолокация	`whatsapp_send_location`, `whatsapp_send_interactive_buttons`
Подтверждения прочтения и профиль	`whatsapp_mark_message_as_read`, `whatsapp_get_business_profile`, `whatsapp_update_business_profile`

24-часовое окно — что должен знать ваш агент

WhatsApp разрешает отправку свободных сообщений (текст, медиа, интерактивные, геолокация) только в течение 24 часов после последнего входящего сообщения пользователя на ваш номер. Вне этого окна разрешены только предварительно одобренные шаблоны — вызывайте whatsapp_send_template_message с именем шаблона и языком.

Поле instructions adapter'а сообщает Claude это правило, поэтому когда вы просите «отправь напоминание этому клиенту» через несколько дней после его последнего ответа, Claude использует whatsapp_send_template_message вместо свободного текста.

Голосовые сообщения

Используйте whatsapp_send_audio с link, указывающим на файл OGG-Opus, размещённый на публичном HTTPS-URL. WhatsApp отображает OGG-Opus как настоящее голосовое сообщение (волна + кнопка воспроизведения). MP3 и AMR также работают, но отображаются как обычные аудиовложения.

FAQ

Работает ли без верифицированного бизнес-номера? Тестовый номер Meta работает для тестирования (отправляет только на номера, добавленные как тестеры). Для продакшен-отправки любому получателю ваш отправляющий номер должен быть верифицирован и зарегистрирован в WABA.

Что произойдёт, если отправить свободный текст вне 24-часового окна? Meta возвращает код ошибки 131047 («Re-engagement message»). Используйте whatsapp_send_template_message.

Может ли adapter получать входящие сообщения? Напрямую — нет. Meta использует webhooks для входящих, а REST-движок AnythingMCP работает только на отправку. Запустите небольшой webhook-приёмник рядом с AnythingMCP и используйте этот коннектор для отправки + whatsapp_mark_message_as_read для подтверждений прочтения.

Работает ли с Claude Code так же, как с Claude Desktop? Да — тот же MCP URL.