Концепции
MassAccess API позволяет отправлять сообщения клиентам через популярные мессенджеры, отслеживать статусы доставки и управлять номерами телефонов — всё через единый интерфейс.
Архитектура
Ваш сервер отправляет запрос к MassAccess API. После проверки ключа и валидации сразу возвращается ответ 202 Accepted с event_id и статусом new. Затем MassAccess асинхронно доставляет сообщение пользователю и отправляет webhook-нотификацию на ваш сервер с результатом доставки.
Базовые концепции
Боты
Бот — это канал отправки сообщений. Каждый бот привязан к конкретному мессенджеру (Telegram, MAX) и имеет уникальный токен.
Клиенты
Клиент — это получатель сообщений, идентифицируемый по номеру телефона. Клиент может быть привязан к нескольким ботам.
Нотификации
Уведомления о статусе доставки отправляются на ваш сервер через HTTP POST запросы. Вы получаете события в реальном времени.
Жизненный цикл сообщения
| Код | Описание |
|---|---|
| new | Сообщение создано, ещё не обработано |
| processing | Сообщение обрабатывается системой доставки |
| sent | Сообщение отправлено в мессенджер |
| failed | Ошибка доставки сообщения |
Формат номера телефона
Все номера телефонов должны состоять из 11 цифр, соответствуя шаблону ^\d{11}$. Пример: 12345678901.
Типы сервисов
| Код | Описание |
|---|---|
| telegram | Мессенджер Telegram |
| max | Корпоративный мессенджер MAX |
Политика повторных отправок webhook
MassAccess повторяет доставку при тайм-ауте, сетевой ошибке, HTTP 408/425/429 и 5xx с ограниченной экспоненциальной задержкой и full jitter. Любой ответ 2xx подтверждает получение; остальные 4xx являются постоянной ошибкой.
Ограничение частоты запросов
API-запросы ограничены по частоте для каждого API-ключа. При превышении лимита API возвращает HTTP 429 с заголовком Retry-After. Текущие лимиты: 100 запросов в секунду на API-ключ.