Trabajar con enlaces

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 pase el valor 1.

proxy_date(lnk, date, time) - genera un enlace con notificación de clic y un tiempo de expiración especificado. La función toma los siguientes parámetros: ! enlace - enlace ! date - fecha de expiración del enlace ! tiempo - hora de expiración del enlace one-shot - indicador de que el enlace es de un solo uso. Simplemente pase 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 ! minutes - la cantidad de minutos que el enlace permanece activo. one-shot - indicador de que el enlace es de un solo uso. Simplemente pase 1.

Ejemplo

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 correctamente los enlaces usando Markdown. Para manejar caracteres especiales, hemos usado 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 una devolución de llamada:

Vamos a configurar una respuesta a este evento:

Ahora, probemos las funciones de eliminación de enlaces:

Así, 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.

Vamos a eliminar el enlace con tiempo limitado:

Después de ejecutar la función, no quedan enlaces proxy en la ficha del cliente, y cualquier intento de seguir el enlace devuelve el mismo error.

*Prueba de enlaces:*
[Hacer clic](#{link3})

Prueba de enlaces:
#{link2}

link1=proxy('https://mavibot.ai/', 1) 
link2=short_date('https://mavibot.ai/#tariff', '11.06.2025', '2pm') 
link3=tg_escape(link2)

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 pase el valor 1.

short_date(lnk, date, time) - genera un enlace sin notificación de clic y con un tiempo de expiración especificado. La función toma los siguientes parámetros: ! enlace - enlace ! date - fecha de expiración del enlace ! tiempo - hora de expiración del enlace one-shot - indicador de que el enlace es de un solo uso. Simplemente pase 1.

short_timeout(lnk, minutes, one-shot) - genera un enlace sin notificación de clic y con un temporizador de acceso especificado. La función toma los siguientes parámetros: ! enlace - enlace ! minutes - la cantidad de minutos que el enlace permanece activo. one-shot - indicador de que el enlace es de un solo uso. Simplemente pase 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 tiempo limitado enviados al cliente

Enlace de cuestionario del bot de Telegram

quiz_link_timeout() | quiz_link_date() | quiz_link()

Para habilitar la visualización del cuestionario en Telegram, necesitas:

1. Copia el ID de una página del sitio web. Para hacerlo, ve a la sección "Sitios web" y selecciona el sitio web deseado:

Más adelante en el texto, nos referiremos a mini_landing_page_id como nombre de la variable.

2. En el campo "Calculadora", usa 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 duración establecido en minutos

Parámetros:

! mini_landing_page_id - ID de la página del sitio web minutes - duración del enlace en minutos (tipo: número)

quiz_link_date(mini_landing_page_id, date, time) - genera un enlace con una expiración limitada a una fecha y hora específicas

Parámetros:

! mini_landing_page_id - ID de la página del sitio web date - fecha activa del enlace (formato: dd.mm.yyyy) tiempo - hora activa del enlace (formato: hh:mm)

quiz_link(mini_landing_page_id) - genera un enlace sin tiempo de expiración

Parámetros:

! mini_landing_page_id - ID de la página del sitio web

Ejemplo

3. Crea un Aplicación web de Telegram botón y especifica el nombre de la variable entre llaves con el 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 del sitio web, puedes usar variables del 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 expiración. Si el enlace se comparte con otra persona y completa el cuestionario, los resultados se registrarán bajo el cliente para el que se generó originalmente el enlace.