Персональні посилання учасника: лист, «Увійти через бота» і чому це одна людина

У кожного учасника вебінару — своє посилання в кімнату. Воно несе особу: за ним сервіс знає, хто прийшов, скільки дивився, що натискав і чи купив. Тому це посилання й потрапляє в лист «Ви зареєстровані», у нагадування і на сторінку «дякую».

Ця сторінка пояснює три речі:

1. які персональні посилання бувають і де вони зʼявляються;
2. де робиться лист — бо листи шлете ви, а не сервіс;
3. що відбувається, коли людина з листа натискає «Увійти через бота», — і чому після цього в сервісі вона одна, а не дві.

1. Посилання в кімнату. Вигляд: https://live.sviteya.ai/<код вебінару>?t=<особистий ключ> (або на вашому домені, якщо він підключений). Це головне посилання. Воно є:

• на сторінці «Дякую» одразу після реєстрації;
• у віджеті реєстрації на вашому сайті;
• у вебхуку вебінару — полем room_link (див. нижче) — саме звідти воно потрапляє в ваш лист;
• у нагадуваннях, які шле воронка в боті.

2. «Увійти через бота». Зʼявляється тоді, коли доступ у кімнату — за умовами (на вкладці «Реєстрація» блок «Хто може увійти в кімнату» → «Лише хто відповідає умовам»: має тег, активна підписка на товар, учасник каналу чи групи). Людина відкриває посилання з листа, а сервіс ще не знає її Telegram — перевірити умову нема як. Тому замість кімнати вона бачить сторінку «Тільки для учасників» (за замовчуванням із заголовком «Цей етер — лише для учасників»; заголовок, текст і кнопку ви змінюєте в налаштуваннях доступу) та кнопкою «Увійти через бота». Кнопка веде в ваш бот; бот звіряє умову вже по Telegram того, хто натиснув, і шле одноразове посилання в кімнату (діє 60 секунд, переслати його комусь безглуздо).

Цю кнопку в лист вставляти не треба — її додає сама сторінка. У листі має бути лише посилання в кімнату.

3. «Нагадування в Telegram». Кнопка на сторінці «Дякую» і у віджеті (такий підпис за замовчуванням). Веде в бот; після натискання бот знає, що це той самий учасник, і нагадування про етер ідуть йому в Telegram. Так само поводяться кнопки міні-лендингу «успішна реєстрація», що ведуть у бот: сервіс сам додає до них особистий хвіст.

Усі три посилання — особисті. Переслане посилання не відкриє чужий доступ: кімната за умовами перевіряє Telegram того, хто натиснув, а не того, кому лист надіслали.

Sviteya листів учасникам не шле. Лист «Ви зареєстровані» і поштові нагадування робить ваш поштовий сервіс (SendPulse, MailerLite, Mailchimp, GetResponse — будь-який), а наші дані приходять до нього вебхуком вебінару.

Відкрийте вебінар → вкладка «Інтеграції» → блок «Вихідні вебхуки» → «Додати вебхук». Впишіть адресу, куди слати дані (адресу дає ваш поштовий сервіс, Zapier, Make або n8n), і виберіть події:

• participant.registered — одразу після реєстрації. Для листа «Ви зареєстровані».
• reminder.due — за N хвилин до старту. Час береться з поля «За скільки хвилин до старту (через кому)» у блоці «Нагадування» на тій самій вкладці (за замовчуванням 1440, 60, 15 = за день, за годину, за 15 хвилин). Для поштових нагадувань.

Кожен запит підписаний секретом (підпис HMAC-SHA256 у заголовку x-sviteya-signature; назву події сервіс додає в заголовок x-sviteya-event). Якщо адреса не відповідає успіхом, сервіс пробує до 5 разів із наростаючою паузою (1, 2, 4, 8 хвилин). Адреса, яка поспіль провалила 10 доставок, ставиться на паузу автоматично.

Всього подій вебхука вісім: ще participant.joined, participant.left, participant.no_show, button.click, poll.vote і webinar.ended; для листа потрібні перші дві.

{
  "event": "participant.registered",
  "time": "2026-09-15T10:00:00.000Z",
  "webinar": {
    "id": "…",
    "name": "Запуск курсу",
    "code": "x7k2p",
    "type": "live",
    "lang": "uk",
    "status": "scheduled",
    "start_at": "2026-09-20T16:00:00.000Z",
    "start_date": "2026-09-20",
    "start_time": "19:00",
    "timezone": "Europe/Kyiv",
    "duration_min": 90,
    "youtube_url": null,
    "room_origin": "https://live.sviteya.ai",
    "hosts": [{ "user_id": "…", "name": "Олена", "title": "ведуча" }],
    "reminders": [1440, 60, 15]
  },
  "participant": {
    "id": "…",
    "name": "Марина",
    "email": "marina@example.com",
    "phone": null,
    "person_id": "…",
    "source": "site",
    "marks": { "utm_source": "instagram" },
    "fields": [{ "id": "…", "name": "Місто", "value": "Львів" }],
    "calendar_link": "https://live.sviteya.ai/api/public/webinars/room/wpt_…/calendar.ics"
  },
  "room_link": "https://live.sviteya.ai/x7k2p?t=wpt_…",
  "data": {}
}

Що тут головне для листа:

• webinar.start_date і webinar.start_time — дата й час етеру в часовому поясі вебінару (webinar.timezone), уже окремими рядками: підставляйте як є, нічого перераховувати не треба. start_at — та сама мить в UTC, якщо ваш сервіс уміє форматувати сам. Для автовебінару за розкладом тут найближчий етер; для вебінару «прямо зараз» дати немає — поля порожні (null).
• webinar.type — live (живий етер), once (автовебінар на дату), recurring (за розкладом), jit («якраз вчасно»), instant («прямо зараз»). duration_min — тривалість у хвилинах.
• participant.fields — відповіді форми реєстрації з назвами полів: для персоналізації листа не треба тримати у себе довідник id.
• participant.person_id — id Персони людини: у злитої людини він один на всі її картки й канали. Якщо ви вішаєте автоматизацію на своєму боці, орієнтир — саме він.
• webinar.hosts — ведучі з вашої команди; user_id стабільний, імʼя можна перейменувати.

Цей самий блок webinar приходить у кожній події вебхука, не лише в реєстрації. Блок participant і room_link є в подіях, де є конкретний учасник; у webinar.ended їх нема.

У reminder.due те саме, плюс data.offsetMin (за скільки хвилин до етеру) і data.startAt; дата й час самого етеру вже є в webinar.start_date / start_time. Гостям вільного входу нагадування не шлеться.

У шаблон листа підставляйте:

• імʼя — participant.name;
• дату й час етеру — webinar.start_date і webinar.start_time (це вже пояс вебінару);
• посилання в кімнату — room_link. Це і є кнопка «Увійти на вебінар» у листі;
• «Додати в календар» — participant.calendar_link: файл .ics із подією на цю людину.

Приклад:

Марино, ви зареєстровані на «Запуск курсу». Етер — webinar.start_date о webinar.start_time (webinar.timezone). Увійти на вебінар → room_link Додати в календар → participant.calendar_link Посилання особисте — не пересилайте його.

Нічого іншого в лист класти не треба: якщо кімната за умовами, сторінка сама покаже «Увійти через бота»; якщо ні — посилання одразу відкриє кімнату.

Якщо вебінар із вільним входом (без реєстрації), персональних посилань і вебхуків про глядачів немає: усі вони гості.

Тоді лист узагалі не потрібен: сервіс знає Telegram людини від початку, нагадування шле воронка в боті (тригер «Вебінар» із подією «Зареєструвався» плюс ланцюжок нагадувань «за день / за годину / за 10 хвилин»), а посилання в кімнату — в повідомленні бота.

Візьмемо Марину. Вона зареєструвалась на сайті поштою — у сервісі є картка учасника і Персона «Марина» з поштою. Telegram її сервіс ще не знає.

Марина відкриває лист, натискає посилання, бачить «Тільки для своїх», натискає «Увійти через бота». У боті на неї заводиться контакт — і в нього своя Персона, теж «Марина», але з Telegram.

Особисте посилання з листа, натиснуте своїм Telegram, — це доказ, що це одна людина. Тому сервіс за одним натисканням:

1. зливає дві Персони в одну. Головною лишається старша (та, що зареєструвалась першою). Переїжджає все: пошта і Telegram, угоди, значення полів, контакт у боті з його тегами, балами й підписками, докази згоди, історія в журналі. Нічого не губиться і не дублюється;
2. записує Telegram у картку учасника — тепер нагадування, тригери «Вебінар» і кнопки в кімнаті знають, кому слати;
3. шле одноразове посилання в кімнату, якщо умова доступу виконана. Якщо ні — текст із налаштувань доступу (і, за бажанням, старт воронки).

Те саме відбувається за кнопкою «Нагадування в Telegram», за кнопками лендингу «успішна реєстрація» і за пропозицією AI-помічника з чату кімнати.

Буває: спершу поштою на сайті, потім ще раз через бота. У вебінарі виникають дві картки однієї людини. Щойно зʼявляється доказ, що це одна людина (натиснула посилання з листа своїм Telegram або назвала в боті ту саму пошту), сервіс зливає картки в одну — старшу. Хвилини перегляду, кліки, голоси й відповіді форми складаються; порожнє в старшій картці заповнюється з молодшої, відповіді форми — новіша перемагає.

Обидва посилання лишаються робочими — і те, що в листі, і те, що в чаті бота. Куди б людина не натиснула, вона потрапить у кімнату під однією карткою.

У звітах ця людина — один рядок. У «Персонах» — одна Персона.

Останній рядок — захист від пересланих посилань: подруга Марини, натиснувши «Увійти через бота» з Марининого листа, не стане Мариною. Сервіс просто перевірить умову доступу по Telegram подруги.

Злиття незворотне — так само, як і ручне злиття в «Персонах».

Чи можна вставити в лист кнопку «Нагадування в Telegram»?

У вебхуку такого посилання немає — є room_link і participant.calendar_link. Кнопка є на сторінці «Дякую» і у віджеті.

Людина каже, що посилання з листа «недійсне».

Найчастіше вона відкрила лист, надісланий іншій людині, або посилання пошкодилось у пересилці. Дайте їй зареєструватись ще раз тією самою поштою — сервіс не заведе дубль, а віддасть те саме посилання.

Марина реєструвалась поштою, а нагадування хоче в Telegram.

Кнопка «Нагадування в Telegram» на сторінці «Дякую» — або посилання з листа і «Увійти через бота». Після будь-якого з них сервіс знає її Telegram.

Реєстрація через бота з поштою, яку вже вказав хтось інший з іншим Telegram.

Сервіс відмовить: «Цю пошту вже вказав інший учасник». Двоє людей з однією поштою в одному вебінарі — це не дубль, а помилка, яку краще побачити одразу.

Чи бачу я, що злиття відбулось?

У журналі подій акаунта лишаються події persons_merged (Персони) і participants_merged (картки учасника) зі старими ідентифікаторами.

• Вебінари: кімната, розклад, кнопки й що видно у звіті