Cara menyediakan WebinarGeek

Untuk mendapatkan token, pergi ke tetapan akaun di WebinarGeek. Anda boleh mencarinya di sudut kanan atas skrin dan selepas anda menekan perkataan Akaun, menu lungsur akan terbuka, di mana anda perlu memilih pilihan pertama:

Kemudian pilih API dalam menu di sebelah kiri

Selepas itu, halaman dengan API akan terbuka

Jika anda tidak mendapat kunci, maka anda perlu menghubungi sokongan pelanggan dan memintanya.

Selepas anda mendapat token, buka Tetapan -> Pemalar projek dan tampalkannya dalam pembolehubah webinargeek_token:

Cara mendapatkan senarai webinar melalui chat-bot

Untuk mendapatkan senarai, cukup panggil fungsi webinargeek_get_webinar_list():

Hasilnya, akan ada senarai webinar dalam format ini:

['{"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"}']

di mana

id - adalah id siaran (broadcast_id), nilai ini penting untuk semua tindakan lain dengan
tarikh webinar - tarikh dan masa siaran ini
nama - nama webinar

Jika anda berkongsi dengan fungsi sebarang simbol (sebaiknya tampal '1'), maka fungsi akan menunjukkan hanya webinar yang belum tamat, dan jika anda tidak menampal apa-apa maka ia juga akan menunjukkan yang telah tamat.

Cara mendaftar untuk webinar melalui chat-bot

Untuk pendaftaran, anda memerlukan fungsi webinargeek_get_webinar_list(broadcast_id, name, email), di mana

broadcast_id - id siaran yang mana anda perlu mendaftarkan pelanggan
name - nama pelanggan yang akan dipaparkan dalam sembang
email - alamat e-mel yang akan dihantar jemputan ke webinar dengan pautan

Tanpa parameter ini, anda tidak boleh mendaftarkan pelanggan melalui bot.

Contoh:
url = webinargeek_add_subscriber(1455046, 'John Smith', '[email protected]')

Hasilnya, pembolehubah ini akan memegang pautan ke webinar yang mana pengguna tidak perlu mendaftar. Semua data pengguna ditetapkan dalam pembolehubah ini.

Juga, selepas pelaksanaan fungsi, dua pembolehubah akan ditambahkan ke kad pelanggan:

webinargeek_broadcast_id - id siaran yang pengguna didaftarkan
webinargeek_email - e-mel yang dinyatakan dalam pendaftaran

Pembolehubah ini akan berguna untuk menyemak kehadiran pengguna ke webinar.

Cara menyemak kehadiran webinar melalui chat-bot

Untuk menyemak kehadiran, anda memerlukan fungsi ini webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email), di mana

webinargeek_broadcast_id - id siaran yang pengguna didaftarkan
webinargeek_email - e-mel yang dinyatakan dalam pendaftaran
watch_minimum - (parameter pilihan) jumlah minimum minit yang mana fungsi mengenal pasti sama ada kehadiran dikira sebagai satu atau tidak

watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)

Balasan akan ditampal dalam pembolehubah:

  • Jika webinar belum tamat, maka teks ini datang sebagai balasan: “Webinar belum tamat”;
  • Jika pelanggan tidak menonton webinar, maka ini datang sebagai balasan: “Palsu”;
  • Jika pelanggan menonton webinar dan parameter watch_minimum tidak digunakan, maka ini datang sebagai balasan: “Benar”;
    Jika parameter watch_minimum digunakan, maka fungsi akan menyemak jumlah masa pelanggan menontonnya dan:
    • Jika pelanggan menontonnya untuk jumlah yang lebih rendah daripada yang ditetapkan sebagai minimum, ini datang sebagai balasan: “Palsu”;
    • Jika jumlah masa pelanggan menonton webinar adalah sama atau lebih tinggi daripada jumlah yang ditentukan, maka ini datang sebagai balasan: “Benar”.

Cara mendapatkan broadcast_id melalui nama webinar bermula dengan tarikh dan masa yang ditentukan

Untuk mendapatkan broadcast_id webinar yang ditentukan, anda memerlukan fungsi webinargeek_search_broadcast_id() dengan parameter ini:

webinar_list - di sini anda perlu memindahkan pembolehubah yang memegang hasil fungsi webinargeek_get_webinar_list()
webinar_name - nama webinar yang broadcast_id anda perlu cari
webinar_date - tarikh siaran dalam format dd.mm.yyyy. Anda juga boleh menggunakan curret_date
webinar_time - masa siaran dalam format hh:mm, di mana hh = jam dan mm = minit

Contoh:
webinar_list = webinargeek_get_webinar_list()
broadcast_id = webinargeek_search_broadcast_id(webinar_list, 'Second webinar', current_date-4, '18:00'

Di sini kami cuba mencari id siaran yang berlaku 4 hari sebelum tarikh semasa pada pukul 6 petang dan dipanggil “Second webinar”.

Jika webinar yang sepadan dengan parameter berada dalam senarai, maka fungsi mengembalikan id webinar yang ditemui ke pembolehubah broadcast_id.

Jika webinar seperti itu tidak ditemui, maka teks ini ditampal sebagai ganti: "Tiada webinar dengan parameter ini".