Оглавление
Концепции
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 повторяет неудавшиеся доставки webhook с экспоненциальной задержкой: 1с, 5с, 25с, 125с, 625с (до 5 попыток). Ваш сервер должен вернуть HTTP 200 для подтверждения получения.
Ограничение частоты запросов
API-запросы ограничены по частоте для каждого API-ключа. При превышении лимита API возвращает HTTP 429 с заголовком Retry-After. Текущие лимиты: 100 запросов в секунду на API-ключ.