Travail avec les liens

Liens avec notification de clic

proxy() | proxy_date() | proxy_timeout()

LÉGENDE :

! - Paramètres requis

proxy(lnk, one-shot) - génère un lien avec notification de clic. La fonction prend les paramètres suivants : ! lien -lien one-shot -indicateur que le lien est à usage unique. Il suffit de passer la valeur 1.

proxy_date(lnk, date, time) - génère un lien avec notification de clic et une heure d’expiration spécifiée. La fonction prend les paramètres suivants : ! lien - lien ! date - date d’expiration du lien ! heure - heure d’expiration du lien one-shot - indicateur que le lien est à usage unique. Il suffit de passer 1.

proxy_timeout(lnk, minutes, one-shot) - génère un lien avec notification de clic et un minuteur d’accès spécifié. La fonction prend les paramètres suivants : ! lien - lien ! minutes - le nombre de minutes pendant lesquelles le lien reste actif. one-shot - indicateur que le lien est à usage unique. Il suffit de passer 1.

Exemple

Passons par un exemple simple :

Nous avons créé deux liens proxy et les avons insérés dans des boutons et dans le texte du message. Comme nous testons dans Telegram, c’est une bonne occasion de rappeler comment formater correctement les liens à l’aide de Markdown. Pour gérer les caractères spéciaux, nous avons utilisé la fonction tg_escape().

Voici comment le client les voit, par exemple, dans Telegram :

Lorsque le client clique sur le lien, nous recevons un callback :

Configurons une réponse à cet événement :

Maintenant, testons les fonctions de suppression de liens :

Ainsi, si le client essaie d’utiliser le lien à usage unique après sa suppression, il recevra une erreur car le lien n’existe plus.

Supprimons le lien à durée limitée :

Après l’exécution de la fonction, il ne reste plus de liens proxy dans la fiche client, et toute tentative de suivre le lien renvoie la même erreur.

*Test des liens :*
[Cliquer](#{link3})

Test des liens :
#{link2}

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

Raccourcissement de lien

short() | short_date() | short_timeout()

LÉGENDE :

! - Paramètres requis

short(lnk, one-shot) - génère un lien sans notification de clic. La fonction prend les paramètres suivants : ! lien -lien one-shot -indicateur que le lien est à usage unique. Il suffit de passer la valeur 1.

short_date(lnk, date, time) - génère un lien sans notification de clic et avec une heure d’expiration spécifiée. La fonction prend les paramètres suivants : ! lien - lien ! date - date d’expiration du lien ! heure - heure d’expiration du lien one-shot - indicateur que le lien est à usage unique. Il suffit de passer 1.

short_timeout(lnk, minutes, one-shot) - génère un lien sans notification de clic et avec un minuteur d’accès spécifié. La fonction prend les paramètres suivants : ! lien - lien ! minutes - le nombre de minutes pendant lesquelles le lien reste actif. one-shot - indicateur que le lien est à usage unique. Il suffit de passer 1.

Suppression de liens

remove_links() | remove_one_time_links()| remove_timer_links()

LÉGENDE :

! - Paramètres requis

remove_links() - désactivation de tous les liens raccourcis envoyés au client

remove_one_time_links() - désactivation de tous les liens à usage unique envoyés au client

remove_timer_links() - désactivation de tous les liens à durée limitée envoyés au client

Lien de quiz du bot Telegram

quiz_link_timeout() | quiz_link_date() | quiz_link()

Pour activer l’affichage du quiz dans Telegram, vous devez :

1. Copier l’ID d’une page du site. Pour ce faire, allez dans la section « Sites web » et sélectionnez le site souhaité :

Plus loin dans le texte, nous ferons référence à mini_landing_page_id comme nom de variable.

2. Dans le champ « Calculatrice », utilisez l’une des fonctions suivantes :

LÉGENDE :

! - Paramètres requis

quiz_link_timeout(mini_landing_page_id, minutes) - génère un lien avec une durée de validité définie en minutes

Paramètres :

! mini_landing_page_id - ID de la page du site web minutes - durée de validité du lien en minutes (type : nombre)

quiz_link_date(mini_landing_page_id, date, time) - génère un lien avec une expiration limitée à une date et une heure spécifiques

Paramètres :

! mini_landing_page_id - ID de la page du site web date - date d’activation du lien (format : jj.mm.aaaa) heure - heure d’activation du lien (format : hh:mm)

quiz_link(mini_landing_page_id) - génère un lien sans durée d’expiration

Paramètres :

! mini_landing_page_id - ID de la page du site web

Exemple

3. Créez un Telegram Web App bouton et spécifiez le nom de la variable entre accolades avec un symbole dièse.

Important ! Assurez-vous que la valeur de la variable est correctement enregistrée dans les paramètres avancés.

Si vous utilisez quiz_link_timeout pour rediriger un client vers une page du site, vous pouvez utiliser des variables client dans le titre et la description de la page. Par exemple, si le client a une variable name avec la valeur « John », et que la description de la page inclut « Hi #{name}, how are you? », la sortie sera « Hi John, how are you? ». Toutefois, si le client ne possède pas cette variable, la valeur sera extraite des variables globales du projet.

Remarque ! Faites attention lorsque vous utilisez des liens sans date d’expiration. Si le lien est partagé avec quelqu’un d’autre et que cette personne remplit le quiz, les résultats seront enregistrés sous le client pour lequel le lien a été généré à l’origine.