WhatsApp*WhatsApp*

API и MCP для WhatsApp*

Свободный текст исходящих без утверждённых шаблонов и очереди на модерацию.

01

Отличие от Business API

WhatsApp Business API допускает исходящие вне сессионного окна только шаблонами, утверждёнными заранее; изменение текста требует повторной модерации. 1-чат работает через пользовательский аккаунт, поэтому send_message принимает произвольный текст — тот, который агент сформулировал под конкретный запрос.

02

Вложения

send_media принимает публичную ссылку либо base64, до 25 МБ на файл: изображения, PDF, документы, аудио. Входящие вложения доступны через download_media — ссылка живёт час. Голосовые расшифровываются через transcribe_voice.

03

Лимиты канала

WhatsApp* строже прочих каналов относится к автоматизации, поэтому для аккаунтов младше 7 дней лимит первых сообщений снижен и растёт постепенно. При превышении возвращается 429 с Retry-After. Рассылки по приобретённым базам условиями использования не допускаются.

send_media · whatsapp
{
  "tool": "send_media",
  "arguments": {
    "channel": "whatsapp",
    "to": "+79991234567",
    "url": "https://files.example.com/smeta-2026.pdf",
    "caption": "Смета по объекту на Ленина, 12"
  }
}

Инструменты

start_chat(channel: Channel, to: string, text: string)Chat
Первое сообщение контакту, с которым переписки не было. to — телефон в E.164 или юзернейм.
send_message(chat_id: string, text: string, reply_to?: string)Message
Отправка в существующий диалог. reply_to делает сообщение ответом на конкретное входящее.
send_media(chat_id: string, url?: string, base64?: string, caption?: string)Message
Изображение, документ или аудио. Источник — публичная ссылка либо base64. До 25 МБ на файл.
download_media(message_id: string){ url, mime, size }
Ссылка на входящее вложение, действительна 1 час. Скачивание не расходует лимит сообщений.
subscribe_events(webhook_url: string, channels?: Channel[], events?: EventType[])Subscription
Подписка на входящие. Без параметров — все события всех подключённых каналов.
Полный справочник

Частые вопросы

Подключите агента к мессенджерам

Выпустите ключ, добавьте пять строк в конфиг — и агент начнёт писать клиентам сам.

Есть вопросы? Напишите нам в Telegram →