Cómo configurar WebinarGeek

Para obtener el token, ve a la configuración de la cuenta en WebinarGeek. Puedes encontrarlo en la esquina superior derecha de la pantalla y, después de presionar la palabra Cuenta, se abre el menú desplegable, donde debes elegir la primera opción:

Luego elige API en el menú de la izquierda

Después de eso, se abrirá la página con la API

Si no obtuviste la clave, entonces debes contactar al soporte al cliente y solicitar una.

Después de obtener el token, abre Configuración -> Constantes del proyecto y pégalo en la variable webinargeek_token:

Cómo obtener la lista de seminarios web a través del chat-bot

Para obtener la lista, basta con llamar a la función webinargeek_get_webinar_list():

Como resultado, habrá una lista de seminarios web en este formato:

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

donde

id - es el id de la transmisión (broadcast_id), el valor es esencial para todas las demás acciones con este
fecha del seminario web - la fecha y hora de esta transmisión
nombre - el nombre del seminario web

Si compartes con la función cualquier símbolo (es mejor pegar '1'), entonces la función mostrará solo aquellos seminarios web que aún no han terminado, y si no pegas nada, también mostrará los terminados.

Cómo registrarse en un seminario web a través del chat-bot

Para el registro necesitas la función webinargeek_get_webinar_list(broadcast_id, name, email), donde

broadcast_id - el id de la transmisión para la cual necesitas registrar al cliente
name - el nombre del cliente que se mostrará en el chat
email - la dirección de correo electrónico a la que llegará la invitación al seminario web con el enlace

Sin estos parámetros no puedes registrar a un cliente a través del bot.

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

Como resultado, esta variable contendrá el enlace al seminario web a través del cual el usuario no necesitará registrarse. Todos los datos del usuario se establecen en esta variable.

Además, después de la ejecución de la función, se agregarán dos variables a la tarjeta del cliente:

webinargeek_broadcast_id - el id de la transmisión para la que se registró el usuario
webinargeek_email - el correo electrónico que se especificó en el registro

Estas variables serán útiles para verificar la asistencia del usuario al seminario web.

Cómo verificar la asistencia al seminario web a través del chat-bot

Para verificar la asistencia, necesitarás esta función webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email), donde

webinargeek_broadcast_id - el id de la transmisión para la que se registró el usuario
webinargeek_email - el correo electrónico que se especificó en el registro
watch_minimum - (parámetro opcional) la cantidad mínima de minutos mediante la cual la función identifica si la asistencia se cuenta o no

watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)

Se pegará una respuesta en la variable:

  • Si el seminario web aún no ha terminado, entonces este texto aparece como respuesta: "Webinar not ended yet";
  • Si el cliente no vio el seminario web, entonces aparece como respuesta: "False";
  • Si el cliente vio el seminario web y no se usó el parámetro watch_minimum, entonces aparece como respuesta: "True";
    Si se usó el parámetro watch_minimum, entonces la función verificará la cantidad de tiempo que el cliente lo vio y:
    • Si el cliente lo vio por un tiempo menor al establecido como mínimo, aparece como respuesta: "False";
    • Si la cantidad de tiempo que el cliente vio el seminario web es igual o mayor a la cantidad especificada, entonces aparece como respuesta: "True".

Cómo obtener broadcast_id por el nombre del seminario web a partir de una fecha y hora específicas

Para obtener el broadcast_id de un seminario web específico necesitas la función webinargeek_search_broadcast_id() con estos parámetros:

webinar_list - aquí debes transferir la variable que contiene el resultado de la función webinargeek_get_webinar_list()
webinar_name - el nombre del seminario web del cual necesitas encontrar el broadcast_id
webinar_date - la fecha de la transmisión en formato dd.mm.yyyy. También puedes usar curret_date
webinar_time - la hora de la transmisión en formato hh:mm, donde hh = horas y mm = minutos

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

Aquí estamos intentando encontrar el id de la transmisión que ocurrió 4 días antes de la fecha actual a las 6 pm y se llamaba "Second webinar".

Si el seminario web que corresponde a los parámetros estaba en la lista, entonces la función devuelve el id del seminario web encontrado a la variable broadcast_id.

Si no se encontró dicho seminario web, entonces se pega este texto: "No webinar with these parameters".