Коротко
Агенты Gemini подключаются к OmniChannels.ai через наш удалённый MCP-сервер https://mcp.broadnet.me/mcp. В Agent Development Kit MCPToolset работает по Streamable HTTP и передаёт ваш токен в заголовке Authorization; Gemini CLI принимает тот же URL и заголовок в настройках. После этого агент может отправлять сообщения в WhatsApp, SMS и RCS, использовать одобренные шаблоны и читать отчёты о доставке (DLR). Приложение из маркетплейса Google для этого не нужно.
Что вы можете делать
Уведомления клиентам от ADK-агента
Агент, созданный на Agent Development Kit, отправляет обновления о доставке заказа или напоминания о визите, когда этого требует ваше приложение.
Попробуйте спросить
“Отправь сообщение в WhatsApp на номер 971500000000: заказ отправлен и будет доставлен завтра.”
Шаблоны для клиентов из Саудовской Аравии и ОАЭ
Агент получает список одобренных шаблонов WhatsApp и подставляет подходящую версию на арабском или английском языке.
Попробуйте спросить
“Покажи мои одобренные арабские шаблоны WhatsApp и отправь шаблон order_update на номер 966500000000 с номером заказа INV-400.”
Тестовые отправки из Gemini CLI
Разработчики отправляют тестовое сообщение или проверяют отчёт о доставке прямо из терминала во время разработки.
Попробуйте спросить
“Отправь тестовое SMS на мой подтверждённый номер и сообщи статус доставки.”
Анализ доставки
Агент только для чтения, у которого есть лишь инструмент отчётов о доставке, кратко описывает сбои для вашей команды.
Попробуйте спросить
“Сколько сообщений во вчерашней рассылке выписок не было доставлено и какие причины встречались чаще всего?”
Работа вместе с данными вашего бизнеса
Если у агента есть инструмент для BigQuery, вашей CRM или вашего магазина, он может получить получателей оттуда и отправить сообщения через OmniChannels.ai.
Попробуйте спросить
“Отправь в WhatsApp обновление по заказу клиентам, чьи заказы были отправлены сегодня.”
Как устроено подключение
OmniChannels.ai предоставляет удалённый MCP-сервер по Streamable HTTP. Каждый запрос содержит ваш API-токен в заголовке Authorization: Bearer, а каждый инструмент работает с правами, именами отправителей и балансом этого токена — точно так же, как ваш собственный код.
В Agent Development Kit добавьте MCPToolset, в параметрах подключения Streamable HTTP которого указаны наш URL и заголовок Authorization, и ограничьте его теми инструментами, которые нужны агенту. ADK-агента можно развернуть в Vertex AI Agent Engine; храните токен в Secret Manager, а не в коде. Gemini CLI читает MCP-серверы из файла настроек: для адреса используется httpUrl, для токена — headers.
- Endpoint: https://mcp.broadnet.me/mcp (Streamable HTTP)
- Аутентификация: Authorization: Bearer <token>; на время тестирования используйте временный ключ
- ADK: MCPToolset с параметрами подключения Streamable HTTP и headers
- Gemini CLI: запись в mcpServers с httpUrl и headers
- Без MCP агент может вызывать наш REST API по спецификации OpenAPI
Настройка
- 1
Запросите доступ к API
Запросите тестовый доступ и получите API-токен. Тестовые отправки идут только на ваши собственные подтверждённые номера.
- 2
Получите ключ MCP
В административном портале откройте Integrations, затем MCP Integration и скопируйте временный ключ.
Руководство: MCP server for AI agents - 3
Добавьте набор инструментов в агента
В ADK создайте MCPToolset с параметрами Streamable HTTP для https://mcp.broadnet.me/mcp и заголовком Authorization, считывая токен из переменной окружения или хранилища секретов.
- 4
Или добавьте его в Gemini CLI
Добавьте запись в mcpServers: в httpUrl укажите наш endpoint, а заголовок Authorization — в headers, затем перезапустите CLI.
- 5
Ограничьте инструменты и подтверждайте отправки
Откройте агенту только нужные инструменты и добавьте шаг подтверждения перед любой отправкой: каждая отправка — это реальное сообщение, которое тарифицируется.
- 6
Протестируйте и разверните
Отправьте тестовое сообщение на ваш подтверждённый номер и проверьте отчёт о доставке, прежде чем развернуть агента в Vertex AI Agent Engine.
Документация вендора
Google Gemini and Vertex AI является товарным знаком своего владельца. OmniChannels.ai не связана с Google Gemini and Vertex AI и не одобрена компанией Google Gemini and Vertex AI; на этой странице описано подключение, которое строится на собственных функциях MCP, HTTP или вебхуков Google Gemini and Vertex AI.
