Comment configurer WebinarGeek

Pour obtenir le jeton, allez dans les paramètres du compte sur WebinarGeek. Vous le trouverez dans le coin supérieur droit de l'écran et après avoir cliqué sur le mot Compte, le menu déroulant s'ouvre, où vous devez choisir la première option :

Ensuite, choisissez API dans le menu de gauche

Après cela, la page avec l'API s'ouvrira

Si vous n'avez pas obtenu la clé, vous devez contacter le support client et en demander une.

Après avoir obtenu le jeton, ouvrez Paramètres -> Constantes du projet et collez-le dans la variable webinargeek_token :

Comment obtenir la liste des webinaires via le chatbot

Pour obtenir la liste, il suffit d'appeler la fonction webinargeek_get_webinar_list() :

En résultat, il y aura une liste de webinaires dans ce format :

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

où

id - est l'identifiant de la diffusion (broadcast_id), la valeur est essentielle pour toutes les autres actions avec ce
date du webinaire - la date et l'heure de cette diffusion
nom - le nom du webinaire

Si vous partagez avec la fonction un symbole (il est préférable de coller '1'), alors la fonction n'affichera que les webinaires qui ne sont pas encore terminés, et si vous ne collez rien, elle affichera également ceux qui sont terminés.

Comment s'inscrire à un webinaire via le chatbot

Pour l'inscription, vous avez besoin de la fonction webinargeek_get_webinar_list(broadcast_id, name, email), où

broadcast_id - l'identifiant de la diffusion pour laquelle vous devez inscrire le client
name - le nom du client qui sera affiché dans le chat
email - l'adresse e-mail à laquelle l'invitation au webinaire avec le lien sera envoyée

Sans ces paramètres, vous ne pouvez pas inscrire un client via le bot.

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

En résultat, cette variable contiendra le lien vers le webinaire via lequel l'utilisateur n'aura pas besoin de s'inscrire. Toutes les données utilisateur sont définies dans cette variable.

De plus, après l'exécution de la fonction, deux variables seront ajoutées à la fiche du client :

webinargeek_broadcast_id - l'identifiant de la diffusion pour laquelle l'utilisateur a été inscrit
webinargeek_email - l'e-mail qui a été spécifié lors de l'inscription

Ces variables seront utiles pour vérifier la présence de l'utilisateur au webinaire.

Comment vérifier la présence à un webinaire via le chatbot

Pour vérifier la présence, vous aurez besoin de cette fonction webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email), où

webinargeek_broadcast_id - l'identifiant de la diffusion pour laquelle l'utilisateur a été inscrit
webinargeek_email - l'e-mail qui a été spécifié lors de l'inscription
watch_minimum - (paramètre optionnel) le nombre minimum de minutes à partir duquel la fonction détermine si la présence est comptée ou non

watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)

Une réponse sera collée dans la variable :

  • Si le webinaire n'est pas encore terminé, alors ce texte est renvoyé en réponse : "Webinar not ended yet";
  • Si le client n'a pas regardé le webinaire, alors ceci est renvoyé en réponse : "False";
  • Si le client a regardé le webinaire et que le paramètre watch_minimum n'a pas été utilisé, alors ceci est renvoyé en réponse : "True";
    Si le paramètre watch_minimum a été utilisé, alors la fonction vérifiera le temps pendant lequel le client l'a regardé et :
    • Si le client l'a regardé pendant une durée inférieure à celle définie comme minimum, ceci est renvoyé en réponse : "False";
    • Si la durée pendant laquelle le client a regardé le webinaire est égale ou supérieure à la durée spécifiée, alors ceci est renvoyé en réponse : "True".

Comment obtenir broadcast_id par le nom du webinaire à partir d'une date et d'une heure spécifiées

Pour obtenir le broadcast_id d'un webinaire spécifié, vous avez besoin de la fonction webinargeek_search_broadcast_id() avec ces paramètres :

webinar_list - ici, vous devez transférer la variable qui contient le résultat de la fonction webinargeek_get_webinar_list()
webinar_name - le nom du webinaire dont vous devez trouver le broadcast_id
webinar_date - la date de la diffusion au format dd.mm.yyyy. Vous pouvez également utiliser curret_date
webinar_time - l'heure de la diffusion au format hh:mm, où hh = heures et mm = minutes

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

Ici, nous essayons de trouver l'identifiant de la diffusion qui avait lieu 4 jours avant la date actuelle à 18h et qui s'appelait "Second webinar".

Si le webinaire correspondant aux paramètres se trouvait dans la liste, alors la fonction renvoie l'identifiant du webinaire trouvé dans la variable broadcast_id.

Si un tel webinaire n'a pas été trouvé, alors ce texte est collé à la place : "No webinar with these parameters".