Liens avec notification de clic
proxy() | proxy_date() | proxy_timeout()
LÉGENDE:
! - Paramètres obligatoires
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. Passez simplement la valeur 1.
proxy_date(lnk, date, time) - génère un lien avec notification de clic et une date d'expiration spécifiée. La fonction prend les paramètres suivants :\ ! lien - lien\ ! date - date d'expiration du lien \ ! time - heure d'expiration du lien
one-shot - indicateur que le lien est à usage unique. Passez simplement 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. Passez simplement 1.
Prenons un exemple simple :
Nous avons créé deux liens proxy et les avons insérés dans des boutons et le texte du message. Comme nous testons dans Telegram, c'est une bonne occasion de rappeler comment formater correctement les liens en utilisant 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 lien :
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 limité dans le temps :
Après avoir exécuté la fonction, aucun lien proxy ne reste dans la fiche client, et toute tentative de suivre le lien renvoie la même erreur.
Exemple de code pour le champ "Message" (n'oubliez pas d'activer Markdown si vous travaillez avec Telegram) :
*Test des liens :*
[Cliquez](#{link3})
ou testez en utilisant le format de sortie suivant :
Exemple de code dans le champ "Calculatrice" :
link1=proxy('https://mavibot.ai/', 1)
link2=short_date('https://mavibot.ai/#tariff', '11.06.2025', '2pm')
link3=tg_escape(link2)
Lorsqu'un client clique sur un lien proxy, vous recevrez un callback sous la forme link_was_pressed. Cela vous permet de configurer une réaction au clic sur le lien.
Pour ce faire, saisissez le callback reçu dans le champ "Condition" et définissez le type de correspondance sur Correspondance exacte.
Raccourcissement de lien
short() | short_date() | short_timeout()
LÉGENDE:
! - Paramètres obligatoires
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. Passez simplement la valeur 1.
short_date(lnk, date, time) - génère un lien sans notification de clic et avec une date d'expiration spécifiée. La fonction prend les paramètres suivants :\ ! lien - lien\ ! date - date d'expiration du lien \ ! time - heure d'expiration du lien
one-shot - indicateur que le lien est à usage unique. Passez simplement 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. Passez simplement 1.
Suppression de lien
remove_links() | remove_one_time_links()| remove_timer_links()
LÉGENDE:
! - Paramètres obligatoires
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 limités dans le temps envoyés au client
Lien de quiz Telegram bot
quiz_link_timeout() | quiz_link_date() | quiz_link()
Veuillez noter !
Il y a une limite de 21 jours sur la validité du lien, il doit donc être actualisé !
Pour activer l'affichage du quiz dans Telegram, vous devez :
1. Copier l'ID d'une page de site web. Pour ce faire, allez dans la section "Sites web" et sélectionnez le site souhaité :
Dans la suite du 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 obligatoires
quiz_link_timeout(mini_landing_page_id, minutes) - génère un lien avec une limite de durée de vie définie en minutes
Paramètres :
! mini_landing_page_id - ID de la page du site web
minutes - durée de vie 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)
time - heure d'activation du lien (format : hh:mm)
quiz_link(mini_landing_page_id) - génère un lien sans date d'expiration
Paramètres :
! mini_landing_page_id - ID de la page du site web
3. Créez un bouton Telegram Web App 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 de site web, 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 "Bonjour #{name}, comment allez-vous ?", le résultat sera "Bonjour John, comment allez-vous ?". Cependant, si le client ne possède pas cette variable, la valeur sera extraite des variables globales du projet.
Remarque ! Soyez prudent lorsque vous utilisez des liens sans date d'expiration. Si le lien est partagé avec quelqu'un d'autre et qu'il termine le quiz, les résultats seront enregistrés sous le client pour lequel le lien a été initialement généré.