Enlaces con notificación de clic
proxy() | proxy_date() | proxy_timeout()
LEYENDA:
! - Parámetros obligatorios
proxy(lnk, one-shot) - genera un enlace con notificación de clic. La función toma los siguientes parámetros:\ ! enlace - enlace
one-shot - indicador de que el enlace es de un solo uso. Simplemente pasa el valor 1.
proxy_date(lnk, date, time) - genera un enlace con notificación de clic y una fecha de caducidad especificada. La función toma los siguientes parámetros:\ ! enlace - enlace\ ! fecha - fecha de caducidad del enlace \ ! hora - hora de caducidad del enlace
one-shot - indicador de que el enlace es de un solo uso. Simplemente pasa 1.
proxy_timeout(lnk, minutes, one-shot) - genera un enlace con notificación de clic y un temporizador de acceso especificado. La función toma los siguientes parámetros:\ ! enlace - enlace\ ! minutos - el número de minutos que el enlace permanece activo.
one-shot - indicador de que el enlace es de un solo uso. Simplemente pasa 1.
Veamos un ejemplo sencillo:
Hemos creado dos enlaces proxy y los hemos insertado en botones y en el texto del mensaje. Como estamos probando en Telegram, es una buena oportunidad para recordar cómo formatear enlaces correctamente usando Markdown. Para manejar caracteres especiales, hemos utilizado la función tg_escape().
Así es como los ve el cliente, por ejemplo, en Telegram:
Cuando el cliente hace clic en el enlace, recibimos un callback:
Configuremos una respuesta a este evento:
Ahora, probemos las funciones de eliminación de enlaces:
Por lo tanto, si el cliente intenta usar el enlace de un solo uso después de que haya sido eliminado, recibirá un error porque el enlace ya no existe.
Eliminemos el enlace con límite de tiempo:
Después de ejecutar la función, no quedan enlaces proxy en la tarjeta del cliente, y cualquier intento de seguir el enlace devuelve el mismo error.
Código de ejemplo para el campo "Mensaje" (no olvides habilitar Markdown si trabajas con Telegram):
*Probando enlaces:*
[Click](#{link3})
o prueba usando el siguiente formato de salida:
Ejemplo de código en el campo "Calculadora":
link1=proxy('https://mavibot.ai/', 1)
link2=short_date('https://mavibot.ai/#tariff', '11.06.2025', '2pm')
link3=tg_escape(link2)
Cuando un cliente hace clic en un enlace proxy, recibirás un callback en la forma link_was_pressed. Esto te permite configurar una reacción al clic en el enlace.
Para ello, introduce el callback recibido en el campo "Condición" y establece el tipo de coincidencia en Coincidencia Exacta.
Acortamiento de enlaces
short() | short_date() | short_timeout()
LEYENDA:
! - Parámetros obligatorios
short(lnk, one-shot) - genera un enlace sin notificación de clic. La función toma los siguientes parámetros:\ ! enlace - enlace
one-shot - indicador de que el enlace es de un solo uso. Simplemente pasa el valor 1.
short_date(lnk, date, time) - genera un enlace sin notificación de clic y una fecha de caducidad especificada. La función toma los siguientes parámetros:\ ! enlace - enlace\ ! fecha - fecha de caducidad del enlace \ ! hora - hora de caducidad del enlace
one-shot - indicador de que el enlace es de un solo uso. Simplemente pasa 1.
short_timeout(lnk, minutes, one-shot) - genera un enlace sin notificación de clic y un temporizador de acceso especificado. La función toma los siguientes parámetros:\ ! enlace - enlace\ ! minutos - el número de minutos que el enlace permanece activo.
one-shot - indicador de que el enlace es de un solo uso. Simplemente pasa 1.
Eliminación de enlaces
remove_links() | remove_one_time_links()| remove_timer_links()
LEYENDA:
! - Parámetros obligatorios
remove_links() - desactivación de todos los enlaces acortados enviados al cliente
remove_one_time_links() - desactivación de todos los enlaces de un solo uso enviados al cliente
remove_timer_links() - desactivación de todos los enlaces con límite de tiempo enviados al cliente
Enlace de cuestionario de bot de Telegram
quiz_link_timeout() | quiz_link_date() | quiz_link()
¡Ten en cuenta!
Hay un límite de 21 días en la validez del enlace, ¡por lo que debe actualizarse!
Para habilitar la visualización del cuestionario en Telegram, debes:
1. Copiar el ID de una página web. Para ello, ve a la sección "Sitios web" y selecciona el sitio web deseado:
En adelante, nos referiremos a mini_landing_page_id como el nombre de la variable.
2. En el campo "Calculadora", utiliza una de las siguientes funciones:
LEYENDA:
! - Parámetros obligatorios
quiz_link_timeout(mini_landing_page_id, minutes) - genera un enlace con un límite de vida establecido en minutos
Parámetros:
! mini_landing_page_id - ID de la página web
minutes - vida útil del enlace en minutos (tipo: número)
quiz_link_date(mini_landing_page_id, date, time) - genera un enlace con una caducidad limitada a una fecha y hora específicas
Parámetros:
! mini_landing_page_id - ID de la página web
date - fecha activa del enlace (formato: dd.mm.aaaa)
time - hora activa del enlace (formato: hh:mm)
quiz_link(mini_landing_page_id) - genera un enlace sin tiempo de caducidad
Parámetros:
! mini_landing_page_id - ID de la página web
3. Crea un botón de Aplicación Web de Telegram y especifica el nombre de la variable entre llaves con un símbolo de almohadilla.
¡Importante!
Asegúrate de que el valor de la variable se guarde correctamente en la configuración avanzada.
Si usas quiz_link_timeout para redirigir a un cliente a una página web, puedes usar variables de cliente dentro del título y la descripción de la página. Por ejemplo, si el cliente tiene una variable name con el valor "John", y la descripción de la página incluye "Hola #{name}, ¿cómo estás?", la salida será "Hola John, ¿cómo estás?". Sin embargo, si el cliente no tiene esa variable, el valor se tomará de las variables globales del proyecto.
¡Nota! Ten cuidado al usar enlaces sin tiempo de caducidad. Si el enlace se comparte con otra persona y completa el cuestionario, los resultados se registrarán bajo el cliente para quien se generó originalmente el enlace.