proxy() | proxy_date() | proxy_timeout()

LEGENDE:

! - Erforderliche Parameter

proxy(lnk, one-shot) - generiert einen Link mit Klickbenachrichtigung. Die Funktion akzeptiert folgende Parameter:\ ! link - Link
one-shot - Indikator, dass der Link einmalig verwendbar ist. Einfach den Wert 1 übergeben.

proxy_date(lnk, date, time) - generiert einen Link mit Klickbenachrichtigung und einer angegebenen Ablaufzeit. Die Funktion akzeptiert folgende Parameter:\ ! link - Link\ ! date - Ablaufdatum des Links \ ! time - Ablaufzeit des Links
one-shot - Indikator, dass der Link einmalig verwendbar ist. Einfach 1 übergeben.

proxy_timeout(lnk, minutes, one-shot) - generiert einen Link mit Klickbenachrichtigung und einem angegebenen Zugriffs-Timer. Die Funktion akzeptiert folgende Parameter:\ ! link - Link\ ! minutes - Anzahl der Minuten, die der Link aktiv bleibt.
one-shot - Indikator, dass der Link einmalig verwendbar ist. Einfach 1 übergeben.

Gehen wir ein einfaches Beispiel durch:

Wir haben zwei Proxy-Links erstellt und sie in Buttons und den Nachrichtentext eingefügt. Da wir in Telegram testen, ist dies eine gute Gelegenheit, sich daran zu erinnern, wie man Links mit Markdown richtig formatiert. Zur Behandlung von Sonderzeichen haben wir die Funktion tg_escape() verwendet.

So sieht der Client sie beispielsweise in Telegram:

Wenn der Client auf den Link klickt, erhalten wir einen Callback:

Konfigurieren wir eine Antwort auf dieses Ereignis:

Testen wir nun die Funktionen zum Entfernen von Links:

Wenn der Client also versucht, den einmaligen Link zu verwenden, nachdem er gelöscht wurde, erhält er einen Fehler, da der Link nicht mehr existiert.

Löschen wir den zeitlich begrenzten Link:

Nach der Ausführung der Funktion verbleiben keine Proxy-Links mehr in der Client-Karte, und jeder Versuch, dem Link zu folgen, gibt denselben Fehler zurück.

Beispielcode für das Feld "Nachricht" (vergessen Sie nicht, Markdown zu aktivieren, wenn Sie mit Telegram arbeiten):

*Links testen:*
[Klicken](#{link3})

oder testen Sie mit dem folgenden Ausgabeformat:

Codebeispiel im Feld "Rechner": 

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

Wenn ein Client auf einen Proxy-Link klickt, erhalten Sie einen Callback in der Form link_was_pressed. Dies ermöglicht es Ihnen, eine Reaktion auf den Link-Klick zu konfigurieren.

Geben Sie dazu den erhaltenen Callback in das Feld "Bedingung" ein und setzen Sie den Übereinstimmungstyp auf Exakte Übereinstimmung.

Linkverkürzung

short() | short_date() | short_timeout()

LEGENDE:

! - Erforderliche Parameter

short(lnk, one-shot) - generiert einen Link ohne Klickbenachrichtigung. Die Funktion akzeptiert folgende Parameter:\ ! link - Link
one-shot - Indikator, dass der Link einmalig verwendbar ist. Einfach den Wert 1 übergeben.

short_date(lnk, date, time) - generiert einen Link ohne Klickbenachrichtigung und einer angegebenen Ablaufzeit. Die Funktion akzeptiert folgende Parameter:\ ! link - Link\ ! date - Ablaufdatum des Links \ ! time - Ablaufzeit des Links
one-shot - Indikator, dass der Link einmalig verwendbar ist. Einfach 1 übergeben.

short_timeout(lnk, minutes, one-shot) - generiert einen Link ohne Klickbenachrichtigung und einem angegebenen Zugriffs-Timer. Die Funktion akzeptiert folgende Parameter:\ ! link - Link\ ! minutes - Anzahl der Minuten, die der Link aktiv bleibt.
one-shot - Indikator, dass der Link einmalig verwendbar ist. Einfach 1 übergeben.

Linkentfernung

remove_links() | remove_one_time_links()| remove_timer_links()

LEGENDE:

! - Erforderliche Parameter

remove_links() - Deaktivierung aller an den Client gesendeten verkürzten Links


remove_one_time_links() - Deaktivierung aller an den Client gesendeten einmaligen Links

remove_timer_links() - Deaktivierung aller an den Client gesendeten zeitlich begrenzten Links

quiz_link_timeout() | quiz_link_date() | quiz_link()

Bitte beachten Sie!

Es gibt eine 21-Tage-Begrenzung für die Gültigkeit des Links, daher muss er aktualisiert werden!

Um die Quiz-Anzeige in Telegram zu aktivieren, müssen Sie:

1. Kopieren Sie eine Website-Seiten-ID. Gehen Sie dazu zum Bereich "Websites" und wählen Sie die gewünschte Website aus:

Im weiteren Text bezeichnen wir mini_landing_page_id als Variablennamen.

2. Verwenden Sie im Feld "Rechner" eine der folgenden Funktionen:

LEGENDE:

! - Erforderliche Parameter

quiz_link_timeout(mini_landing_page_id, minutes) - generiert einen Link mit einer in Minuten festgelegten Lebensdauerbegrenzung

Parameter:

! mini_landing_page_id - Website-Seiten-ID
minutes - Lebensdauer des Links in Minuten (Typ: Zahl)

quiz_link_date(mini_landing_page_id, date, time) - generiert einen Link mit einem auf ein bestimmtes Datum und eine bestimmte Uhrzeit begrenzten Ablauf

Parameter:

! mini_landing_page_id - Website-Seiten-ID
date - aktives Datum des Links (Format: dd.mm.yyyy)
time - aktive Zeit des Links (Format: hh:mm)

quiz_link(mini_landing_page_id) - generiert einen Link ohne Ablaufzeit

Parameter:

! mini_landing_page_id - Website-Seiten-ID

3. Erstellen Sie einen Telegram Web App-Button und geben Sie den Variablennamen in geschweiften Klammern mit einem Hash-Symbol an.

Wichtig!
Stellen Sie sicher, dass der Variablenwert in den erweiterten Einstellungen korrekt gespeichert ist.

Wenn Sie quiz_link_timeout verwenden, um einen Client auf eine Website-Seite umzuleiten, können Sie Client-Variablen innerhalb des Seitentitels und der Beschreibung verwenden. Wenn der Client beispielsweise eine Variable name mit dem Wert "John" hat und die Seitenbeschreibung "Hallo #{name}, wie geht es dir?" enthält, lautet die Ausgabe "Hallo John, wie geht es dir?". Wenn der Client diese Variable jedoch nicht hat, wird der Wert aus den globalen Variablen des Projekts übernommen.

Hinweis! Seien Sie vorsichtig bei der Verwendung von Links ohne Ablaufzeit. Wenn der Link mit jemand anderem geteilt wird und diese Person das Quiz abschließt, werden die Ergebnisse unter dem Client aufgezeichnet, für den der Link ursprünglich generiert wurde.