Перейти к содержанию

Поддерживаемые MCP-сервером методы GREEN-API WABA#

Узнайте как использовать методы GREEN-API WABA в вашем ИИ ассистенте

После установки и настройки GREEN-API WABA MCP вы можете использовать ИИ ассистента для: управления инстансом, отправки шаблонных и сессионных сообщений и файлов, управления шаблонами сообщений, получения сообщений, работы с журналами, очередями и многое другое.

Используйте методы WhatsApp Business API в вашей ИИ для решения сложных задач. Все инструменты легко и логично взаимодействуют друг с другом, обеспечивая необходимый результат. С помощью запросов вы легко сможете управлять общением с клиентами через официальный WhatsApp Business API.

Правила WABA

  • Произвольные сообщения (waba_send_message, waba_send_file, waba_send_file_by_upload) доставляются только внутри 24-часового сессионного окна, которое открывается последним входящим сообщением клиента. Вне окна можно отправить только шаблон в статусе APPROVED с помощью waba_send_template.
  • Новый шаблон уходит на проверку в Meta со статусом PENDING. Отправить его можно только после того, как статус сменится на APPROVED.
  • Поддерживаются только личные чаты. Идентификатор чата — номер телефона в международном формате с суффиксом @c.us, например 79001234567@c.us. Подробнее в разделе Идентификатор чата.
  • WABA инстанс подключается в личном кабинете, авторизация по QR-коду не используется.

Перечень MCP методов#

Подключение#

waba_connect

Подключает WABA инстанс к сессии и проверяет его учётные данные. Вызывается для подключения к другому инстансу. На размещённом сервере не требуется — инстанс привязывается автоматически при OAuth авторизации.
instance_id, api_token, api_url
Примеры запросов:
«Подключись к WABA инстансу 1234567890 с токеном abc123»

waba_disconnect

Отключает инстанс и удаляет сохранённые учётные данные из сессии.
instance_id
Примеры запросов:
«Отключись от GREEN-API WABA»

Управление инстансом#

waba_get_state

Возвращает текущее состояние аккаунта: authorized, notAuthorized или starting.
instance_id
Примеры запросов:
«Проверь, авторизован ли мой WABA инстанс»
«Каков статус подключения WhatsApp Business?»

waba_reboot

Перезапускает WABA инстанс.
instance_id
Примеры запросов:
«Перезагрузи WABA инстанс»

waba_get_settings

Читает текущие настройки уведомлений: URL и токен вебхука, включённые типы уведомлений.
instance_id
Примеры запросов:
«Покажи настройки моего инстанса»

waba_set_settings

Обновляет настройки уведомлений. Пустой webhook_url отключает вебхуки. Нужно передать хотя бы один параметр.
webhook_url, webhook_url_token, outgoing_webhook, outgoing_api_message_webhook, incoming_webhook, instance_id
Примеры запросов:
«Установи вебхук на https://myserver.com/hook»
«Включи уведомления о входящих сообщениях»

waba_get_wa_settings

Получает номер телефона и состояние аккаунта WhatsApp Business.
instance_id
Примеры запросов:
«Какой номер подключён к моему WABA инстансу?»

Отправка сообщений#

waba_send_message

Отправляет произвольное текстовое сообщение длиной до 20000 символов. Поддерживает превью ссылок. Доставляется только внутри 24-часового сессионного окна.
chat_id, message, link_preview, instance_id
Примеры запросов:
«Ответь клиенту +79001234567: "Здравствуйте! Ваш заказ уже в пути"»

waba_send_template

Отправляет одобренный шаблон сообщения. Единственный способ начать диалог или написать клиенту вне 24-часового окна. Поддерживает параметры шаблона {{1}}, {{2}}, медиа-заголовок и postback-кнопки.
chat_id, template_id, params, media_type, media_url, media_filename, message, postback_texts, instance_id
Примеры запросов:
«Отправь шаблон order_status на номер +79001234567 с параметром "№123"»
«Напомни клиенту о записи с помощью шаблона appointment_reminder»

waba_send_file

Отправляет изображение, видео, аудио или документ по URL. Поддерживает подпись. Доставляется только внутри 24-часового сессионного окна. Ограничения: изображения 5 МБ, аудио и видео 16 МБ, документы 100 МБ.
chat_id, url, file_name, caption, instance_id
Примеры запросов:
«Отправь PDF-отчёт из https://example.com/report.pdf»
«Отправь фото с подписью "Новый продукт"»

waba_send_file_by_upload

Отправляет файл напрямую через загрузку base64, без предварительной публикации файла по URL. Доставляется только внутри 24-часового сессионного окна.
chat_id, file_base64, filename, caption, instance_id
Примеры запросов:
«Отправь этот файл клиенту, не загружая его на сервер»

Шаблоны#

waba_create_template

Создаёт шаблон сообщения и отправляет его на проверку в Meta. Шаблон получает статус PENDING и может быть отправлен только после смены статуса на APPROVED. Шаблоны категорий MARKETING и AUTHENTICATION тарифицируются за каждое сообщение, шаблоны UTILITY дешевле.
element_name, language_code, category, template_type, vertical, content, example, header, example_header, footer, buttons, cards, media_url, enable_sample, add_security_recommendation, code_expiration_minutes, instance_id
Примеры запросов:
«Создай шаблон категории UTILITY на русском: "Ваш заказ {{1}} отправлен"»
«Создай шаблон для отправки кода подтверждения»

waba_edit_template

Редактирует шаблон в статусе REJECTED, APPROVED или PAUSED. После редактирования шаблон снова получает статус PENDING до повторной проверки Meta.
template_id, content, example, template_type, header, example_header, footer, buttons, media_url, category, enable_sample, allow_template_category_change, instance_id
Примеры запросов:
«Исправь текст отклонённого шаблона и отправь его на повторную проверку»

waba_get_templates

Возвращает список шаблонов аккаунта со статусом проверки Meta: PENDING, APPROVED, REJECTED, FAILED или PAUSED. Можно отфильтровать по статусу. В клиентах с поддержкой MCP Apps отображается как интерактивный виджет.
status, instance_id
Примеры запросов:
«Покажи все мои одобренные шаблоны»
«Какие шаблоны ещё на проверке?»

waba_get_template

Возвращает шаблон по его идентификатору: статус, текст и кнопки.
template_id, instance_id
Примеры запросов:
«Покажи шаблон с ID 1234567890»

waba_delete_template

Удаляет все языковые версии шаблона по его имени.
element_name, instance_id
Примеры запросов:
«Удали шаблон old_promo»

waba_delete_template_by_id

Удаляет одну версию шаблона по имени и идентификатору.
element_name, template_id, instance_id
Примеры запросов:
«Удали английскую версию шаблона order_status»

История и мониторинг#

waba_get_chat_history

Загружает историю сообщений чата, начиная с последних. По умолчанию возвращает последние 50 сообщений, максимум 100.
chat_id, count, instance_id
Примеры запросов:
«Покажи последние 20 сообщений из чата с клиентом»

waba_get_message

Получает сообщение по его идентификатору в указанном чате.
chat_id, id_message, instance_id
Примеры запросов:
«Найди сообщение с ID BAE5F...»

waba_last_incoming_messages

Возвращает входящие сообщения за указанный период (по умолчанию 60 минут, максимум 1440). Помогает понять, у каких клиентов открыто сессионное окно.
minutes, instance_id
Примеры запросов:
«Кто написал мне за последние 2 часа?»

waba_last_outgoing_messages

Возвращает исходящие сообщения за указанный период (по умолчанию 60 минут, максимум 1440) со статусами доставки.
minutes, instance_id
Примеры запросов:
«Какие сообщения я отправлял за последний час и доставлены ли они?»

Очередь уведомлений#

waba_receive_notification

Получает одно уведомление из очереди: входящие сообщения, ответы на кнопки шаблонов, статусы доставки. Уведомления хранятся в очереди до 24 часов. Каждое уведомление нужно подтвердить методом waba_delete_notification, иначе оно будет получено повторно.
instance_id
Примеры запросов:
«Проверь, есть ли новые события в очереди»

waba_delete_notification

Подтверждает обработку уведомления и удаляет его из очереди.
receipt_id, instance_id
Примеры запросов:
«Подтверди получение уведомления с ID 1234»

Очередь сообщений#

waba_show_messages_queue

Возвращает список сообщений, ожидающих отправки.
instance_id
Примеры запросов:
«Покажи сообщения в очереди на отправку»

waba_clear_messages_queue

Очищает очередь сообщений к отправке.
instance_id
Примеры запросов:
«Очисти очередь исходящих сообщений»

Сервисные методы#

waba_service_method

Вызывает любой метод WABA API по имени, если для него нет отдельного инструмента. Параметр request передаётся объектом вида {"method": "getMessagesCount", "httpMethod": "GET", "body": {...}}.
request, instance_id
Примеры запросов:
«Сколько сообщений в очереди на отправку?»
«Покажи список последних чатов»

Партнёрский API#

Методы доступны только для партнёрских инстансов

Для этого необходимо стать партнёром GREEN-API. Подробнее о партнёрской программе

waba_get_instances

Возвращает список всех инстансов партнёра через Partner API.
partner_token
Примеры запросов:
«Покажи все мои инстансы GREEN-API»

waba_create_instance

Создаёт новый инстанс через Partner API.
partner_token
Примеры запросов:
«Создай новый инстанс для нашего бота»

waba_delete_instance

Удаляет указанный инстанс через Partner API.
instance_id, partner_token
Примеры запросов:
«Удали инстанс 9876543210»

Промпты и ресурсы MCP#

Помимо инструментов, сервер предоставляет готовые промпты и ресурсы, которые можно выбрать в клиенте с их поддержкой.

Промпты:

  • waba_customer_support — промпт агента поддержки с правилами 24-часового окна. Параметры: instance_id, language
  • waba_template_broadcast — планирование и запуск рассылки по одобренному шаблону. Параметры: instance_id, template_id

Ресурсы:

  • waba://instance/{id}/state — состояние аккаунта
  • waba://instance/{id}/settings — настройки уведомлений
  • waba://instance/{id}/templates — все шаблоны со статусами
  • ui://templates — интерактивный виджет шаблонов (MCP App), отображается для waba_get_templates

Ограничение частоты запросов#

Для WhatsApp Business API от GREEN-API существует установленные правила по ограничению запросов в секунду для каждого метода. Подробнее об ограничении частоты запросов читайте на странице документации.