Пересылка данных (вебхук) по старту/завершению вебинара

POST-запрос типа application/json

Тело запроса содержит поля:

  • event
    название события: webinarStart, webinarEnd
  • roomid
    идентификатор комнаты
  • webinarId
    идентификатор сеанса
  • stat
    Единовременный максимум зрителей  (для события webinarEnd)
  • len
    Длительность вебинара в минутах (для события webinarEnd)

Пример:

{
  "event": "webinarEnd",
  "roomid": "12345:test",
  "webinarId": "12345:test*2019-01-28T20:00:00",
  "stat": 42,
  "len": 120,
}

Если вы попали на эту страницу не по ссылке из настроек комнат, то ниже узнаете, где и как настраивается отправка данных вебхуков.

Пересылку данных можно настроить как для всех комнат сразу (1), так и для конкретной комнаты (2).

1. На странице Вебинарные комнаты перейдите во вкладку Домен и общие параметры.

Откройте блок Вебхуки.

Вебхуки отправляются при наступлении соответствующих событий. Если с началом вебинара всё понятно, то данные об окончании вебинара пересылаются только после того, как будет создан отчет о вебинаре.

Хотя название вебхука - “Создание отчета”, он не передает информацию из отчета, а только данные, указанные в начале статьи.
Чтобы передать данные по отчету, воспользуйтесь API.
Документация здесь:
 https://blog.bizon365.ru/api/v1/webinars/reports/  

В поле Адрес обработчика укажите URL-адрес, куда должен отправляться вебхук. Для вебхука “Создание отчета” можно задать два разных адреса.

Затем выберите, какой из адресов обработчика будет иметь больший приоритет - указанный здесь или указанный в настройках комнаты.

По кнопке описание формата вы перенесетесь на данную страницу.

 

2. Чтобы добавить адрес обработчика вебхука в конкретной комнате, откройте её настройки. Перейдите на вкладку РазноеПосле вебинара.
Пропишите ссылки в соответствующих полях. По указанному здесь адресу вебхук отправится в первую очередь, если настройки делались также и в Общих параметрах и был выбран пункт URL из комнаты имеет больший приоритет.

 

Вебхуки отправляются в автоматическом режиме и отправить их повторно вручную возможности нет.
Если при отправке вебхука произойдет ошибка, на странице вебинарных комнат появится уведомление.

Кнопка Смотреть детали переадресует вас на страницу Мониторинг очередей. Перейдите на вкладку Вебхуки. Здесь вы можете увидеть все данные вебхука и чем вызвана ошибка.

Вебхук считается успешно отправленным, если сервер-получатель отвечает кодом 200.
Если код ответа отличается от 200, будет происходить повторная отправка с увеличивающимся интервалом - 1, 5, 15, 60, 120, 240, 480 минут. После последней попытки задача перестаёт отправляться автоматически. 
Если сервер-получатель не отвечает на первый запрос (появляется ошибка ETimedOut), то повторной отправки не будет. 

В раздел Мониторинг очередей всегда можно перейти в   Личном кабинете → вкладка Мониторинг.

Если раздел Мониторинг пуст, это означает, что все вебхуки были доставлены по назначению.