Reģistrācija kursam
register_customer_on_course(tariff_id, email, email_notification, period, reregistration)
| Parametri | |
|---|---|
| ! tariff_id | obligāts parametrs, cenu plāna ID. To var nokopēt no pārlūkprogrammas rindas cenu plāna iestatījumos. |
| obligāts parametrs, klienta e-pasta adrese. Var norādīt konkrētu vērtību vai mainīgo, kurā ir ierakstīts klienta e-pasts. | |
| email_notification | neobligāts parametrs, nosūta studentam e-pasta ziņojumu par viņa reģistrāciju kursam, ja tas ir iespējots. |
| period |
neobligāts parametrs, cenu plāna derīguma termiņš. Tiek atbalstīti šādi datuma formāti: %d.%m.%Y %H:%M vai %d.%m.%Y Piemērs:
|
| reregistration | neobligāts parametrs, ar vērtībām True vai False. Šis parametrs ir neobligāts un tiek norādīts, ja nepieciešams atkārtoti reģistrēt studentus vienam un tam pašam kursam un cenu plānam. |
| purchase_price | neobligāts parametrs. Ļauj norādīt kursa izmaksas, ja klients par piekļuvi tam samaksāja caur botu. Ja to nenorāda, tiks izmantotas norādītā cenu plāna izmaksas. Tas noderēs, ja klients maksā par piekļuvi kursam caur botu par citu cenu, nekā norādītā cenu plāna izmaksas. |
Piemērs: register_customer_on_course(123, email, 1, "", True)
Lai klienti saņemtu e-pasta ziņojumus, parametram email_notification nododiet 1.
Ja nenosūtīsiet 1, tad klientu e-pasta ziņojumi netiks saņemti!
Kā piešķirt piekļuvi kursam, izmantojot Telegram Web App?
Lai to izdarītu, norādiet funkciju Bloku kalkulatorā
access_course_from_webapp(text, button_label)
Izmantojot funkciju, students piesakās Telegram un iegūst piekļuvi kursam. Turpmākajām mācībām studentam nav jāievada lietotājvārds un parole, jo autorizācija jau ir veikta.
Funkcijas parametri:
text - ir ziņojuma teksts, ko klients saņems. Parametru var norādīt mainīgajā, ierakstot to Kalkulatora laukā pirms funkcijas izsaukšanas, vai norādīt pašā funkcijā pēdiņās.
button_label - ir teksts uz Web App pogas. Parametru var norādīt vai nu mainīgajā, vai pašā funkcijā. Otrajā gadījumā parametrs tiek rakstīts pēdiņās.
Tas ir aktuāli TIKAI darbam ar Telegram botu.
Zemāk redzamajā ekrānuzņēmumā ir parādīts funkcijas izmantošanas piemērs.
Pirmajā solī mēs reģistrējam klientu kursam, pēc tam izmantojam funkciju access_course_com_webapp, lai nodrošinātu piekļuvi tiešsaistes produktam.
Funkcijas izpildes rezultāts:
Šī poga atver lapu ar kursiem/likmēm, kas ir studentam.
Ja klients nav saistīts ar studenta kontu, funkcija atgriež 'client not attached to customer'.
Lai izveidotu šādu savienojumu, vienkārši pierakstieties kursā caur botu.
Kā piešķirt piekļuvi kursam caur botu
register_customer_on_course()
Lai to izdarītu, norādiet funkciju Bloku kalkulatorā
register_customer_on_course(tariff_id, email, email_notification, period)
| Obligātie parametri | Neobligātie parametri |
|---|---|
| ! tariff_id - cenu plāna ID. To var nokopēt no pārlūkprogrammas rindas cenu plāna iestatījumos. | email_notification - Šis parametrs nosūta studentam e-pasta ziņojumu par viņa reģistrāciju kursam, ja tas ir iespējots. |
| ****!**email - klienta e-pasta adrese. Var norādīt konkrētu vērtību vai mainīgo, kurā ir ierakstīts klienta e-pasts. |
period - cenu plāna derīguma termiņš. Tiek atbalstīti šādi datuma formāti: %d.%m.%Y %H:%M vai %d.%m.%Y |
Lai klienti saņemtu e-pasta ziņojumus, parametram email_notification jānodod 1.
**Ja nenosūtīsiet 1, tad klientu e-pasta ziņojumi netiks saņemti!
Piešķiriet funkciju mainīgajam.
Pēc izpildes mainīgajā tiks ierakstīta viena no atbildēm:
customer is already on tariff - ja ir cenu plāns vai piekļuve ir manuāli slēgta
wrong_tariff_id - norādīts nederīgs ID
tariff_added - Cenu plāns tika pievienots studentam
Piemērs:
Kā pārbaudīt piekļuves pieejamību kursam
has_customer_tariff(tariff_id)
Lai to izdarītu, norādiet funkciju Bloku kalkulatorā has_customer_tariff(tariff_id, email)
| Obligātie parametri | Neobligātie parametri |
|---|---|
| ! tariff_id - cenu plāna ID. To var nokopēt no pārlūkprogrammas rindas cenu plāna iestatījumos vai sadaļā Cenu plāni. | email - neobligāts parametrs. Nododiet šo parametru, lai pārbaudītu, vai klients ir pierakstījies kursam ar norādīto e-pasta adresi. |
Pēc izpildes funkcija atgriež True vai False.
Iespējamās funkcijas atbildes kļūdu gadījumā:
wrong tariff_id - nodota nederīga vērtība tariff_id
customer not found - lietotājs nav reģistrēts kā students.
Kā reģistrēt klientu platformā BEZ piekļuves piešķiršanas kursam
register_customer(email)
Lai to izdarītu, norādiet funkciju Bloku kalkulatorā **register_customer(email)**
| Funkcijas parametri | Apraksts |
|---|---|
| klienta e-pasta adrese. |
Var norādīt mainīgo funkcijā vai parametru vērtības. Lai norādītu mainīgo, ierakstiet tā nosaukumu bez pēdiņām un sintakses zīmēm, režģiem un cirtainajām iekavām. Lai norādītu konkrētu vērtību, norādiet klienta e-pasta adresi pēdiņās.
Ieteicams piešķirt funkcijai mainīgo, lai jūs varētu redzēt funkcijas rezultātu un strādāt ar to. Piemērs zemāk esošajā ekrānuzņēmumā: mainīgā nosaukums ir iestatīts pirms vienādības zīmes, kam seko funkcija un parametrs iekavās.
Pēc veiksmīgas funkcijas izpildes mainīgajā tiks ierakstīta atbilde:
customer created
Kā pārbaudīt kursa piekļuvi un laika ierobežojumus?
Lai to izdarītu, norādiet funkciju Bloku kalkulatorā has_customer_tariff_with_date(tariff_id, email), lai pārbaudītu piekļuves pieejamību kursam pēc e-pasta (atgriež detalizētu atbildi par piekļuves pieejamību un laika ierobežojumiem).
Funkcijas parametri:
| Obligātais parametrs | Neobligātais parametrs |
|---|---|
| ! tariff_id - cenu plāna ID. To var nokopēt no pārlūkprogrammas rindas cenu plāna iestatījumos vai sadaļā Cenu plāni. | email - neobligāts parametrs. |
Atbilde būs:
- students ir pierakstīts un ir piekļuves laika ierobežojums: Ir piekļuve līdz 2023-09-28 22:00:00
- students ir pierakstīts, ierobežojumu nav: Ir piekļuve bez laika ierobežojuma
- students nav pierakstīts: Nav piekļuves šim tarifam
Iespējamās funkcijas atbildes kļūdu gadījumā:
wrong tariff_id - nodota nederīga vērtība tariff_id
customer not found - lietotājs nav reģistrēts kā students.
Kā noņemt piekļuvi studenta kursam caur botu
del_customer_from_course(course_id, email)
Lai to izdarītu, norādiet funkciju Bloku kalkulatorā del_customer_from_course(course_id, email)
| Parametri | Apraksts |
|---|---|
| ****!****tariff_id | cenu plāna ID |
| klienta e-pasta adrese |
Kā pārbaudīt, vai students ir apmeklējis vebināru
customer_was_on_translation()
Piekļuve kursam ir jāpiešķir botā.
Šim nolūkam ir funkcija register_customer_on_course() un access_course_from_webapp()
Lai pārbaudītu, vai students apmeklēja vebināru vai nē, norādiet funkciju Bloku kalkulatorā customer_was_on_translation(translation_guid, email, after_start_time)
| Obligātie parametri | Neobligātais parametrs |
|---|---|
|
! translation_guid - pārraides ID. Kopējiet lauka vērtību Nosaukums ir pārraides iestatījumu saitē |
after_start_time - pārraides sākuma laiks formātā: '2023-04-18 13:30:00'. |
| ! email - Studentu e-pasta adrese |
Pievērsiet uzmanību! Mainīgā nosaukums var būt jebkurš jums ērts un saprotams nosaukums. Kļūdas gadījumā, rakstot funkcijas parametrus, mainīgajā tiks ierakstīts ziņojums: wrong translation_guid
Šajā gadījumā mēs iesakām pārbaudīt funkcijas parametrus un vēlreiz tos pārbaudīt. Lai iegūtu vebinārā pavadītā laika vērtību no mainīgā Kalkulatorā, varat izmantot funkciju darbam ar masīviem un vārdnīcām. saite/saite masīviem un vārdnīcām.
Iestatījumu piemērs Bloku kalkulatorā:
time_spent1 = answer2[0]['time_spent']
Kā atrast studenta vārdu, kas saistīts ar botu?
Ir gadījumi, kad studenti var būt saistīti ar studenta personīgā konta tiešsaistes tērzēšanu, kā arī tie, kas ir saistīti ar kurjeru un raksta jūsu vadītājiem caur botu. Lai botā pareizi izsniegtu personalizētus kursa pabeigšanas sertifikātus un nemeklētu studenta vārdu sarakstā, ir funkcija:
get_customer_name() - atgriež studenta vārdu, kas saistīts ar klientu.
Funkcija bez parametriem.
Atgriež studenta vārdu, ko students ievadīja, reģistrējoties kursam, vai studenta vārdu no viņa personīgā konta.