Inscription au cours
register_customer_on_course(tariff_id, email, email_notification, period, reregistration)
Exemple : register_customer_on_course(123, email, 1, "", True)
Pour que les clients reçoivent des e-mails, passez 1 au paramètre email_notification.
Si vous n'envoyez pas 1, les e-mails du client ne seront pas reçus !
Comment accorder l'accès au cours via l'application Web Telegram ?
Pour ce faire, spécifiez la fonction dans le Bloc Calculatrice
access_course_from_webapp(text, button_label)
Lors de l'utilisation de la fonction, l'étudiant se connecte à Telegram et obtient l'accès au cours. Pour la suite de la formation, l'étudiant n'a pas besoin de saisir un nom d'utilisateur et un mot de passe, car l'autorisation a déjà été effectuée.
Paramètres de la fonction :
text - est le texte du message que le client recevra. Le paramètre peut être spécifié dans une variable en l'écrivant dans le champ Calculatrice avant d'accéder à la fonction, ou spécifié dans la fonction elle-même entre guillemets.
button_label - est le texte sur le bouton de l'application Web. Vous pouvez spécifier le paramètre soit dans une variable, soit dans la fonction elle-même. Dans le second cas, le paramètre est écrit entre guillemets.
Cela est pertinent UNIQUEMENT pour travailler avec un bot Telegram.
La capture d'écran ci-dessous montre un exemple d'utilisation de la fonction.
Dans la première étape, nous inscrivons le client au cours, puis nous utilisons la fonction access_course_com_webapp pour fournir l'accès au produit en ligne.
Résultat de l'exécution de la fonction :
Ce bouton ouvre une page avec les cours/tarifs que l'étudiant possède.
Si le client n'est pas associé au compte de l'étudiant, la fonction renvoie 'client not attached to customer'.
Pour créer une telle connexion, il suffit de s'inscrire à un cours via un bot.
Comment accorder l'accès au cours via un bot
register_customer_on_course()
Pour ce faire, spécifiez la fonction dans le Bloc Calculatrice
register_customer_on_course(tariff_id, email, email_notification, period)
| Paramètres obligatoires | Paramètres optionnels |
|---|---|
| ! tariff_id - l'ID du plan tarifaire. Vous pouvez le copier dans la ligne du navigateur dans les paramètres du plan tarifaire. | email_notification - Ce paramètre envoie un e-mail à l'étudiant concernant son inscription au cours, si activé. |
| ! email - l'adresse e-mail du client. Vous pouvez spécifier une valeur spécifique ou une variable dans laquelle l'e-mail du client est enregistré. | period - limite de temps pour la validité du plan tarifaire. Les formats de date suivants sont pris en charge : %d.%m.%Y %H:%M ou %d.%m.%Y Exemple : period = '15.08.2023 11:00' |
Pour que les clients reçoivent des e-mails, vous devez passer 1 dans le paramètre email_notification.
Si vous n'envoyez pas 1, les e-mails du client ne seront pas reçus !
Attribuez une fonction à la variable.
Après exécution, l'une des réponses sera écrite dans la variable :
customer is already on tariff - si un plan tarifaire existe ou si l'accès est fermé manuellement
wrong_tariff_id - un ID invalide est spécifié
tariff_added - Le plan tarifaire a été ajouté à l'étudiant
Exemple :
Comment vérifier la disponibilité de l'accès au cours
has_customer_tariff(tariff_id)
Pour ce faire, spécifiez la fonction dans le Bloc Calculatrice has_customer_tariff(tariff_id, email)
| Paramètres obligatoires | Paramètres optionnels |
|---|---|
| ! tariff_id - l'ID du plan tarifaire. Vous pouvez le copier dans la ligne du navigateur dans les paramètres du plan tarifaire ou dans la section Plans tarifaires. | email - paramètre optionnel. Passez ce paramètre pour vérifier si le client est inscrit au cours avec l'adresse e-mail spécifiée. |
Après exécution, la fonction renvoie True ou False.
Réponses possibles de la fonction en cas d'erreurs :
wrong tariff_id - valeur invalide passée tariff_id
customer not found - l'utilisateur n'est pas enregistré en tant qu'étudiant.
Comment inscrire un client sur la plateforme SANS accorder l'accès au cours
register_customer(email)
Pour ce faire, spécifiez la fonction dans le Bloc Calculatrice register_customer(email)
| Paramètres de la fonction | Description |
|---|---|
| l'adresse e-mail du client. |
Vous pouvez spécifier une variable dans une fonction ou des valeurs de paramètres. Pour spécifier une variable, écrivez son nom, sans guillemets ni marques de syntaxe, crochets et accolades. Pour spécifier une valeur spécifique, indiquez l'adresse e-mail du client entre guillemets.
Il est recommandé d'attribuer une variable à la fonction, afin de pouvoir voir le résultat de la fonction et travailler avec. Exemple dans la capture d'écran ci-dessous : le nom de la variable est défini avant le signe égal, suivi de la fonction et du paramètre entre parenthèses.
Après exécution réussie de la fonction, la réponse sera écrite dans la variable :
customer created
Comment vérifier l'accès au cours et les limites de temps ?
Pour ce faire, spécifiez la fonction dans le Bloc Calculatrice has_customer_tariff_with_date(tariff_id, email), pour vérifier la disponibilité de l'accès au cours par e-mail (renvoie une réponse détaillée sur la disponibilité de l'accès et les restrictions de temps).
Paramètres de la fonction :
| Paramètre obligatoire | Paramètre optionnel |
|---|---|
| ! tariff_id - l'ID du plan tarifaire. Vous pouvez le copier dans la ligne du navigateur dans les paramètres du plan tarifaire ou dans la section Plans tarifaires. | email - paramètre optionnel. |
La réponse sera :
- l'étudiant est inscrit et il y a une limite de temps sur l'accès : A accès jusqu'au 2023-09-28 22:00:00
- l'étudiant est inscrit, il n'y a pas de restrictions : A accès sans limite de temps
- l'étudiant n'est pas inscrit : Pas d'accès à ce tarif
Réponses possibles de la fonction en cas d'erreurs :
wrong tariff_id - valeur invalide passée tariff_id
customer not found - l'utilisateur n'est pas enregistré en tant qu'étudiant.
Comment supprimer l'accès au cours d'un étudiant via un bot
del_customer_from_course(course_id, email)
Pour ce faire, spécifiez la fonction dans le Bloc Calculatrice del_customer_from_course(course_id, email)
| Paramètres | Description |
|---|---|
| ! tariff_id | ID du plan tarifaire |
| adresse e-mail du client |
Comment vérifier si un étudiant a assisté à un webinaire
customer_was_on_translation()
L'accès au cours doit être accordé dans le bot.
Il existe une fonction pour cela register_customer_on_course() et access_course_from_webapp()
Pour vérifier si un étudiant a assisté au webinaire ou non, spécifiez la fonction dans le Bloc Calculatrice customer_was_on_translation(translation_guid, email, after_start_time)
| Paramètres obligatoires | Paramètre optionnel |
|---|---|
| ! translation_guid - l'ID de la diffusion. Copiez la valeur du champ Le nom se trouve dans le lien des paramètres de la diffusion | after_start_time - l'heure de début de la diffusion au format : '2023-04-18 13:30:00'. |
| ! email - Adresse e-mail de l'étudiant |
Attention ! Le nom de la variable peut être n'importe quel nom qui vous convient et que vous comprenez. En cas d'erreur dans l'écriture des paramètres de la fonction, un message sera écrit dans la variable : wrong translation_guid
Dans ce cas, nous vous recommandons de vérifier les paramètres de la fonction et de les tester à nouveau. Pour obtenir la valeur de la durée de présence au webinaire à partir d'une variable dans la Calculatrice, vous pouvez utiliser la fonction de travail avec les tableaux et les dictionnaires. lien tableaux et dictionnaires.
Exemple de paramètres dans le Bloc Calculatrice :
time_spent1 = answer2[0]['time_spent']
Comment trouver le nom de l'étudiant lié à un bot ?
Il existe des cas où les étudiants peuvent être liés au chat en ligne du compte personnel d'un étudiant, ainsi que ceux qui sont liés à un messager et écrivent à vos superviseurs via un bot. Afin de délivrer correctement des certificats nominatifs de fin de cours dans le bot et de ne pas rechercher le nom de l'étudiant dans la liste, il existe une fonction :
get_customer_name() - renvoie le nom de l'étudiant associé au client.
Une fonction sans paramètres.
Renvoie le nom de l'étudiant que l'étudiant a saisi lors de l'inscription au cours, ou le nom de l'étudiant depuis son compte personnel.