Приём уведомлений
Очередь, вебхук, подписки с подписью и управление очередью
- Как получать уведомленияОчередь, вебхук и подписки — чем отличаются, что выбрать, какие уведомления приходят и что гарантирует Gratio.
- receiveNotificationЗабрать следующее уведомление из очереди канала долгим опросом — без публичного адреса у приложения.
- deleteNotificationПодтвердить обработанное уведомление и открыть очереди путь к следующему.
- ВебхукПринимать уведомления на свой сервер — обработчик на Python, Node.js или PHP, проверка токена, ответ, повторы и дубли.
- subscriptionsКопия всех уведомлений канала для второй системы — свой адрес, подпись HMAC-SHA256, порядок и повторы.
- Проверка подписиКак проверить X-Gratio-Signature у доставки подписки — алгоритм, готовые функции на Python, Node.js и PHP и тестовый пример.
- getWebhooksCountСколько уведомлений ждут в очереди канала — для проверки, что приложение успевает.
- clearWebhooksQueueПодтвердить все ждущие уведомления канала разом — когда старая лента уже не нужна.
- getDeadNotificationsУведомления, которые вебхук так и не принял, — с причиной и числом попыток.
- requeueDeadNotificationsВернуть отравленные уведомления в очередь после того, как обработчик починили.
- Очередь исходящихshowMessagesQueue, getMessagesCount и clearMessagesQueue — для совместимости с Green API; отправка в Gratio синхронная.