Документация для разработчиков

One API. Every Channel.

Подключайте все маршруты сообщений через единый API и получайте входящие события через стандартный Webhook.

Начало работы

Введение

UnifyPort — это один REST API плюс один стандартный поток webhook-событий для Telegram, WhatsApp, LINE, X (ранее Twitter), Zalo и TikTok. Отправляйте через POST /v1/messages, получайте всё в виде нормализованных событий — SDK отдельных провайдеров не требуются, а для Node.js, PHP, Go и Python доступны официальные SDK UnifyPort.

Обзор

Рабочая область

Ваша граница изоляции. Заголовок X-Api-Key соответствует ровно одной рабочей области и даёт к ней полный доступ — ID workspace передавать в теле запроса не нужно.

Аккаунт

Один вход в канал = одно виртуальное устройство. Создайте аккаунт через API, авторизуйте его потоком, который поддерживает провайдер (QR, код или импорт сессии), затем отправляйте и получайте сообщения через него.

Среда выполнения

Живой процесс соединения (runtime) за каждым аккаунтом. Он запускается автоматически после успешной авторизации; его состояние доступно как runtime_status. Полную машину состояний см. в разделе «Жизненный цикл аккаунта».

Webhook

Точка для долговременного хранения входящего трафика. В UnifyPort нет REST API чтения истории сообщений и гарантированного повтора пропущенных доставок, поэтому сначала зарегистрируйте webhook и сохраняйте события при получении. WhatsApp HistorySync может дать ограниченную best-effort непрерывность после bootstrap или reconnect, но это не полный архив.

Проверка API-ключа

Shell
curl https://api.unifyport.ai/v1/workspace \
  -H "X-Api-Key: <YOUR_API_KEY>"

Примечания

  • Базовый URL: https://api.unifyport.ai. Все эндпоинты /v1 аутентифицируются заголовком X-Api-Key.
  • UnifyPort сейчас доступен избранным клиентам. Свяжитесь с командой, чтобы получить доступ к рабочей области и ваш первый API-ключ.
  • JSON success and error responses carry a top-level request_id; requests with no response body, such as successful 204 deletes, expose it only through the X-Request-Id response header. Quote that value when reporting issues. Send your own X-Request-Id request header and it is echoed as client_request_id in JSON responses for client-side reconciliation.

Дальнейшие шаги

Быстрый старт

От пустого workspace до первого сообщения WhatsApp и первого входящего события.

Возможности провайдеров

Какие типы сообщений, действия и события каждый канал реально поддерживает сегодня.

Получение событий

Заголовки доставки, проверка HMAC-подписи, повторные попытки и гарантии порядка.

Справочник ошибок

Конверт ошибки и все машиночитаемые коды ошибок, сгруппированные по HTTP-статусу.