Перейти на сайт

Зарегистрировать на мероприятие

POST /eventsessions/{eventsessionID}/register

Запросом можно регистрировать участника так, словно он регистрируются самостоятельно.

Если Email ранее регистрировался, то новые данные будут проигнорированы. Использоваться будут существующие данные.

МЕТОД HTTP

POST 

URL

https://userapi.mts-link.ru/v3/eventsessions/{eventsessionID}/register

ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

  • email — электронная почта участника.

  • additionalFields[{Field_Key}] — дополнительные поля формы регистрации. Если такие поля добавлены на вебинаре, то они являются обязательными. Но если дополнительных полей не добавлялось, то указывать этот параметр не требуется!

    Ключ поля (Field_Key) определяет, к какому именно полю относится параметр. Получить ключ можно запросом GET /eventsessions/{eventsessionID}.
    ​Внимание! Любые поля, отличные от Имени, Фамилии и Почты - дополнительные!

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

  • name — имя участника;

  • secondName — фамилия участника;

  • nickname — имя в чате. Никнейм пользователя, который будут видеть другие участники, когда он будет писать в чате.
    По умолчанию:  "name secondName";

  • role — роль участника на этом мероприятии. Значения:
    - ADMIN
    - LECTURER
    - GUEST
    ​Подробнее о ролях.
    По умолчанию: GUEST.

  • isAutoEnter — автовход в вебинар.
    Флаг определяет что будет происходить после запуска вебинара: участник попадет в комнату автоматически или должен будет ввести свое имя в чате и нажать "ПОДКЛЮЧИТЬСЯ".  Значения:
    - true — автовход в вебинар сразу после его начала;
    - false — вывод формы "Как к Вам обращаться в чате" сразу после начала вебинара.
    По умолчанию: false;

  • isAccepted — флаг, отвечающий за автоматическое одобрение участника в мероприятиях с access=8 или 10 (где включена ручная модерация, подробнее). Значения:
    - true — участник будет автоматически одобрен;
    - false — участника необходимо будет одобрить вручную.
    По умолчанию: false;

  • sendEmail — рассылка писем с платформы mts-link.ru.  
    Флаг определяет отправку письма "Вы зарегистрированы на вебинар". Значения:
    - true — письмо будет оправлено;
    - false — письмо отправлено не будет.
    По умолчанию: true;

  • avatar — фото участника. URL картинки, который будет использован в качестве аватара;

  • pattrName — отчество участника. Будет доступно в разделе Люди;

  • description — описание к карточке пользователя. Будет доступно в разделе Люди;

  • phone — телефон участника. Будет доступно в разделе Люди;

  • organization — организация участника. Будет доступно в разделе Люди;

  • position — должность участника. Будет доступно в разделе Люди;

  • sex — пол участника. Будет доступно в разделе Люди.

ПОЛЯ ОТВЕТА

  • participationId — ID участника. Используется для получения статистики и изменений роли в мероприятии;

  • link — уникальная ссылка для входа в вебинар;

  • contactId — ID этого контакта из раздела Люди. Возвращается только в случае, если Email ранее не был зарегистрирован на мероприятия организации.
    ​

ПРИМЕР ЗАПРОСА

url: https://userapi.mts-link.ru/v3/eventsessions/{eventsessionID}/register,
method: POST,
headers: 
{
    x-auth-token: {Token},
    Content-Type: application/x-www-form-urlencoded
  },
data: 
{
    email: i.ivanov@weinar.ru,
    secondName: Иванов,
    name: Иван,
    additionalFields[{Field_Key1}]: Петрович,
    additionalFields[{Field_Key2}]: От друзей и знакомых,
    nickname: Ваня из отдела продаж,
    role: GUEST,
    isAutoEnter: true,
    sendEmail: false,
    avatar: https://events-storage.webinar.ru/api-storage/224x199/files/webinar/2019/03/29/K9YNmaAbdTmN4g5G6GT2Usx3zkDlGhYxRD5RLtGnm2VO1ocM.jpg"
  }
};

   
ПРИМЕР ОТВЕТА

{
  participationId: 62522169,
  link: https://events.webinar.ru/supportservice/2356695/97683fed47e6f1cfbe325664bfce94c23,
  contactId: 48584027
}
👆 На этом пока всё