События (вебхуки)
В этом разделе представлена информация о событиях (вебхуках), поддерживаемых API Getloo Space. Вы узнаете, как настроить вебхуки для получения уведомлений о различных событиях, таких как получение сообщений, изменения статуса доставки и другие важные действия.
События (вебхуки) — это способ получать мгновенные автоматические уведомления о важных событиях в реальном времени. Вместо того, чтобы постоянно опрашивать сервер на предмет изменений ("а что там нового?"), вы настраиваете URL-адрес (конечную точку) на своём сервере, и мы отправляем на него HTTP-запрос с детальной информацией сразу же, как только событие происходит.
Как это работает?
Регистрация URL — Вы указываете URL-адрес вашего сервера, на который мы будем отправлять уведомления.
Мгновенная отправка события — Как только в системе происходит событие, на которое вы подписаны, мы немедленно формируем HTTP POST-запрос с деталями события в теле запроса (формат JSON) и отправляем его на ваш URL.
Подтверждение получения — Ваш сервер получает запрос, обрабатывает данные и должен вернуть в ответ HTTP-статус 200 OK. Это подтверждает, что уведомление успешно получено и дальнейшие повторные отправки не требуются.
Категории событий
Ниже представлены все доступные вебхуки, сгруппированные по функциональным категориям.
События приложений
- app.onboarded — отправляется, когда бизнес-аккаунт успешно прошел процесс онбординга и был связан с приложением. Это означает, что аккаунт готов к использованию API.
События сообщений
- message.incoming-message — входящее сообщение.
- message.outgoing-status — статус исходящего сообщения изменился.