Registro en el curso
register_customer_on_course(tariff_id, email, email_notification, period, reregistration)
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, los correos electrónicos del cliente no se recibirán!
¿Cómo puedo otorgar acceso al curso a través de la Aplicación Web de Telegram?
Para ello, especifica la función en la Calculadora de Bloques
access_course_from_webapp(text, button_label)
Al usar la función, el estudiante inicia sesión en Telegram y obtiene acceso al curso. Para continuar con la formación, el estudiante no necesita ingresar nombre de usuario y 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 se puede especificar en una variable escribiéndolo en el campo de la Calculadora antes de acceder a la función, o especificarlo en la propia función entre comillas.
button_label - es el texto en el botón de la Aplicación Web. 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 siguiente captura de pantalla 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 'cliente no vinculado al estudiante'.
Para crear dicha conexión, solo necesitas inscribirte en un curso a través de un bot.
Cómo otorgar acceso al curso a través de un bot
register_customer_on_course()
Para ello, especifica la función en la Calculadora de Bloques
register_customer_on_course(tariff_id, email, email_notification, period)
| Parámetros obligatorios | Parámetros opcionales |
|---|---|
| ! tariff_id - el ID del plan de precios. Puedes copiarlo en la línea 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 registro en el curso, si está habilitado. |
| ! email - la dirección de correo electrónico del cliente. Puedes especificar un valor específico o una variable en la que esté registrado el correo electrónico del cliente. | period - límite de tiempo para la validez del plan de precios. Se admiten formatos de fecha como: %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, ¡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 inválido
tariff_added - El plan de precios se agregó al estudiante
Ejemplo:
Cómo verificar la disponibilidad de acceso al curso
has_customer_tariff(tariff_id)
Para ello, especifica la función en la Calculadora de Bloques has_customer_tariff(tariff_id, email)
| Parámetros obligatorios | Parámetros opcionales |
|---|---|
| ! tariff_id - el ID del plan de precios. Puedes copiarlo en la línea 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 verificar 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 inválido tariff_id
customer not found - el usuario no está registrado como estudiante.
Cómo registrar a un cliente en la plataforma SIN otorgar acceso al curso
register_customer(email)
Para ello, especifica la función en la Calculadora de Bloques register_customer(email)
| Parámetros de la función | Descripción |
|---|---|
| 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 marcas de sintaxis, cuadrículas y llaves. Para especificar un valor específico, 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 a continuación: 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 exitosa de la función, la respuesta se escribirá en la variable:
customer created
Cómo verificar el acceso al curso y los límites de tiempo?
Para ello, especifica la función en la Calculadora de Bloques has_customer_tariff_with_date(tariff_id, email), para verificar 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:
| Parámetro obligatorio | Parámetro opcional |
|---|---|
| ! tariff_id - el ID del plan de precios. Puedes copiarlo en la línea 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 en el 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 invá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 la Calculadora de Bloques del_customer_from_course(course_id, email)
| Parámetros | Descripción |
|---|---|
| ! tariff_id | ID del plan de precios |
| dirección de correo electrónico del cliente |
Cómo verificar si un estudiante ha asistido a un seminario web
customer_was_on_translation()
El acceso al curso debe otorgarse en el bot.
Existe una función para esto register_customer_on_course() y access_course_from_webapp()
Para verificar si un estudiante asistió al seminario web o no, especifica la función en la Calculadora de Bloques customer_was_on_translation(translation_guid, email, after_start_time)
| Parámetros obligatorios | Parámetro opcional |
|---|---|
| ! 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 sea conveniente 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 verificar los parámetros de la función y probarlos nuevamente. Para obtener el valor del tiempo de permanencia en el seminario web desde una variable en la Calculadora, puedes usar la función de trabajar con arreglos y diccionarios. enlace arreglos y diccionarios.
Ejemplo de configuración en la Calculadora de Bloques:
time_spent1 = answer2[0]['time_spent']
¿Cómo encontrar el nombre del estudiante vinculado a un bot?
Hay casos en 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 sus supervisores a través de un bot. Para emitir correctamente certificados de finalización del curso con nombre en el bot y no buscar el nombre del estudiante en la lista, existe la 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 ingresó al registrarse en el curso, o el nombre del estudiante de su cuenta personal.