Наиболее частое использование — создание кнопки “Зарегистрироваться” на сайте клиента, которая бы регистрировала участников в один клик.
Реализовать такую кнопку можно в один запрос - POST /eventsessions/{SessionID}/register
.
Внимание! При регистрации обязательно должны быть заполнены все дополнительные поля!
Один email можно зарегистрировать только один раз.
Запрос
POST https://userapi.webinar.ru/v3/eventsessions/{SessionID}/register
Headers
x-auth-token: {{Token}}
Content-Type: application/x-www-form-urlencoded
Body
email:i.ivanov@we.study
name:Иван
secondName:Иванов
additionalFields[{Field_Key2}]:Иванович
additionalFields[{Field_Key1}]:От коллег и партнеров по работе
role:GUEST
isAutoEnter:true
sendEmail:false
Ответ
201 Created
{
"participationId": 60680825,
"link": "https://events.webinar.ru/supportservice/2356695/984cfa0309b5d716479a6fbf2b3c7fea",
"contactId": 47274803
}
Пояснения
{EventsessionID} — идентификатор вебинара, полученный в предыдущем запросе.
additionalFields[{Field_Key2}] — значение дополнительных регистрационных полей.
{Field_Key} — уникальный ключ регистрационного поля. Можно получить запросом GET eventsessions/eventsessionID.
role — роль участника в вебинаре. GUEST - участник с правами простого участника. Подробнее про роли.
isAutoEnter — включение автовхода в вебинар. При значении true форма ввода имени в чате не требуется. То есть сразу после начала вебинара участник моментально попадает в комнату
sendEmail — выключение письма "Вы зарегистрированы на вебинар". Актуально в случае, если вы хотите избежать лишних писем на почту и планируете вставлять ссылку в свои собственные письма.
participationId — идентификатор участника этого вебинара. Используется в запросах на реактирования роли.
link — персональная ссылка участника.
Ссылку можно:
- рассылать индивитуально на почту участнику;
- вставлять в личный кабинет участников.
Результат
Участник с почтой i.ivanov@we.study попадает в список вебинара с заданной ролью и сможет попасть в него сразу после запуска вебинара:
