Справочник инструментов MCP

Что делает каждый инструмент?

Чтение: list_numbers возвращает подключённые номера со статусом, рейтингом качества и уровнем обмена сообщениями. С него начинается любой другой вызов. get_number_health возвращает актуальный снимок Meta, недавнюю историю мониторинга, события вебхуков и проверки опросчика. get_api_credentials возвращает базовый URL Graph API, WABA id, phone number id и, если доступен, собственный токен доступа аккаунта.

Отправка: send_message отправляет свободный текст в течение 24 часов, когда ответы бесплатны. send_template отправляет одобренный шаблон, с него начинается разговор с человеком, который ещё не писал. list_templates, create_template и get_template_status охватывают жизненный цикл шаблона.

Подключение: set_webhook_destination направляет входящие сообщения и отражения приложения в вашу систему, а передача null сбрасывает настройку. get_connect_link возвращает ссылку на панель управления и шаги для подключения нового номера. get_docs возвращает документацию продукта в формате markdown.

Почему важен connection_id?

Потому что он связывает инструкцию с конкретным номером, а помощник не может угадать его.

Каждый инструмент, работающий с номером, принимает connection_id, и получить его можно только через list_numbers. На практике помощник, которого попросили отправить сообщение, сначала вызовет list_numbers. Поэтому первый запрос в сессии часто выполняется дольше остальных.

Это также делает работу аккаунта с несколькими номерами однозначной. Номера по умолчанию и неявного выбора нет, поэтому инструкция без указания номера вызывает уточняющий вопрос, а не догадку.

Что происходит при неоплате?

Четыре инструмента, которые обращаются к внешним системам, блокируются: send_message, send_template, create_template и set_webhook_destination. Всё, что только читает данные, остаётся доступным.

Это сделано намеренно. Если аккаунт не может понять причину блокировки или проверить состояние номеров, вернуть доступ можно только через обращение в поддержку. Эти же операции чтения нужны для мониторинга состояния, поэтому их отключение остановило бы мониторинг именно тогда, когда он особенно нужен.

На практике аккаунт с просроченной оплатой по-прежнему отвечает на вопросы о своём состоянии и продолжает мониториться. Останавливается только всё, что обращается к клиенту.

Распространённые ошибки

• Ожидать, что коннектор будет получать сообщения. MCP работает по схеме запрос и ответ, а входящий трафик требует вебхука.
• Жёстко прописывать connection_id. Он берётся из list_numbers и не предназначен для ручной записи.
• Считать аккаунт с просроченной оплатой полностью отключённым. Чтение и мониторинг намеренно продолжаются.

Часто задаваемые вопросы

Читайте дальше