Обзор
Бот предоставляет две системы для real-time обновлений:- WebSocket — для real-time обновлений в веб-админке
- Webhooks — для отправки событий во внешние системы
WebSocket
Подключение
WebSocket endpoint:ws://your-api-host:port/ws
Авторизация через query-параметр:
Формат сообщений
Подтверждение подключения:Поддерживаемые события
Webhooks
Создание webhook
Поддерживаемые события
user.created— создан новый пользовательpayment.completed— завершён платёжtransaction.created— создана транзакцияticket.created— создан тикетticket.status_changed— изменён статус тикета
Заголовки запроса
Подпись payload
Если при создании webhook указанsecret, payload подписывается HMAC-SHA256:
API эндпоинты
Статусы доставки
pending— ожидает отправкиsuccess— успешно доставлен (HTTP 200-299)failed— ошибка доставки
Безопасность
- WebSocket: Требует валидный API токен
- Webhooks: Используйте HTTPS, подписывайте payload через
secret, проверяйте подпись на стороне получателя
