Реєстрація на курс

register_customer_on_course(tariff_id, email, email_notification, period, reregistration)

Приклад: register_customer_on_course(123, email, 1, "", True)

Щоб клієнти отримували електронні листи, передайте 1 у параметр email_notification.

Якщо ви не надішлете 1, то клієнти не отримуватимуть електронні листи!

Як надати доступ до курсу через Telegram Web App?

Для цього вкажіть функцію в Калькуляторі блоку

access_course_from_webapp(text, button_label)
Під час використання функції студент входить у Telegram і отримує доступ до курсу. Для подальшого навчання студенту не потрібно вводити ім'я користувача та пароль, оскільки авторизація вже виконана.

Параметри функції:

text - це текст повідомлення, яке отримає клієнт. Параметр можна вказати у змінній, записавши її в полі Калькулятора перед викликом функції, або вказати в самій функції в лапках.

button_label - це текст на кнопці Web App. Ви можете вказати параметр або у змінній, або в самій функції. У другому випадку параметр записується в лапках.

Це актуально ТІЛЬКИ для роботи з Telegram-ботом.

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

Результат виконання функції:

Ця кнопка відкриває сторінку з курсами/тарифами, які є у студента.

Якщо клієнт не прив'язаний до облікового запису студента, функція повертає 'client not attached to customer'.

Щоб створити таке з'єднання, достатньо записатися на курс через бота.

Як надати доступ до курсу через бота

register_customer_on_course()

Для цього вкажіть функцію в Калькуляторі блоку

register_customer_on_course(tariff_id, email, email_notification, period)

Обов'язкові параметри Необов'язкові параметри
! tariff_id - ID тарифного плану. Ви можете скопіювати його в рядку браузера в налаштуваннях тарифного плану. email_notification - Цей параметр надсилає студенту електронний лист про його реєстрацію на курс, якщо це увімкнено.
! email - електронна адреса клієнта. Ви можете вказати конкретне значення або змінну, в якій записана електронна адреса клієнта. period - обмеження терміну дії тарифного плану. Підтримуються формати дат: %d.%m.%Y %H:%M або %d.%m.%Y Приклад: period = '15.08.2023 11:00'

Щоб клієнти отримували електронні листи, ви повинні передати 1 у параметр email_notification.

Якщо ви не надішлете 1, **то клієнти **не отримуватимуть електронні листи!

Призначте функцію змінній.

Після виконання у змінну буде записана одна з відповідей:

customer is already on tariff - якщо тарифний план існує або доступ закрито вручну

wrong_tariff_id - вказано недійсний id

tariff_added - Тарифний план додано студенту

Приклад:

Як перевірити наявність доступу до курсу

has_customer_tariff(tariff_id)

Для цього вкажіть функцію в Калькуляторі блоку has_customer_tariff(tariff_id, email)

Обов'язкові параметри Необов'язкові параметри
! tariff_id - ID тарифного плану. Ви можете скопіювати його в рядку браузера в налаштуваннях тарифного плану або в розділі Тарифні плани. email - необов'язковий параметр. Передайте цей параметр, щоб перевірити, чи зарахований клієнт на курс із вказаною електронною адресою.

Після виконання функція повертає True або False.

Можливі відповіді функції у разі помилок:

wrong tariff_id - передано некоректне значення tariff_id

customer not found - користувач не зареєстрований як студент.

Як зареєструвати клієнта на платформі БЕЗ надання доступу до курсу

register_customer(email)

Для цього вкажіть функцію в Калькуляторі блоку register_customer(email)

Параметри функції Опис
! email електронна адреса клієнта.

Ви можете вказати змінну у функції або значення параметрів. Щоб вказати змінну, напишіть її назву без лапок, синтаксичних знаків, ґрат і фігурних дужок. Щоб вказати конкретне значення, вкажіть електронну адресу клієнта в лапках.

Рекомендується призначити змінну функції, щоб ви могли бачити результат роботи функції та працювати з ним. Приклад на скріншоті нижче: назва змінної встановлюється перед знаком рівності, після чого йде функція та параметр у дужках.

Після успішного виконання функції у змінну буде записано відповідь:
customer created

Як перевірити доступ до курсу та обмеження за часом?

Для цього вкажіть функцію в Калькуляторі блоку has_customer_tariff_with_date(tariff_id, email), щоб перевірити наявність доступу до курсу за електронною адресою (повертає детальну відповідь про наявність доступу та часові обмеження).

Параметри функції:

Обов'язковий параметр Необов'язковий параметр
! tariff_id - ID тарифного плану. Ви можете скопіювати його в рядку браузера в налаштуваннях тарифного плану або в розділі Тарифні плани. email - необов'язковий параметр.

Відповідь буде:

  • студент зарахований і є обмеження доступу за часом: Має доступ до 2023-09-28 22:00:00
  • студент зарахований, обмежень немає: Має доступ без обмеження часу
  • студент не зарахований: Немає доступу до цього тарифу

Можливі відповіді функції у разі помилок:

wrong tariff_id - передано некоректне значення tariff_id

customer not found - користувач не зареєстрований як студент.

Як видалити доступ до курсу студента через бота

del_customer_from_course(course_id, email)

Для цього вкажіть функцію в Калькуляторі блоку del_customer_from_course(course_id, email)

Параметри Опис
! tariff_id ID тарифного плану
! email електронна адреса клієнта

Як перевірити, чи був студент на вебінарі

customer_was_on_translation()

Доступ до курсу потрібно надати в боті.

Для цього існує функція register_customer_on_course() і access_course_from_webapp()

Щоб перевірити, чи був студент на вебінарі чи ні, вкажіть функцію в Калькуляторі блоку customer_was_on_translation(translation_guid, email, after_start_time)

Обов'язкові параметри Необов'язковий параметр
! translation_guid - ID трансляції. Скопіюйте значення поля Назва знаходиться в посиланні налаштувань трансляції after_start_time - час початку трансляції у форматі: '2023-04-18 13:30:00'.
! email - Електронна адреса студента

Зверніть увагу! Назва змінної може бути будь-якою, зручною та зрозумілою для вас. У разі помилки в написанні параметрів функції, у змінну буде записано повідомлення: wrong translation_guid

У цьому випадку ми рекомендуємо перевірити параметри функції та протестувати їх знову. Щоб отримати значення тривалості перебування на вебінарі зі змінної в Калькуляторі, ви можете використовувати функції роботи з масивами та словниками. посилання/посилання масивами та словниками.

Приклад налаштувань у Калькуляторі блоку:

time_spent1 = answer2[0]['time_spent']

Як знайти ім'я студента, прив'язаного до бота?

Бувають випадки, коли студенти можуть бути прив'язані до онлайн-чату особистого кабінету студента, а також ті, хто прив'язаний до месенджера і пише вашим керівникам через бота. Щоб правильно видавати іменні сертифікати про завершення курсу в боті та не шукати ім'я студента в списку, існує функція:

get_customer_name() - повертає ім'я студента, прив'язаного до клієнта.

Функція без параметрів.

Повертає ім'я студента, яке студент вказав під час реєстрації на курс, або ім'я студента з його особистого кабінету.