Сообщения и голос для ИИ-агентов.

Выберите способ доступа

Агентам обычно нужны две вещи: факты для планирования и способ действовать. BroadNet разделяет их. Сервер знаний отвечает на вопросы без аккаунта; для отправки всегда нужен ваш токен.

Что может отправлять агент

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

Разбор примера: агент планирует запуск OTP

Пользователь просит агента спланировать отправку одноразовых паролей в ОАЭ. Агент вызывает четыре инструмента на публичном сервере знаний. Ниже приведены реальные результаты сервера, сокращенные до полей, которые использует агент.

Копировать и вставить

В примерах используются только вымышленные номера. Считывайте токен из переменной окружения; никогда не вставляйте его в чат или в файл, включенный в репозиторий.

{
  "mcpServers": {
    "broadnet-knowledge": {
      "type": "http",
      "url": "https://www.broadnet.me/mcp"
    },
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"estimate_price",
                 "arguments":{"country":"UAE","channel":"sms","volume":50000}}}'

curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "BroadNet",
    "destinationNumber": "447700900123",
    "message": "Your verification code is 482913",
    "messageType": "TEXT"
  }'

# 200 OK → response body is the message ID, e.g. 2603121407537573731

// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";

const sms = new SMSSMSApi(
  new Configuration({
    basePath: "https://api.broadnet.me",
    accessToken: process.env.BROADNET_TOKEN!,
  }),
);

const res = await sms.smsSendsmsPost({
  sMSSmsRequest: {
    senderId: "BroadNet",
    destinationNumber: "447700900123",
    message: "Your verification code is 482913",
    messageType: "TEXT",
  },
});

console.log(res.data); // message ID

# Send an approved WhatsApp template
curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-updates \
  -F destinationNo=447700900123 \
  -F messageType=TEMPLATE \
  -F templateName=order_update \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=INV-400

# 200 OK → the response carries the batchId; per-recipient status
# (SUBMITTED → SENT → DELIVERED → READ) arrives on your webhook.

Машиночитаемые точки входа

Агенты, которые читают, а не подключаются, найдут всё в простых файлах. Ни один из них не требует входа.

• llms.txt
  /llms.txt

  Индекс сайта для языковых моделей с разделом о доступе и ограничениях для агентов, а также по одному файлу на каждый язык.

• Навыки агентов
  /.well-known/agent-skills/index.json

  Пять ранбуков SKILL.md: покрытие и цены, регистрация имени отправителя, первое тестовое SMS, тестовый доступ и подключение к MCP-серверам.

• Карточка агента A2A
  /.well-known/agent-card.json

  Карточка Agent2Agent для тех же инструментов знаний в режиме «только чтение», предоставляемых через JSON-RPC на /a2a.

• Каталог API
  /.well-known/api-catalog

  Набор RFC 9727-ссылок, указывающих на спецификацию OpenAPI, документацию API, оба сервера MCP и страницу статуса.

• Карточка сервера MCP
  /.well-known/mcp.json

  Карточка сервера с описанием обоих серверов MCP, их протоколов передачи и аутентификации.

• OpenAPI 3.1
  /developers/openapi.yaml

  Полное описание REST API: скачайте его или сгенерируйте по нему типизированный клиент.

• Markdown-копии
  /pricing/sms/uae.md

  Добавьте .md к большинству URL-адресов страниц или отправьте Accept: text/markdown, чтобы получить чистую Markdown-копию страницы.

• Файлы данных
  /data/coverage.json

  Охват, опубликованные тарифы и нормативные требования для каждого рынка в формате JSON (CSV для охвата и цен).

• Статус в JSON
  /status/api/v2/summary.json

  Измеренная доступность веб-сайта, шлюза API и обоих эндпоинтов MCP в формате сводки Statuspage v2.

Правила, которым должен следовать агент

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

• Сначала согласие, затем контент

  Отправляйте маркетинговые сообщения только тем получателям, которые дали согласие, и сохраняйте запись об этом согласии. Инструмент sender_id_rules возвращает правила получения согласия для каждого рынка.

• Учитывайте отказы от рассылки

  Рекламные сообщения содержат ключевое слово для отказа от рассылки, принятое на конкретном рынке, например STOP. Агент никогда не отправляет сообщения на номера, которые оформили отказ от рассылки.

• Только зарегистрированные имена отправителя

  Во многих регионах требуется предварительная регистрация буквенно-цифровых имен отправителя. Агент использует только те имена отправителя, которые одобрены в вашем аккаунте, и никогда не использует вымышленные.

• Соблюдайте часы тишины

  На ряде рынков маркетинг ночью запрещён. sender_id_rules возвращает часы тишины со ссылкой на источник; OTP и оповещения обычно разрешены круглосуточно.

• Защитите OTP от накрутки трафика

  Боты могут запускать отправку OTP на номера, с которых мошенники получают доход. Ограничьте частоту запросов кода по номеру, IP и устройству и заблокируйте направления, которые вы не обслуживаете. В MyOTP эта защита включена по умолчанию.

• Каждая отправка подтверждается человеком

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

• Тестируйте на своём номере

  С тестовыми учётными данными отправляйте сообщения только на свой подтверждённый номер. В примерах и промптах используются вымышленные номера.

• Не передавайте токен в чате

  Токен — это учётные данные для отправки. Загружайте его из переменной окружения, никогда из промпта, и отзывайте при утечке.

Связанное

Вопросы