Поддерживаемые MCP-сервером методы GREEN-API#
Узнайте как использовать методы GREEN-API в вашем ИИ ассистенте
После установки и настройки GREEN-API MCP вы можете использовать ИИ ассистента для: управления инстансом, отправки сообщений и файлов, получения сообщений и файлов, работы с журналами, контактами, группами и многое другое.
Используйте методы WhatsApp в вашей ИИ для решения сложных задач. Все инструменты легко и логично взаимодействуют друг с другом, обеспечивая необходимый результат. С помощью запросов вы легко сможете управлять общением в мессенджере WhatsApp.
Перечень MCP методов#
Подключение и авторизация#
whatsapp_connect
Подключает GREEN-API инстанс. Вызывается для подключения к другому инстансу.
instance_id api_token
Примеры запросов:
«Подключись к инстансу 1234567890 с токеном abc123»
«Войди в WhatsApp через GREEN-API»
whatsapp_get_qr
Возвращает QR-код для авторизации инстанса. Отображается инлайн — достаточно отсканировать в WhatsApp.
instance_id
Примеры запросов:
«Покажи QR-код для входа»
«Мне нужно привязать WhatsApp-аккаунт»
whatsapp_get_authorization_code
Запрашивает код авторизации для входа по номеру телефона (альтернатива QR).
phone_number, instance_id
Примеры запросов:
«Авторизуй инстанс по номеру +79001234567»
whatsapp_disconnect
Отключает инстанс и удаляет сохранённые учётные данные из сессии.
instance_id
Примеры запросов:
«Отключись от GREEN-API»
whatsapp_logout
Выходит из WhatsApp-аккаунта на инстансе (разлинковывает телефон).
instance_id
Примеры запросов:
«Выйди из WhatsApp на инстансе»
Управление инстансом#
whatsapp_get_state
Возвращает текущее состояние инстанса: authorized, notAuthorized, blocked или sleepMode.
instance_id
Примеры запросов:
«Проверь, авторизован ли мой инстанс»
«Каков статус WhatsApp-подключения?»
whatsapp_reboot
Перезапускает инстанс GREEN-API.
instance_id
Примеры запросов:
«Перезагрузи инстанс WhatsApp»
whatsapp_get_settings
Читает текущие настройки инстанса (вебхуки, задержки, поведение при получении сообщений).
instance_id
Примеры запросов:
«Покажи настройки моего инстанса»
whatsapp_set_settings
Обновляет настройки инстанса: URL вебхуков, задержку отправки, автоматическое прочтение входящих и другие параметры.
webhook_url, webhook_url_token, delay_message, incoming_webhook, outgoing_webhook, state_webhook, device_webhook, status_instance_webhook, mark_incoming_messages_readed, instance_id
Примеры запросов:
«Установи вебхук на https://myserver.com/hook»
«Включи автоматическое прочтение входящих сообщений»
whatsapp_get_wa_settings
Получает настройки WhatsApp-аккаунта: отображаемое имя, описание профиля и другие данные.
instance_id
Примеры запросов:
«Какое имя профиля указано в WhatsApp?»
Отправка сообщений#
whatsapp_send_message
Отправляет текстовое сообщение в личный чат или группу. Поддерживает цитирование и превью ссылок.
chat_id, message, quoted_message_id, link_preview, instance_id
Примеры запросов:
«Отправь "Привет!" на номер +79001234567»
«Напиши в группу 120363XXX@g.us, что встреча перенесена»
whatsapp_send_file
Отправляет файл по URL (изображение, документ, видео). Поддерживает подпись и имя файла.
chat_id, message, quoted_message_id, link_preview, instance_id
Примеры запросов:
«Отправь PDF-отчёт из https://example.com/report.pdf»
«Отправь фото с подписью "Новый продукт»
whatsapp_send_file_by_upload
Отправляет файл напрямую через загрузку base64, без предварительной публикации файла по URL.
chat_id, instance_id, file_base64, filename, caption
Примеры запросов:
«Отправь этот файл прямо из памяти, не загружая на сервер»
whatsapp_send_contact
Отправляет контактную карточку в чат с именем, фамилией, компанией и номером телефона.
chat_id, phone_number, first_name, last_name, company, instance_id
Примеры запросов:
«Поделись контактом Ивана Петрова (+79009876543)»
whatsapp_send_location
Отправляет геолокацию с координатами, названием и адресом точки.
chat_id, latitude, longitude, name, address, instance_id,
Примеры запросов:
«Отправь нашему курьеру геолокацию офиса»
whatsapp_send_poll
Создаёт и отправляет опрос с вариантами ответа. Поддерживает несколько вариантов выбора.
chat_id, message, options, multiple_answers, instance_id
Примеры запросов:
«Создай опрос в группе: "Когда встреча?" с вариантами Пн, Вт, Ср»
Работа с сообщениями#
whatsapp_get_message
Получает сообщение по его идентификатору в указанном чате.
chat_id, id_message, instance_id
Примеры запросов:
«Найди сообщение с ID BAE5F...»
whatsapp_edit_message
Редактирует отправленное сообщение, заменяя его текст.
chat_id, id_message, message, instance_id
Примеры запросов:
«Исправь опечатку в последнем сообщении»
whatsapp_delete_message
Удаляет сообщение из чата по ID.
chat_id, id_message, instance_id
Примеры запросов:
«Удали сообщение BAE5F... из чата»
whatsapp_forward_messages
Пересылает одно или несколько сообщений из одного чата в другой.
chat_id, chat_id_from, messages, instance_id
Примеры запросов:
«Перешли последние сообщения из личного чата в группу поддержки»
История и мониторинг#
whatsapp_get_chat_history
Загружает историю сообщений чата. По умолчанию возвращает последние 100 сообщений.
chat_id, count, instance_id
Примеры запросов:
«Покажи последние 50 сообщений из чата с клиентом»
«Выведи историю переписки с группой»
whatsapp_last_incoming_messages
Возвращает последние входящие сообщения за указанный период (по умолчанию 24 часа).
minutes, instance_id
Примеры запросов:
«Что мне написали за последние 2 часа?»
whatsapp_last_outgoing_messages
Возвращает последние исходящие сообщения за указанный период (по умолчанию 24 часа).
minutes, instance_id
Примеры запросов:
«Какие сообщения я отправлял сегодня?»
whatsapp_read_chat
Помечает сообщения в чате как прочитанные. Можно указать конкретное сообщение.
chat_id, id_message, instance_id
Примеры запросов:
«Отметь все сообщения в чате с поддержкой как прочитанные»
Очередь уведомлений#
whatsapp_receive_notification
Получает одно уведомление из очереди (режим ручного polling). Используется при отсутствии вебхуков.
instance_id
Примеры запросов:
«Проверь, есть ли новые события в очереди»
whatsapp_delete_notification
Подтверждает обработку уведомления и удаляет его из очереди (acknowledge).
receipt_id, instance_id
Примеры запросов:
«Подтверди получение уведомления с ID 1234»
Контакты#
whatsapp_check_whatsapp
Проверяет, зарегистрирован ли номер телефона в WhatsApp.
instance_id, phone_number
Примеры запросов:
«Есть ли WhatsApp у номера +79001112233?»
«Проверь список телефонов перед рассылкой»
whatsapp_get_contacts
Возвращает список всех контактов инстанса с их ID и данными. Отображается как интерактивный UI.
instance_id
Примеры запросов:
«Покажи все мои WhatsApp-контакты»
whatsapp_get_contact_info
Возвращает подробную информацию о контакте или группе по Chat ID.
chat_id, instance_id
Примеры запросов:
«Покажи информацию о контакте 79001234567@c.us»
whatsapp_get_contact_avatar
Возвращает URL аватара контакта или группы.
chat_id, instance_id
Примеры запросов:
«Загрузи фото профиля клиента»
Файлы#
whatsapp_upload_file
Загружает файл на серверы GREEN-API и возвращает URL для последующей отправки через whatsapp_send_file.
file_base64, filename, instance_id
Примеры запросов:
«Загрузи файл на сервер, чтобы потом отправить нескольким адресатам»
Группы#
whatsapp_create_group
Создаёт новую группу с заданным названием и списком участников.
group_name, chat_id, instance_id
Примеры запросов:
«Создай группу "Команда проекта" с участниками +7900... и +7911...»
whatsapp_get_group_data
Возвращает данные группы: название, список участников, ссылку-приглашение.
group_id, instance_id
Примеры запросов:
«Покажи участников группы 120363XXX@g.us»
whatsapp_add_group_participant
Добавляет участника в группу по его Chat ID.
group_id, participant_chat_id, instance_id
Примеры запросов:
«Добавь нового сотрудника в рабочую группу»
whatsapp_remove_group_participant
Удаляет участника из группы.
group_id, participant_chat_id, instance_id
Примеры запросов:
«Исключи пользователя из группы»
whatsapp_set_group_admin
Назначает участника группы администратором.
group_id, participant_chat_id, instance_id
Примеры запросов:
«Сделай Ивана администратором группы»
whatsapp_leave_group
Покидает указанную группу от имени текущего инстанса.
group_id, instance_id
Примеры запросов:
«Выйди из группы 120363XXX@g.us»
Партнёрский API#
Методы доступны только для партнёрских инстансов
Для этого необходимо стать партнёром GREEN-API. Подробнее о партнёрской программе
whatsapp_get_instances
Возвращает список всех инстансов партнёра через Partner API.
partner_token
Примеры запросов:
«Покажи все мои инстансы GREEN-API»
whatsapp_create_instance
Создаёт новый инстанс через Partner API.
partner_token
Примеры запросов:
«Создай новый инстанс для нашего бота»
whatsapp_delete_instance
Удаляет указанный инстанс через Partner API.
instance_id, partner_token
Примеры запросов:
«Удали инстанс 9876543210»
Ограничение частоты запросов#
Для WhatsApp API от GREEN-API существует установленные правила по ограничению запросов в секунду для каждого метода. Подробнее об ограниченнии частоты запросов читайте на странице документации.