Funciones de la calculadora para cursos
Registro para el curso
register_customer_on_course(tariff_id, email, email_notification, period, reregistration)
! tariff_id
parámetro obligatorio, el ID del plan de precios. Puedes copiarlo en la barra del navegador en la configuración del plan de precios.
parámetro obligatorio, la dirección de correo electrónico del cliente. Puedes especificar un valor concreto o una variable en la que se registre el correo electrónico del cliente.
email_notification
parámetro opcional, envía al estudiante un mensaje de correo electrónico sobre su inscripción en el curso, si está habilitado.
period
parámetro opcional, límite de tiempo de validez del plan de precios. Se admiten los siguientes formatos de fecha: %d.%m.%Y %H:%M o %d.%m.%Y Ejemplo:
period = '15.08.2023 11:00'
reregistration
parámetro opcional, con valores True o False. Este parámetro es opcional y se especifica si necesitas volver a registrar a los estudiantes en el mismo curso y plan de precios.
purchase_price
parámetro opcional. Permite especificar el coste del curso si el cliente pagó por acceder a él a través de un bot. Si no lo especificas, se utilizará el coste del plan de precios indicado. Será útil si el cliente paga por acceder al curso a través del bot a un precio distinto del coste del plan de precios indicado.
Ejemplo: register_customer_on_course(123, email, 1, "", True)
Para que los clientes reciban correos electrónicos, pasa 1 al parámetro email_notification.
¡Si no envías 1, entonces los correos electrónicos del cliente no se recibirán!
¿Cómo puedo conceder acceso al curso a través de Telegram Web App?
Para ello, especifica la función en el Block Calculator
access_course_from_webapp(text, button_label)
Durante el uso de la función, el estudiante inicia sesión en Telegram y obtiene acceso al curso. Para continuar la formación, el estudiante no necesita introducir un nombre de usuario y una contraseña, ya que la autorización ya se ha completado.
Parámetros de la función:
text - es el texto del mensaje que recibirá el cliente. El parámetro puede especificarse en una variable escribiéndolo en el campo Calculator antes de llamar a la función, o especificarse en la propia función entre comillas.
button_label - es el texto del botón de la Web App. Puedes especificar el parámetro ya sea en una variable o en la propia función. En el segundo caso, el parámetro se escribe entre comillas.
Es relevante SOLO para trabajar con un bot de Telegram.
La captura de pantalla a continuación muestra un ejemplo de uso de la función.
En el primer paso, registramos al cliente en el curso; luego usamos la función access_course_com_webapp para proporcionar acceso al producto en línea.
El resultado de la ejecución de la función:
Este botón abre una página con los cursos/tarifas que tiene el estudiante.
Si el cliente no está asociado con la cuenta del estudiante, la función devuelve 'client not attached to customer'.
Para crear dicha conexión, solo necesitas inscribirte en un curso a través de un bot.
Cómo conceder acceso al curso a través de un bot
register_customer_on_course()
Para ello, especifica la función en el Block Calculator
register_customer_on_course(tariff_id, email, email_notification, period)
! tariff_id - el ID del plan de precios. Puedes copiarlo en la barra del navegador en la configuración del plan de precios.
email_notification - Este parámetro envía al estudiante un mensaje de correo electrónico sobre su inscripción en el curso, si está habilitado.
! email - la dirección de correo electrónico del cliente. Puedes especificar un valor concreto o una variable en la que se registre el correo electrónico del cliente.
period - límite de tiempo de validez del plan de precios. Se admiten los siguientes formatos de fecha: %d.%m.%Y %H:%M o %d.%m.%Y Ejemplo:
period = '15.08.2023 11:00'
Para que los clientes reciban correos electrónicos, debes pasar 1 en el parámetro email_notification.
Si no envías 1, entonces los correos electrónicos del cliente ¡no se recibirán!
Asigna una función a la variable.
Después de la ejecución, una de las respuestas se escribirá en la variable:
customer is already on tariff - si hay un plan de precios o el acceso está cerrado manualmente
wrong_tariff_id - se especifica un id no válido
tariff_added - El plan de precios se agregó al estudiante
Ejemplo:
Cómo comprobar la disponibilidad de acceso al curso
has_customer_tariff(tariff_id)
Para ello, especifica la función en el Block Calculator has_customer_tariff(tariff_id, email)
! tariff_id - el ID del plan de precios. Puedes copiarlo en la barra del navegador en la configuración del plan de precios o en la sección Planes de precios.
email - parámetro opcional. Pasa este parámetro para comprobar si el cliente está inscrito en el curso con la dirección de correo electrónico especificada.
Después de la ejecución, la función devuelve True o False.
Posibles respuestas de la función en caso de errores:
wrong tariff_id - se pasó un valor no válido tariff_id
customer not found - el usuario no está registrado como estudiante.
Cómo registrar a un cliente en la plataforma SIN conceder acceso al curso
register_customer(email)
Para ello, especifica la función en el Block Calculator register_customer(email)
la dirección de correo electrónico del cliente.
Puedes especificar una variable en una función o valores de parámetros. Para especificar una variable, escribe su nombre, sin comillas ni signos de sintaxis, rejillas ni llaves. Para especificar un valor concreto, indica la dirección de correo electrónico del cliente entre comillas.
Se recomienda asignar una variable a la función, así podrás ver el resultado de la función y trabajar con él. Ejemplo en la captura de pantalla de abajo: el nombre de la variable se establece antes del signo igual, seguido de la función y el parámetro entre paréntesis.
Después de la ejecución correcta de la función, la respuesta se escribirá en la variable: customer created
¿Cómo comprobar el acceso al curso y los límites de tiempo?
Para ello, especifica la función en el Block Calculator has_customer_tariff_with_date(tariff_id, email), para comprobar la disponibilidad de acceso al curso por correo electrónico (devuelve una respuesta detallada sobre la disponibilidad de acceso y las restricciones de tiempo).
Parámetros de la función:
! tariff_id - el ID del plan de precios. Puedes copiarlo en la barra del navegador en la configuración del plan de precios o en la sección Planes de precios.
email - parámetro opcional.
La respuesta será:
el estudiante está inscrito y hay un límite de tiempo de acceso: Tiene acceso hasta 2023-09-28 22:00:00
el estudiante está inscrito, no hay restricciones: Tiene acceso sin límite de tiempo
el estudiante no está inscrito: Sin acceso a esta tarifa
Posibles respuestas de la función en caso de errores:
wrong tariff_id - se pasó un valor no válido tariff_id
customer not found -el usuario no está registrado como estudiante.
Cómo eliminar el acceso al curso de un estudiante a través de un bot
del_customer_from_course(course_id, email)
Para ello, especifica la función en el Block Calculator del_customer_from_course(course_id, email)
! tariff_id
ID del plan de precios
dirección de correo electrónico del cliente
Cómo comprobar si un estudiante ha asistido a un seminario web
customer_was_on_translation()
El acceso al curso debe concederse en el bot.
Hay una función para ello register_customer_on_course() y access_course_from_webapp()
Para comprobar si un estudiante asistió o no al seminario web, especifica la función en el Block Calculator customer_was_on_translation(translation_guid, email, after_start_time)
! translation_guid - el ID de la transmisión. Copia el valor del campo
El nombre está en el enlace de configuración de la transmisión
after_start_time - la hora de inicio de la transmisión en el formato: '2023-04-18 13:30:00'.
! email - dirección de correo electrónico del estudiante
¡Presta atención! El nombre de la variable puede ser cualquier nombre que te resulte cómodo y comprensible. En caso de error al escribir los parámetros de la función, se escribirá un mensaje en la variable: wrong translation_guid
En este caso, recomendamos comprobar los parámetros de la función y volver a probarlos. Para obtener el valor del tiempo de permanencia en el seminario web a partir de una variable en el Calculator, puedes usar la función de trabajar con arrays y diccionarios. enlace/enlace arrays y diccionarios.
Ejemplo de configuración en el Block Calculator:
time_spent1 = answer2[0]['time_spent']
¿Cómo encontrar el nombre del estudiante vinculado a un bot?
Hay casos en los que los estudiantes pueden estar vinculados al chat en línea de la cuenta personal de un estudiante, así como aquellos que están vinculados a un mensajero y escriben a tus supervisores a través de un bot. Para emitir correctamente certificados nominativos de finalización del curso en el bot y no buscar el nombre del estudiante en la lista, existe una función:
get_customer_name() - devuelve el nombre del estudiante asociado con el cliente.
Una función sin parámetros.
Devuelve el nombre del estudiante que el estudiante introdujo durante el registro en el curso, o el nombre del estudiante de su cuenta personal.
Última actualización