Регистрация зрителей через API

Через API можно регистрировать зрителей на мероприятие — массово или по одному. За один раз можно загрузить список до 10 000 зрителей.

Данные о регистрации через API попадают в отчет о мероприятии, подробнее см. Отчеты по мероприятиям.

Этап 1. Выпустите ключ API и настройте интеграцию с Толком
Этап 2. Создайте и настройте мероприятие
Этап 3. Подготовьте данные и зарегистрируйте зрителей

Этап 1

Выпустите ключ API и настройте интеграцию с Толком

В Толке перейдите в раздел «Управление» (значок ) → «API ключи».
Нажмите «Добавить».
Введите название приложения. Например, «Вебинары».
В разделе «Доступ к вебинарам» → «Регистрация зрителей» укажите разрешение «Чтение и изменение».
Нажмите «Добавить».
Скопируйте сгенерированный API-ключ и настройте интеграцию со своей системой.

Этап 2

Создайте и настройте мероприятие

Создайте и настройте мероприятие стандартным образом (подробнее см. Создание и настройка мероприятия с регистрацией).
В настройках мероприятия на вкладке «Зрители» → «Доступ к просмотру» обязательно выберите «По предварительной регистрации».
Опубликуйте лендинг.

Этап 3

Подготовьте данные и зарегистрируйте зрителей

Для выполнения API-запросов потребуется ID лендинга (landingId). Чтобы его скопировать:
1. В настройках мероприятия перейдите на вкладку «Лендинг».
2. Справа наверху нажмите «На лендинг».
3. Откроется лендинг. В адресной строке скопируйте значение после «/landings/». Это и есть ID лендинга.
  Пример: https://stream.kontur.ru/landings/e55268df-4bc0-4ecc-a9ee-a941f6d0c1aa.
Получите настройки формы регистрации с помощью специального метода. Подробнее см. в документации по API.
Подготовьте данные о зрителях в своей системе в соответствии с настройками формы регистрации из предыдущего пункта.
Руководствуясь документацией по API, зарегистрируйте зрителей. Подробнее см. Как зарегистрировать зрителей списком и Как зарегистрировать одного зрителя.
После регистрации зрителям придет письмо об участии в мероприятии.
При регистрации по API можно управлять возможностью отправки письма, передавая параметр isNotificationEnabled:
- при значении true письмо будет отправлено,
- при значении false письмо не отправится. Вам необходимо будет проинформировать зрителей самостоятельно.