MyOwnConference
Service en ligne qui vous permet d’organiser des webinaires interactifs, des séminaires et des vidéoconférences
Comment configurer la connexion
Tout d’abord, vous devez obtenir la clé API. Vous pouvez la trouver dans la Profil section dans votre compte personnel sur MyOwnConference
Après avoir copié la clé, ouvrez Paramètres -> Constantes du projet sur Salebot et collez-la dans la variable myownconference_api_key:
Chaque fonction renvoie un dictionnaire qui contient un paramètre status; sa valeur peut être 0 ou 1.
Si status=1, alors la requête dans MyOwnConference a été effectuée avec succès et le paramètre résultat contiendra le résultat de la requête, par exemple :
{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}
ou la requête a été effectuée avec succès, mais rien n’a été trouvé :
{'status': '1', 'result': []}
Si status=0, alors il y a un problème et la description sera contenue dans error, par exemple :
{"status":"0","error":"Webinar with alias "wenk-gjkc-teqp-nteh" not active"} {'status': '0', 'error': 'Missing required variables - email'}
Comment rechercher des webinaires
La fonction myownconference_find_webinars(date, status) est utilisé pour rechercher des webinaires, où
date - la date au format dd.mm.yyyy - permet de choisir des webinaires pour une date spécifique status - valeur 1 - webinaires actifs ou futurs, 0 - terminés
myownconference_find_webinars() - renvoie le tableau de tous les webinaires trouvés
La fonction renvoie un dictionnaire de ce type :
En cas de succès (exemple) :
{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}
En cas d’échec (exemple) :
{"status":"0","error":"Format not supported or date is not valid. Params must be yyyy-mm-dd"}
Comment vérifier si un utilisateur est présent dans un webinaire actif
La fonction myownconference_is_online_user(webinar_id, email), où :
webinar_id - l’identifiant du webinaire, ou, en d’autres termes, la valeur « alias » de la requête lors de la recherche du webinaire e-mail - l’adresse e-mail de l’utilisateur ; si elle n’est pas partagée, alors l’e-mail de la variable email est utilisé, s’il y en a un
Le résultat si la fonction a réussi :
{"status":"1","result":true} - l’utilisateur est présent à ce moment dans le webinaire {"status":"1","result":false} - l’utilisateur n’est pas présent
Le résultat s’il y a eu une erreur dans la requête :
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}
Comment obtenir les données d’historique de l’utilisateur
La fonction myownconference_history_user(webinar_id, email), où
webinar_id - l’identifiant du webinaire, ou, en d’autres termes, la valeur « alias » de la requête lors de la recherche du webinaire e-mail - l’adresse e-mail de l’utilisateur ; si elle n’est pas partagée, alors l’e-mail de la variable email est utilisé, s’il y en a un
Le résultat en cas de succès :
Dans le paramètre result, il y aura un tableau avec les données de l’utilisateur
{'status': '1', 'result': ['John Smith', '[email protected]', 'ua', '12:02:45', '12:12:15', 'G', '28%']} {"status":"1","result":false} - l’utilisateur n’a pas été trouvé
En cas d’échec :
{'status': '0', 'error': 'Missing required variables - email'} - l’e-mail n’a pas été partagé et n’a pas été trouvé dans la variable email
Un exemple de la requête et de l’obtention du nom de l’utilisateur :
Comment vérifier si un utilisateur figure dans la liste de tous les participants
La fonction myownconference_is_our_user(email), où :
e-mail - l’adresse e-mail de l’utilisateur ; si elle n’est pas partagée, alors l’e-mail de la variable email est utilisé, s’il y en a un
Le résultat en cas de succès :
{"status":"1","result":true} - l’utilisateur est dans votre base de données {"status":"1","result":false} - il n’existe pas d’utilisateur de ce type dans votre base de données
En cas d’échec :
{'status': '0', 'error': 'Missing required variables - email'} - l’e-mail n’a pas été partagé et n’a pas été trouvé dans la variable email
Comment créer un participant
Cette fonction ajoute un participant au webinaire à la liste de tous les utilisateurs. Après une création réussie, cet utilisateur peut être inscrit à un webinaire (plus d’informations ci-dessous)
La fonction myownconference_add_user(email), où :
e-mail - l’adresse e-mail de l’utilisateur ; si elle n’est pas partagée, alors l’e-mail de la variable email est utilisé, s’il y en a un
Le résultat en cas de succès :
{"status":"1","result":true} - l’utilisateur a été ajouté à votre liste de tous les participants
En cas d’échec :
{'status': '0', 'error': 'Missing required variables - email'} - l’e-mail n’a pas été partagé et n’a pas été trouvé dans la variable email.
Comment inscrire un participant à un webinaire
Il est obligatoire de demander au client son e-mail pour que l’inscription puisse avoir lieu. Tout le reste est facultatif.
La fonction myownconference_add_user_to_webinar(webinar_id, email), où
webinar_id - l’identifiant du webinaire, ou, en d’autres termes, la valeur « alias » de la requête lors de la recherche du webinaire e-mail - l’adresse e-mail de l’utilisateur ; si elle n’est pas partagée, alors l’e-mail de la variable email est utilisé, s’il y en a un
Le résultat en cas de succès :
{"status":"1","result":true} - l’utilisateur a été inscrit au webinaire
En cas d’échec :
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}
Mis à jour