Один API для сообщений в восьми каналах
Отправляйте SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email и push из своего кода: один базовый URL и один Bearer-токен. Отслеживайте каждое сообщение через вебхуки, масштабируйте SMS через SMPP и давайте ИИ-агентам доступ к тому же API через MCP.
curl -X POST https://api.broadnet.me/sms/sendSms \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"senderId": "OmniDemo",
"destinationNumber": "447700900123",
"message": "Your code is 482913",
"messageType": "TEXT"
}'
# 200 OK
2603121407537573731Реальный запрос: POST /sms/sendSms возвращает ID сообщения в виде обычного текста. Замените токен, Sender ID и номер на свои.
Короткий ответ
Обновлено
OmniChannels.ai даёт разработчикам один REST API для SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email и push. В нём около 225 документированных путей, описанных в спецификации OpenAPI 3.1, а также TypeScript SDK, вебхуки со статусами доставки, SMPP v3.4 поверх TLS и MCP-сервер для ИИ-агентов. Тестовый доступ работает только на ваши собственные верифицированные номера, интеграцию сопровождают инженеры, а реселлеры могут использовать тот же API под своим брендом.
Что вы получаете как разработчик
Одна интеграция охватывает все каналы, которыми пользуются ваши клиенты, и даёт инструменты, которых ждёт продакшн-команда.
Один REST API, восемь каналов
SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email и push используют один базовый URL, один Bearer-токен и один формат ошибок. Добавить канал — значит подключить новый эндпоинт, а не нового вендора.
OpenAPI 3.1 и TypeScript SDK
Около 225 документированных путей в спецификации OpenAPI 3.1: её можно импортировать в Postman или использовать для генерации клиентов. Для TypeScript и Node.js есть официальный пакет @broadnet/cpaas-sdk.
Вебхуки со статусами доставки
Статусы нормализуются для всех каналов (SUBMITTED, SENT, DELIVERED, READ, FAILED и REJECTED) и отправляются на ваш HTTPS-эндпоинт. В качестве страховки есть эндпоинты для опроса и повторной отправки.
SMPP v3.4 для больших объёмов SMS
Transceiver-подключения поверх TLS с белым списком IP настраиваются для вашего аккаунта и работают на тех же прямых маршрутах операторов, что и REST API.
MCP-сервер для ИИ-агентов
Подключите Claude, Cursor или любой MCP-клиент к API с помощью своего токена: агенты смогут отправлять сообщения и читать отчёты о доставке в рамках ваших ограничений.
Тестирование до запуска
Тестовые доступы отправляют сообщения только на ваши верифицированные номера и работают на том же базовом URL, что и продакшн, поэтому при переходе код менять не нужно.
Поддержка от инженеров
Инженер по сообщениям изучит ваш сценарий, поможет с архитектурой REST или SMPP, именами отправителей (Sender ID) и правилами стран и будет рядом до запуска в продакшн.
Для реселлеров
Реселлеры используют тот же API под своим брендом. У каждого субаккаунта свой баланс, имена отправителей, пользователи и вебхуки, а для управления аккаунтами есть API для реселлеров.
Возможности для разработчиков
Что доступно сегодня и что настраивается вместе с нашей командой.
| Позиция | Статус | Подробности |
|---|---|---|
| REST API (SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email, push) | Доступно | Базовый URL https://api.broadnet.me, аутентификация по Bearer-токену. Тестовый доступ выдаётся после короткой заявки. |
| Вебхуки со статусами доставки | Доступно | Настраиваются для аккаунта или субаккаунта. Статусы нормализуются для всех каналов. |
| TypeScript SDK | Доступно | npm install @broadnet/cpaas-sdk axios. В других языках вызывайте REST API напрямую или сгенерируйте клиент. |
| Спецификация OpenAPI 3.1 | Доступно | Публично доступна по адресу https://omnichannels.ai/developers/openapi.json (YAML — /developers/openapi.yaml): все операции, которые может вызвать токен клиента, для Postman, Insomnia, генерации клиентов и ИИ-инструментов для кода. |
| MCP-сервер | Доступно | https://mcp.broadnet.me/mcp по Streamable HTTP, аутентификация по вашему токену. |
| SMPP v3.4 поверх TLS | По запросу | Подключения, пропускную способность и белый список IP настраивает для вашего аккаунта наша команда. |
| Голосовой канал (OTP, IVR, исходящие звонки, голосовые ИИ-агенты) | По запросу | Подключается вместе с командой аккаунта; публичных голосовых эндпоинтов в REST API нет. |
От первого запроса до продакшна
Мгновенной саморегистрации нет. Доступ начинается с короткой заявки, чтобы аккаунт был настроен под ваши каналы и страны.
- 1
Запросите тестовый доступ
Расскажите о каналах, странах назначения, объёмах и сценарии использования. Инженер рассмотрит заявку и выдаст тестовые доступы.
- 2
Отправьте первое тестовое сообщение
По краткому руководству отправьте SMS на свой верифицированный номер и получите статус доставки на свой вебхук.
- 3
Разработайте интеграцию
Добавьте нужные каналы, обработайте ошибки и повторные попытки, сохраняйте ID сообщений. Наши инженеры могут проверить вашу архитектуру для REST или SMPP.
- 4
Согласуйте отправителей
Имена отправителей (альфа-имена), аккаунты WhatsApp Business и RCS-агенты регистрируются параллельно с разработкой по правилам каждой страны и платформы.
- 5
Запустите в продакшн
Для вашего аккаунта включаются продакшн-маршруты. Код продолжает обращаться к тому же базовому URL, поэтому при переходе ничего не меняется.
Подходит ли этот API вашей команде?
Подходит, если
- Вам нужна одна интеграция для SMS, WhatsApp, RCS, мессенджеров и соцсетей, email и push вместо нескольких вендоров.
- Вам нужны статусы доставки по каждому сообщению в собственных системах, а не только в личном кабинете.
- Вы отправляете большие объёмы SMS и хотите использовать SMPP вместе с REST.
- Вы перепродаёте сообщения и вам нужен тот же API под вашим брендом, с субаккаунтами.
- Вы создаёте ИИ-агентов, которые должны отправлять сообщения и отслеживать их через MCP.
Что важно знать перед стартом
- Мгновенной саморегистрации нет: тестовый доступ выдаётся после короткой заявки.
- Официальный SDK есть только для TypeScript; в других языках используйте обычный HTTP или клиент, сгенерированный по спецификации.
- API не принимает ключ идемпотентности, поэтому ваша интеграция должна фиксировать каждую отправку до повторной попытки.
- Голосовой канал и SMPP подключаются вместе с нашей командой, а не через публичные эндпоинты.
- Отправка в WhatsApp, Messenger и Instagram подчиняется правилам Meta, включая одобренные шаблоны и окна для сообщений.
Documentation
Everything you need to integrate, from your first API call to SMPP binds and AI agents. The documentation is in English.
- Get startedQuickstart: send your first messageGet test credentials, send your first SMS with cURL, Node.js, Python or PHP, receive the delivery status, and check what to do before going live.
- Get startedAuthenticationHow to authenticate API requests with a Bearer token, store and rotate it safely, read a 401 response, and connect Facebook Pages and Instagram via OAuth.
- Messaging channelsSMS APISend single and bulk SMS, choose TEXT or UNICODE encoding, count segments, schedule, control bulk jobs and look up numbers before you send.
- Messaging channelsWhatsApp Business APISend WhatsApp templates, text, media and interactive messages through one multipart endpoint, manage templates and batches, and track every recipient.
- Messaging channelsRCS Business Messaging APISend RCS text, media, rich cards, carousels and suggested replies, check device capability first, and plan SMS fallback for users without RCS.
- Messaging channelsFacebook Messenger APIConnect a Facebook Page with OAuth, then send Messenger text, media, button and carousel templates and quick replies within Meta's messaging windows.
- Messaging channelsInstagram Messaging APIConnect an Instagram professional account with OAuth and reply to Instagram DMs by API: text, media, quick replies, generic templates and reactions.
- Messaging channelsTelegram APISend Telegram text, photos, documents, video, location and contact messages from your connected sender, use saved templates, and smoke-test in a sandbox.
- Messaging channelsEmail APISend transactional and bulk email through your SMTP sender with HTML, templates, attachments, CC and scheduling, plus domain checks and a sandbox send.
- Messaging channelsPush Notifications APISend push notifications to your app's users by user reference, device token, topic or segment, with images, deep links, actions, templates and dry runs.
- Messaging channelsVoice: OTP, IVR, calls and AI agentsWhat voice can do on OmniChannels.ai, from voice OTP and IVR to AI voice agents and SMS-to-voice fallback, and how our team provisions it for your account.
- Events and errorsWebhooks and delivery statusesReceive delivery statuses and inbound messages on your HTTPS endpoint, respond fast, deduplicate events, and poll or re-trigger statuses when needed.
- Events and errorsErrors, retries and rate limitsHTTP status codes and error bodies, which errors to retry with backoff and jitter, default rate limits, pagination, and how to avoid duplicate sends.
- ConnectivitySMPP v3.4 connectivityWhen to use SMPP instead of REST, how binds are provisioned over TLS, submit_sm essentials, encoding, concatenation, delivery receipts and error codes.
- ToolsMCP server for AI agentsConnect Claude, Cursor, VS Code and other MCP clients to the messaging API so AI agents can send and track messages safely with your token.
- ToolsSDKs, OpenAPI spec and code samplesUse the TypeScript SDK, import the OpenAPI 3.1 spec into Postman or Insomnia, generate clients, and call the API from Java, .NET, Go and Ruby.
- ToolsOpenAPI 3.1 specDownload the public OpenAPI 3.1 spec of the messaging API, import it into Postman or Insomnia, generate clients and types, and give it to AI coding tools.
- ToolsUse the MCP server with Claude CodeAdd the OmniChannels.ai MCP server to Claude Code with claude mcp add, share it in .mcp.json, keep the token in an environment variable and gate send tools.
- ToolsUse the MCP server with CursorConnect Cursor to the OmniChannels.ai MCP server with .cursor/mcp.json, read the token from an environment variable, toggle tools and send a first message.
- ToolsUse the MCP server with n8nGive an n8n AI Agent the OmniChannels.ai messaging tools with the MCP Client Tool node, or call the REST API and receive delivery statuses with plain n8n nodes.
- ToolsMake and Zapier with webhooksSend messages from Make scenarios and Zaps with an HTTP request to the REST API, and get delivery statuses and inbound messages via a Make or Zapier webhook.
Как API вписывается в ваш стек
Ваши системы обращаются к одному REST API с одним bearer-токеном. BroadNet направляет каждое сообщение по подходящему каналу и оператору и возвращает статусы доставки на ваш вебхук.
Ваше приложение, CRM или ИИ-агент
- Bearer-токен, один базовый URL
- SMPP 3.4 поверх TLS для больших объёмов
- MCP-сервер для ИИ-агентов
API сообщений BroadNet
API сообщений BroadNethttps://api.broadnet.meТелефон вашего клиента
Статусы доставки на ваш вебхук
SENTDELIVEREDREADFAILED
Вопросы разработчиков
Как пройти аутентификацию?
Передавайте токен доступа вашего аккаунта в заголовке Authorization: Bearer в каждом запросе. Токены выдаются на аккаунт; эндпоинта, который обменивает логин и пароль на токен, нет. Если токен отсутствует или недействителен, возвращается код 401. Храните токен на своих серверах и никогда не размещайте его в коде браузера или мобильного приложения.
Какой базовый URL и есть ли отдельная песочница?
Все вызовы идут на https://api.broadnet.me без префикса версии. Тест и продакшн используют один базовый URL: тестовые доступы отправляют сообщения только на ваши верифицированные номера, а продакшн включается для аккаунта после согласования отправителей, поэтому ваш код не меняется.
Как получать отчёты о доставке?
Статусы отправляются на URL вебхука, настроенный для вашего аккаунта: SUBMITTED, SENT, DELIVERED, READ (в каналах, которые сообщают о прочтении), FAILED и REJECTED. Статусы также можно запрашивать, например через GET /sms/list для массовых SMS-заданий и GET /whatsapp/message/bulk-insights для пакетов WhatsApp.
Как обрабатывать повторные попытки и дубликаты?
Повторяйте только запросы с сетевыми ошибками, ответами 429 и 5xx, с экспоненциальной задержкой и джиттером, а ошибки 4xx никогда не повторяйте без изменений. API не принимает ключ идемпотентности, поэтому фиксируйте каждую отправку до её выполнения, сохраняйте возвращённый ID сообщения и после тайм-аута проверяйте статус, прежде чем отправлять снова.
Какие действуют лимиты запросов?
Документированные значения по умолчанию: 200 запросов в секунду для REST с пиками до 500 на срок до 60 секунд, 1 000 сообщений в секунду на одно SMPP-подключение и 50 запросов в секунду для проверки номеров. Лимиты вашего аккаунта подтверждаются вместе с выдачей доступов. При превышении лимита возвращается код 429 с заголовком Retry-After.
Какие языки программирования поддерживаются?
Любой язык, который умеет делать HTTPS-запросы. Есть официальный TypeScript SDK, @broadnet/cpaas-sdk, а в документации приведены примеры обычных HTTP-запросов для cURL, Node.js, Python, PHP, Java, .NET, Go и Ruby. Клиент также можно сгенерировать по публичной спецификации OpenAPI 3.1 на /developers/openapi.json.
Что выбрать для SMS: REST или SMPP?
REST подходит для большинства приложений и даёт доступ ко всем каналам через один API. SMPP v3.4 поверх TLS подходит для стабильно больших объёмов SMS, особенно если у вас уже есть SMPP-клиент. Подключения, пропускная способность и белые списки IP настраиваются для вашего аккаунта, а использовать можно оба варианта на одном аккаунте.
Можно ли перепродавать сообщения через API?
Да. Реселлеры используют тот же API под своим брендом. У каждого субаккаунта свой баланс, имена отправителей, пользователи и вебхуки, а API для реселлеров позволяет создавать аккаунты, пополнять баланс, получать тарифные сетки и отчёты. Укажите перепродажу в заявке на доступ, и мы вместе настроим структуру.
Руководства по теме
- ИнтеграцииРуководство по интеграции API сообщений: REST, SMPP, вебхуки9 мин чтения
- МаркетингОтправлено, доставлено, прочитано, ошибка: статусы сообщений8 мин чтения
- ИнтеграцииКак подключить CRM к омниканальному инбоксу через вебхуки8 мин чтения
- SMS и OTPOTP-сообщения в WhatsApp и SMS: безопасность, доставка, фрод9 мин чтения
- WhatsAppКоды ошибок WhatsApp Cloud API: значения и способы исправления8 мин чтения
- SMS и OTPЧто такое A2P SMS: как бизнес-сообщения доходят до телефона8 мин чтения
Узнайте больше о платформе
Запросите тестовый доступ
Расскажите о ваших каналах, странах и объёмах. Инженер настроит тестовые доступы для ваших верифицированных номеров и поможет спланировать переход в продакшн.
Расскажите о вашем стеке и о том, что вы хотите подключить. Инженер по решениям свяжется с вами.