Перейти к содержимому
OmniChannels.ai
Меню

ИИ-ассистенты и агенты

VS Code + OmniChannels.ai: инструменты для сообщений в режиме агента Copilot

Подключение через MCPПодключение через API и вебхукиОбновлено

Коротко

VS Code подключается к OmniChannels.ai через наш удалённый MCP-сервер https://mcp.broadnet.me/mcp, который добавляется в .vscode/mcp.json как http-сервер. Поле promptString с параметром password запрашивает ваш API-токен и надёжно хранит его, поэтому ключ не попадает в коммит. После этого GitHub Copilot в режиме агента может отправлять тестовые сообщения, выводить список шаблонов WhatsApp и читать отчёты о доставке (DLR), пока помогает вам писать код интеграции.

Что вы можете делать

  • Код, который соответствует вашим шаблонам

    Copilot получает через MCP список ваших одобренных шаблонов WhatsApp и пишет отправку ровно с теми переменными, которые нужны каждому шаблону.

    Попробуйте спросить

    “Покажи мои одобренные шаблоны WhatsApp, затем напиши метод на C#, который отправляет order_update с номером заказа и датой доставки.”

  • Создание и тестирование вебхук-эндпоинта

    Copilot пишет эндпоинт для статусов доставки и входящих сообщений, а вы запускаете тестовую отправку и видите, как приходят реальные данные.

    Попробуйте спросить

    “Напиши вебхук-эндпоинт на FastAPI, который сохраняет статусы доставки по ID сообщения и принимает поля, различающиеся в зависимости от канала, затем отправь тестовое SMS на 447700900123, чтобы я увидел, как оно придёт.”

  • Проверка доставки перед релизом

    После того как ваш код отправил тестовое сообщение, Copilot читает отчёт о доставке, и вы можете убедиться, что обработчик записал верный статус.

    Попробуйте спросить

    “Проверь отчёт о доставке последнего сообщения, отправленного на 971500000000, и сравни его статус с тем, что записано в нашей базе данных.”

  • Работа по спецификации, а не по памяти

    Если спецификация OpenAPI лежит в рабочей папке проекта, Copilot использует точные пути и поля, в том числе знает, какие отправки требуют multipart/form-data.

    Попробуйте спросить

    “Используя docs/omnichannels-openapi.yaml, напиши вспомогательную функцию для массовой отправки в WhatsApp и укажи, какие поля передаются как multipart/form-data.”

  • Тексты на арабском и английском

    Copilot готовит текст сообщения на двух языках и показывает его вам до вызова любого инструмента отправки.

    Попробуйте спросить

    “Подготовь SMS-напоминание о приёме на арабском и английском, каждое не длиннее одного сегмента, и покажи мне, прежде чем отправлять тест на 966500000000.”

Как устроено подключение

Подключение через MCPПодключение через API и вебхуки

VS Code читает MCP-серверы из файла .vscode/mcp.json в вашем рабочем проекте. Наш сервер добавляется как http-сервер с заголовком Authorization, а токен берётся из поля типа promptString с password, равным true. VS Code запрашивает его один раз и не записывает в файл, который вы коммитите.

В режиме агента GitHub Copilot инструменты включённых MCP-серверов появляются в списке инструментов, где каждый можно включить или отключить, а VS Code может запрашивать подтверждение вызовов. Оставьте подтверждение включённым для всего, что отправляет сообщения: каждая отправка — это реальное сообщение, которое тарифицируется. Поля конфигурации меняются между версиями VS Code, поэтому, если какое-то поле не распознаётся, сверьтесь с документацией по MCP.

  • Файл: .vscode/mcp.json, тип сервера http, URL https://mcp.broadnet.me/mcp
  • Заголовок: Authorization: Bearer ${input:omnichannels-token}
  • Поле токена: promptString с password: true
  • Включайте в списке только те инструменты, которые нужны этому проекту

Настройка

  1. 1

    Запросите доступ к API

    Запросите тестовый доступ и получите API-токен. Тестовые отправки идут только на ваши собственные верифицированные номера.

  2. 2

    Получите временный ключ

    В админ-портале откройте раздел Integrations, затем MCP Integration и выберите Get temporary key.

    Руководство: MCP server for AI agents
  3. 3

    Создайте .vscode/mcp.json

    Добавьте сервер omnichannels типа http с нашим URL, заголовок Authorization, который использует ${input:omnichannels-token}, и поле promptString с password, равным true.

    Руководство: MCP server for AI agents
  4. 4

    Запустите сервер и введите ключ

    Запустите сервер из VS Code, вставьте ключ, когда появится запрос, и убедитесь, что инструменты отображаются в режиме агента Copilot.

  5. 5

    Ограничьте набор инструментов

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

  6. 6

    Проверьте на своём номере

    Попросите Copilot отправить тестовое сообщение на ваш верифицированный номер, затем прочитайте отчёт о доставке.

Документация вендора

VS Code является товарным знаком своего владельца. OmniChannels.ai не связана с VS Code и не одобрена компанией VS Code; на этой странице описано подключение, которое строится на собственных функциях MCP, HTTP или вебхуков VS Code.

Пример сценария

Как типичный запрос проходит от VS Code к вашему клиенту и обратно.

  1. 01

    Режим агента Copilot

    Вызывает инструменты MCP, пока помогает вам писать код

  2. 02

    MCP-сервер OmniChannels.ai

    Отправляет сообщения, выводит шаблоны и читает отчёты с вашим токеном

  3. 03

    Ваш тестовый телефон

    Тестовое сообщение в WhatsApp или SMS на ваш верифицированный номер

  4. 04

    Отчёт о доставке

    Copilot считывает статус обратно с помощью инструмента чтения

1. Режим агента Copilot: Вызывает инструменты MCP, пока помогает вам писать код 2. MCP-сервер OmniChannels.ai: Отправляет сообщения, выводит шаблоны и читает отчёты с вашим токеном 3. Ваш тестовый телефон: Тестовое сообщение в WhatsApp или SMS на ваш верифицированный номер 4. Отчёт о доставке: Copilot считывает статус обратно с помощью инструмента чтения

Вопросы и ответы

Есть ли расширение OmniChannels.ai для VS Code?

Нет. VS Code подключается через стандартную поддержку MCP-серверов в .vscode/mcp.json, используя наш публичный эндпоинт и ваш API-токен. Ничего не нужно устанавливать из магазина расширений.

Где хранится мой токен?

Если поле promptString задано с password: true, VS Code запрашивает токен при запуске сервера и надёжно хранит его, а не записывает в mcp.json. Коммитьте файл, но никогда не коммитьте ключ.

В каком режиме Copilot используются инструменты?

Инструменты MCP используются в режиме агента Copilot, где вы выбираете, какие из них доступны. Проверьте актуальную документацию VS Code для вашей версии и политики организации, которые управляют MCP.

Можно ли использовать такую же настройку в других редакторах?

Тот же эндпоинт может использовать любой клиент, который поддерживает Streamable HTTP и пользовательский заголовок Authorization, хотя каждый хранит конфигурацию в своём формате. Примеры для Cursor и Claude Code смотрите в руководстве по MCP-серверу.

Получите доступ к API и MCP

Расскажите нам о ваших каналах, странах и сценарии использования. Инженер выдаст тестовые учётные данные и проверит ваши тестовые номера.