$pushgate.createPushback
Метод создает специальную сущность для обработки событий — пушбэк.
подсказка
Пушбэк используется для отправки событий в сценарий при каких-либо действиях в стороннем сервисе. Таким образом при помощи бота становится возможным создавать исходящие рассылки.
Рассмотрим принцип работы пушбэков:
- В сценарии вызывается метод
$pushgate.createPushback
. При вызове в метод передаются идентификаторы нужного диалога и строка, определяющая тип события, напримерmyEvent
. - Пушбэк регистрируется в платформе. Ему присваивается уникальный идентификатор
pushbackId
, который можно использовать в запросах к методам GET и POST/push_{pushbackId}
Pushgate API. - Когда в стороннем сервисе происходит событие, о котором необходимо уведомить клиента при помощи бота, сервис делает HTTP-запрос к методу
/push_{pushbackId}
, чтобы активировать пушбэк. - Пушбэк генерирует в диалоге с клиентом заданное ранее событие
myEvent
, которое можно обработать при помощи тегаevent
и отправить нужную информацию в диалог.
предупреждение
Пушбэк привязан к диалогу с клиентом в определенном канале. Чтобы клиент получал уведомления в нескольких каналах, он должен дойти до соответствующего места сценария в каждом из них.