- Cómo configurar la conexión
- Cómo buscar seminarios web
- Cómo verificar si un usuario está presente en un seminario web activo
- Cómo obtener datos del historial del usuario
- Cómo verificar si un usuario está en la lista de todos los participantes
- Cómo crear un participante
- Cómo registrar un participante en un seminario web
Cómo configurar la conexión
Primero necesitas obtener la clave API. Puedes encontrarla en la sección Perfil de tu cuenta personal en MyOwnConference
Después de copiar la clave, abre Configuración -> Constantes del proyecto en Mavibot y pégala en la variable myownconference_api_key:
Cada función devuelve un diccionario que tiene un parámetro status; su valor puede ser 0 y 1.
Si status=1, la solicitud en MyOwnConference se realizó correctamente y el parámetro result contendrá el resultado de la solicitud, como:
{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}
o la solicitud se realizó correctamente, pero no se encontró nada:
{'status': '1', 'result': []}
Si status=0, hay un problema y la descripción se encontrará en error, como:
{"status":"0","error":"Webinar with alias "wenk-gjkc-teqp-nteh" not active"} {'status': '0', 'error': 'Missing required variables - email'}
Cómo buscar seminarios web
La función myownconference_find_webinars(date, status) se utiliza para buscar seminarios web, donde
date - la fecha en formato dd.mm.aaaa - seleccionar seminarios web para una fecha específica
status - valor 1 - seminarios web activos o futuros, 0 - finalizados
myownconference_find_webinars() - devuelve la matriz de todos los seminarios web encontrados
La función devuelve un diccionario de este tipo:
Si es exitoso (ejemplo):
{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}
Si no es exitoso (ejemplo):
{"status":"0","error":"Format not supported or date is not valid. Params must be yyyy-mm-dd"}
Cómo verificar si un usuario está presente en un seminario web activo
La función myownconference_is_online_user(webinar_id, email), donde:
webinar_id - el ID del seminario web, o, en otras palabras, el valor “alias” de la solicitud al buscar el seminario web
email - la dirección de correo electrónico del usuario; si no se comparte, se utiliza un correo electrónico de la variable email, si existe
El resultado si la función fue exitosa:
{"status":"1","result":true} - el usuario está presente en este momento en el seminario web {"status":"1","result":false} - el usuario no está presente
El resultado si hubo un error en la solicitud:
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}
Cómo obtener datos del historial del usuario
La función myownconference_history_user(webinar_id, email), donde
webinar_id - el ID del seminario web, o, en otras palabras, el valor “alias” de la solicitud al buscar el seminario web
email - la dirección de correo electrónico del usuario; si no se comparte, se utiliza un correo electrónico de la variable email, si existe
El resultado si es exitoso:
En el parámetro result habrá una matriz con los datos del usuario
{'status': '1', 'result': ['John Smith', '[email protected]', 'ua', '12:02:45', '12:12:15', 'G', '28%']} {"status":"1","result":false} - el usuario no fue encontrado
En caso de fallo:
{'status': '0', 'error': 'Missing required variables - email'} - el correo electrónico no se compartió y no se encontró en la variable email
Un ejemplo de la solicitud y obtención del nombre del usuario:
Cómo verificar si un usuario está en la lista de todos los participantes
La función myownconference_is_our_user(email), donde:
email - la dirección de correo electrónico del usuario; si no se comparte, se utiliza un correo electrónico de la variable email, si existe
El resultado si es exitoso:
{"status":"1","result":true} - el usuario está en tu base de datos {"status":"1","result":false} - no existe tal usuario en tu base de datos
Si no es exitoso:
{'status': '0', 'error': 'Missing required variables - email'} - el correo electrónico no se compartió y no se encontró en la variable email
Cómo crear un participante
Esta función agrega un participante del seminario web a la lista de todos los usuarios. Después de la creación exitosa, este usuario puede ser registrado en un seminario web (más sobre esto a continuación)
La función myownconference_add_user(email), donde:
email - la dirección de correo electrónico del usuario; si no se comparte, se utiliza un correo electrónico de la variable email, si existe
El resultado si es exitoso:
{"status":"1","result":true} - el usuario fue agregado a tu lista de todos los participantes
Si no es exitoso:
{'status': '0', 'error': 'Missing required variables - email'} - el correo electrónico no se compartió y no se encontró en la variable email.
Cómo registrar un participante en un seminario web
Es obligatorio solicitar al cliente su correo electrónico para que se realice el registro. Todo lo demás es opcional.
La función myownconference_add_user_to_webinar(webinar_id, email), donde
webinar_id - el ID del seminario web, o, en otras palabras, el valor “alias” de la solicitud al buscar el seminario web
email - la dirección de correo electrónico del usuario; si no se comparte, se utiliza un correo electrónico de la variable email, si existe
El resultado si es exitoso:
{"status":"1","result":true} - el usuario fue registrado en el seminario web
Si no es exitoso:
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}