# Fonctions de calculatrice pour les cours
## Inscription au cours
register\_customer\_on\_course(tariff\_id, email, email\_notification, period, reregistration)
| Paramètres | |
|---|
| ! tariff_id | paramètre requis, l'ID du plan tarifaire. Vous pouvez le copier dans la barre du navigateur dans les paramètres du plan tarifaire. |
| ! email | paramètre requis, l'adresse e-mail du client. Vous pouvez spécifier une valeur ou une variable précise dans laquelle l'e-mail du client est enregistré. |
| email_notification | paramètre facultatif, envoie à l'étudiant un e-mail concernant son inscription au cours, s'il est activé. |
| period | paramètre facultatif, 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'
|
| reregistration | paramètre facultatif, avec les valeurs True ou False. Ce paramètre est facultatif et est spécifié si vous devez inscrire à nouveau des étudiants au même cours et au même plan tarifaire. |
| purchase_price | paramètre facultatif. Permet de spécifier le coût du cours si le client a payé l'accès via un bot. Si vous ne le spécifiez pas, le coût du plan tarifaire indiqué sera utilisé. Cela sera utile si le client paie l'accès au cours via le bot à un prix différent du coût du plan tarifaire indiqué. |
Exemple : register\_customer\_on\_course(123, email, 1, "", True)
{% hint style="info" %}
Afin 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 !**
{% endhint %}
## Comment puis-je donner accès au cours via Telegram Web App ?
Pour ce faire, spécifiez la fonction dans le Bloc Calculateur
**`access_course_from_webapp(text, button_label)`**\
Lors de l'utilisation de cette 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 identifiant 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 du Calculateur avant d'appeler la fonction, ou spécifié dans la fonction elle-même entre guillemets.
**`button_label`** - est le texte sur le bouton Web App. 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.
{% hint style="warning" %} Cela est pertinent UNIQUEMENT pour le travail avec un bot Telegram.
{% endhint %}
La capture d'écran ci-dessous montre un exemple d'utilisation de la fonction.\
À 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.
Le résultat de l'exécution de la fonction :
Ce bouton ouvre une page avec les cours/tarifs que possède l'étudiant.
> 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 donner accès au cours via un bot
### register\_customer\_on\_course()
Pour ce faire, spécifiez la fonction dans le Bloc Calculateur
**register\_customer\_on\_course(tariff\_id, email, email\_notification, period)**
| Paramètres requis | Paramètres facultatifs |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **!** **tariff\_id** - l'ID du plan tarifaire. Vous pouvez le copier dans la barre du navigateur dans les paramètres du plan tarifaire. | **email\_notification** - Ce paramètre envoie à l'étudiant un e-mail concernant son inscription au cours, s'il est activé. |
| **!**** email** - l'adresse e-mail du client. Vous pouvez spécifier une valeur ou une variable précise dans laquelle l'e-mail du client est enregistré. | period - limite de temps de 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'
|
{% hint style="danger" %}
Afin que les clients reçoivent des e-mails, vous devez passer 1 dans le paramètre **email\_notification.**
**Si vous** n'envoyez pas 1, **alors les e-mails du client ****ne seront pas reçus !**
{% endhint %}
Attribuez une fonction à la variable.
Après l'exécution, l'une des réponses sera écrite dans la variable :
**customer is already on tariff** - s'il existe un plan tarifaire ou si l'accès est fermé manuellement
**wrong\_tariff\_id** - un identifiant 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 Calculateur **has\_customer\_tariff(tariff\_id, email)**
| Paramètres requis | Paramètres facultatifs |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **!** **tariff\_id** - l'ID du plan tarifaire. Vous pouvez le copier dans la barre du navigateur dans les paramètres du plan tarifaire ou dans la section des plans tarifaires. | **email** - paramètre facultatif. 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.
{% hint style="danger" %}
Réponses possibles de la fonction en cas d'erreurs :
**wrong tariff\_id** - valeur invalide transmise **tariff\_id**
**customer not found** - l'utilisateur n'est pas enregistré en tant qu'étudiant.
{% endhint %}
## Comment inscrire un client sur la plateforme SANS lui donner accès au cours
### register\_customer(email)
Pour ce faire, spécifiez la fonction dans le Bloc Calculateur **register\_customer(email)**
| Paramètres de la fonction | Description |
| ------------------------------------------------- | --------------------------- |
| **!** **email** | l'adresse e-mail du client. |
Vous pouvez spécifier une variable dans une fonction ou dans les valeurs des paramètres. Pour spécifier une variable, écrivez son nom, sans guillemets ni caractères de syntaxe, dièses et accolades. Pour spécifier une valeur précise, indiquez l'adresse e-mail du client entre guillemets.
> Il est recommandé d'assigner une variable à la fonction, afin de pouvoir voir le résultat de la fonction et l'utiliser. 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 l'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 Calculateur **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 requis | Paramètre facultatif |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| **!** **tariff\_id** - l'ID du plan tarifaire. Vous pouvez le copier dans la barre du navigateur dans les paramètres du plan tarifaire ou dans la section des plans tarifaires. | **email** - paramètre facultatif. |
La réponse sera :
* l'étudiant est inscrit et l'accès est limité dans le temps : Accès jusqu'au 2023-09-28 22:00:00
* l'étudiant est inscrit, il n'y a aucune restriction : Accès sans limite de temps
* l'étudiant n'est pas inscrit : Aucun accès à ce tarif
{% hint style="danger" %}
**Réponses possibles de la fonction en cas d'erreurs :**
**wrong tariff\_id** - valeur invalide transmise **tariff\_id**
**customer not found** -l'utilisateur n'est pas enregistré en tant qu'étudiant.
{% endhint %}
## 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 Calculateur **del\_customer\_from\_course(course\_id, email)**
| Paramètres | Description |
| ----------------------------------------------------------- | ------------------------ |
| **!**** tariff\_id** | ID du plan tarifaire |
| **!**** email** | 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()](https://docs.salebot.pro/onlain-kursy/sozdanie-kursov/chat-bot-dlya-onlain-kursa#kak-vydat-dostup-k-kursu-cherez-bot-register_customer_on_course) et [access\_course\_from\_webapp()](https://docs.salebot.pro/onlain-kursy/sozdanie-kursov/chat-bot-dlya-onlain-kursa#kak-vydat-dostup-k-kursu-cherez-web-app-telegramm)
Pour vérifier si un étudiant a assisté ou non au webinaire, spécifiez la fonction dans le Bloc Calculateur customer\_was\_on\_translation(translation\_guid, email, after\_start\_time)
| Paramètres requis | Paramètre facultatif |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------- |
| ! 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 | |
{% hint style="warning" %}
**Attention !** Le nom de la variable peut être n'importe quel nom pratique et compréhensible pour vous. En cas d'erreur dans la saisie 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 réessayer. Pour obtenir la valeur de la durée de présence au webinaire à partir d'une variable dans le Calculateur, vous pouvez utiliser la fonction de travail avec les tableaux et les dictionnaires. lien/lien [tableaux](https://docs.salebot.pro/peremennye-1/rabota-s-massivami-i-slovaryami/rabota-s-massivami#kak-poluchit-element-massiva) et [dictionnaires](https://docs.salebot.pro/peremennye-1/rabota-s-massivami-i-slovaryami/rabota-so-slovaryami#kak-poluchit-znachenie-slovarya-po-klyuchu).
Exemple de configuration dans le Bloc Calculateur :
time\_spent1 = answer2\[0]\['time\_spent']
{% endhint %}
## 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 d'émettre 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 celui-ci a saisi lors de son inscription au cours, ou le nom de l'étudiant provenant de son compte personnel.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mavibot.ai/doc/fr/lms/comment-vendre-des-cours/vendre-des-cours-dans-un-chatbot/fonctions-de-calculatrice-pour-les-cours.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.