proxy() | proxy_date() | proxy_timeout()

LEGENDA:

! - Parâmetros obrigatórios

proxy(lnk, one-shot) - gera um link com notificação de clique. A função recebe os seguintes parâmetros:\ ! link - link
one-shot - indicador de que o link é de uso único. Basta passar o valor 1.

proxy_date(lnk, date, time) - gera um link com notificação de clique e um prazo de expiração especificado. A função recebe os seguintes parâmetros:\ ! link - link\ ! date - data de expiração do link \ ! time - hora de expiração do link
one-shot - indicador de que o link é de uso único. Basta passar 1.

proxy_timeout(lnk, minutes, one-shot) - gera um link com notificação de clique e um temporizador de acesso especificado. A função recebe os seguintes parâmetros:\ ! link - link\ ! minutes - o número de minutos que o link permanece ativo.
one-shot - indicador de que o link é de uso único. Basta passar 1.

Vamos analisar um exemplo simples:

Criamos dois links proxy e os inserimos em botões e no texto da mensagem. Como estamos testando no Telegram, é uma boa oportunidade para lembrar como formatar links corretamente usando Markdown. Para lidar com caracteres especiais, usamos a função tg_escape().

É assim que o cliente os vê, por exemplo, no Telegram:

Quando o cliente clica no link, recebemos um callback:

Vamos configurar uma resposta para este evento:

Agora, vamos testar as funções de remoção de links:

Assim, se o cliente tentar usar o link de uso único depois que ele foi excluído, receberá um erro porque o link não existe mais.

Vamos excluir o link com limite de tempo:

Após executar a função, nenhum link proxy permanece no cartão do cliente, e qualquer tentativa de seguir o link retorna o mesmo erro.

Exemplo de código para o campo "Mensagem" (não se esqueça de ativar Markdown se estiver trabalhando com Telegram):

*Testando links:*
[Clique](#{link3})

ou teste usando o seguinte formato de saída:

Exemplo de código no campo "Calculadora": 

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

Quando um cliente clica em um link proxy, você receberá um callback no formato link_was_pressed. Isso permite configurar uma reação ao clique no link.

Para fazer isso, insira o callback recebido no campo "Condição" e defina o tipo de correspondência como Correspondência Exata.

short() | short_date() | short_timeout()

LEGENDA:

! - Parâmetros obrigatórios

short(lnk, one-shot) - gera um link sem notificação de clique. A função recebe os seguintes parâmetros:\ ! link - link
one-shot - indicador de que o link é de uso único. Basta passar o valor 1.

short_date(lnk, date, time) - gera um link sem notificação de clique e um prazo de expiração especificado. A função recebe os seguintes parâmetros:\ ! link - link\ ! date - data de expiração do link \ ! time - hora de expiração do link
one-shot - indicador de que o link é de uso único. Basta passar 1.

short_timeout(lnk, minutes, one-shot) - gera um link sem notificação de clique e um temporizador de acesso especificado. A função recebe os seguintes parâmetros:\ ! link - link\ ! minutes - o número de minutos que o link permanece ativo.
one-shot - indicador de que o link é de uso único. Basta passar 1.

remove_links() | remove_one_time_links()| remove_timer_links()

LEGENDA:

! - Parâmetros obrigatórios

remove_links() - desativação de todos os links encurtados enviados ao cliente


remove_one_time_links() - desativação de todos os links de uso único enviados ao cliente

remove_timer_links() - desativação de todos os links com limite de tempo enviados ao cliente

quiz_link_timeout() | quiz_link_date() | quiz_link()

Por favor, observe!

Há um limite de 21 dias para a validade do link, portanto, ele deve ser renovado!

Para habilitar a exibição do quiz no Telegram, você precisa:

1. Copiar o ID de uma página do site. Para fazer isso, vá para a seção "Sites" e selecione o site desejado:

No texto a seguir, nos referiremos a mini_landing_page_id como o nome da variável.

2. No campo "Calculadora", use uma das seguintes funções:

LEGENDA:

! - Parâmetros obrigatórios

quiz_link_timeout(mini_landing_page_id, minutes) - gera um link com um limite de vida útil definido em minutos

Parâmetros:

! mini_landing_page_id - ID da página do site
minutes - tempo de vida do link em minutos (tipo: número)

quiz_link_date(mini_landing_page_id, date, time) - gera um link com expiração limitada a uma data e hora específicas

Parâmetros:

! mini_landing_page_id - ID da página do site
date - data ativa do link (formato: dd.mm.yyyy)
time - hora ativa do link (formato: hh:mm)

quiz_link(mini_landing_page_id) - gera um link sem tempo de expiração

Parâmetros:

! mini_landing_page_id - ID da página do site

3. Crie um botão Telegram Web App e especifique o nome da variável entre chaves com um símbolo de hash.

Importante!
Certifique-se de que o valor da variável seja salvo corretamente nas configurações avançadas.

Se você usar quiz_link_timeout para redirecionar um cliente para uma página do site, pode usar variáveis do cliente no título e na descrição da página. Por exemplo, se o cliente tiver uma variável name com o valor "João", e a descrição da página incluir "Olá #{name}, como você está?", a saída será "Olá João, como você está?". No entanto, se o cliente não tiver essa variável, o valor será obtido das variáveis globais do projeto.

Nota! Tenha cuidado ao usar links sem tempo de expiração. Se o link for compartilhado com outra pessoa e ela completar o quiz, os resultados serão registrados sob o cliente para o qual o link foi originalmente gerado.