WebinarGeek-ті қалай орнату керек

Токенді алу үшін WebinarGeek сайтындағы аккаунт параметрлеріне өтіңіз. Оны экранның жоғарғы оң жақ бұрышынан табуға болады, және «Account» сөзін басқаннан кейін ашылмалы мәзір пайда болады, онда бірінші нұсқаны таңдау керек:

Содан кейін сол жақтағы мәзірден «API» тармағын таңдаңыз

Осыдан кейін API беті ашылады

Егер кілтті алмасаңыз, онда қолдау қызметіне хабарласып, оны сұрауыңыз керек.

Токенді алғаннан кейін Параметрлер -> Жоба тұрақтылары бөлімін ашып, оны webinargeek_token айнымалысына қойыңыз:

Чат-бот арқылы вебинарлар тізімін қалай алуға болады

Тізімді алу үшін webinargeek_get_webinar_list() функциясын шақыру жеткілікті:

Нәтижесінде вебинарлар тізімі келесі форматта болады:

['{"id":1455034,"date":"11-05-2022 18:00","name":"Second webinar"}',
'{"id":1455046,"date":"11-05-2022 18:00","name":"My Webinar"}',
'{"id":1453081,"date":"04-05-2022 18:00","name":"My first webinar"}']

мұндағы

id - трансляцияның идентификаторы (broadcast_id), бұл мән осы вебинармен басқа әрекеттер үшін маңызды
webinar date - осы трансляцияның күні мен уақыты
name - вебинар атауы

Егер функцияға қандай да бір таңба берсеңіз (ең жақсысы '1' қою), онда функция тек әлі аяқталмаған вебинарларды көрсетеді, ал егер ештеңе бермесеңіз, аяқталғандарын да көрсетеді.

Чат-бот арқылы вебинарға қалай тіркелуге болады

Тіркелу үшін webinargeek_get_webinar_list(broadcast_id, name, email) функциясы қажет, мұндағы

broadcast_id - клиентті тіркеу қажет трансляцияның идентификаторы
name - чатта көрсетілетін клиенттің аты
email - сілтемесі бар вебинарға шақыру келетін электрондық пошта мекенжайы

Бұл параметрлерсіз бот арқылы клиентті тіркеу мүмкін емес.

Мысал:
url = webinargeek_add_subscriber(1455046, 'John Smith', '[email protected]’)

Нәтижесінде бұл айнымалыда пайдаланушыға тіркелу қажет емес вебинарға сілтеме сақталады. Барлық пайдаланушы деректері осы айнымалыда орнатылады.

Сондай-ақ, функция орындалғаннан кейін клиент картасына екі айнымалы қосылады:

webinargeek_broadcast_id - пайдаланушы тіркелген трансляцияның идентификаторы
webinargeek_email - тіркеу кезінде көрсетілген электрондық пошта

Бұл айнымалылар пайдаланушының вебинарға қатысуын тексеру үшін пайдалы болады.

Чат-бот арқылы вебинарға қатысуды қалай тексеруге болады

Қатысуды тексеру үшін webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email) функциясы қажет, мұндағы

webinargeek_broadcast_id - пайдаланушы тіркелген трансляцияның идентификаторы
webinargeek_email - тіркеу кезінде көрсетілген электрондық пошта
watch_minimum - (міндетті емес параметр) функцияның қатысуды есептеу немесе есептемеу үшін анықтайтын ең аз минут саны

watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)

Айнымалыға келесі жауап қойылады:

  • Егер вебинар әлі аяқталмаған болса, онда келесі мәтін жауап ретінде келеді: “Webinar not ended yet”;
  • Егер клиент вебинарды көрмеген болса, онда келесі мәтін жауап ретінде келеді: “False”;
  • Егер клиент вебинарды көрген болса және watch_minimum параметрі пайдаланылмаса, онда келесі мәтін жауап ретінде келеді: “True”;
    Егер watch_minimum параметрі пайдаланылса, онда функция клиенттің қарау уақытын тексереді және:
    • Егер клиент ең аз мөлшерден аз қараса, онда келесі мәтін жауап ретінде келеді: “False”;
    • Егер клиенттің вебинарды қарау уақыты көрсетілген мөлшерге тең немесе одан көп болса, онда келесі мәтін жауап ретінде келеді: “True”.

Белгіленген күн мен уақыттан бастап вебинар атауы бойынша broadcast_id қалай алуға болады

Белгілі бір вебинардың broadcast_id мәнін алу үшін келесі параметрлері бар webinargeek_search_broadcast_id() функциясы қажет:

webinar_list - мұнда webinargeek_get_webinar_list() функциясының нәтижесін сақтайтын айнымалыны беру керек
webinar_name - broadcast_id мәнін табу қажет вебинардың атауы
webinar_date - dd.mm.yyyy форматындағы трансляция күні. Сондай-ақ curret_date пайдалануға болады
webinar_time - hh:mm форматындағы трансляция уақыты, мұндағы hh = сағат, mm = минут

Мысал:
webinar_list = webinargeek_get_webinar_list()
broadcast_id = webinargeek_search_broadcast_id(webinar_list, 'Second webinar', current_date-4, '18:00'

Мұнда біз ағымдағы күннен 4 күн бұрын сағат 18:00-де өткен және “Second webinar” деп аталатын трансляцияның идентификаторын табуға тырысамыз.

Егер параметрлерге сәйкес келетін вебинар тізімде болса, онда функция табылған вебинардың идентификаторын broadcast_id айнымалысына қайтарады.

Егер мұндай вебинар табылмаса, онда келесі мәтін қойылады: "No webinar with these parameters".