---
title: "Один API для сообщений в восьми каналах"
description: "Один REST API для SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email и push с вебхуками, SMPP, TypeScript SDK и MCP-сервером."
canonical: "https://omnichannels.ai/ru/developers/"
language: "ru"
updated: "2026-10-10"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

# Один API для сообщений в восьми каналах

Canonical: https://omnichannels.ai/ru/developers/
Language: ru
Publisher: OmniChannels.ai by BroadNet Technologies

Отправляйте SMS, WhatsApp, RCS, Messenger, Instagram, Telegram, email и push из своего кода: один базовый URL и один Bearer-токен. Отслеживайте каждое сообщение через вебхуки, масштабируйте SMS через SMPP и давайте ИИ-агентам доступ к тому же API через MCP.

**Короткий ответ:** 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, включая одобренные шаблоны и окна для сообщений.

## Вопросы разработчиков

### Как пройти аутентификацию?

Передавайте токен доступа вашего аккаунта в заголовке 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 для реселлеров позволяет создавать аккаунты, пополнять баланс, получать тарифные сетки и отчёты. Укажите перепродажу в заявке на доступ, и мы вместе настроим структуру.

Обновлено: 2026-10-10