Trabalhando com links
Links com notificação de clique
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 tempo de expiração especificado. A função recebe os seguintes parâmetros: ! link - link ! date - data de expiração do link ! time - horário 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.
Exemplo
Vamos ver 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 relembrar 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 esse 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 tiver sido 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 copiar
Exemplo de código para o campo "Mensagem" (não se esqueça de ativar Markdown se você estiver trabalhando com o Telegram):
*Testando links:*
[Clique](#{link3})ou teste usando o seguinte formato de saída:
Testando links:
#{link2}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 na forma 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.
Encurtamento de links
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 com um tempo de expiração especificado. A função recebe os seguintes parâmetros: ! link - link ! date - data de expiração do link ! time - horário 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 com 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.
Remoção de links
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
Link de quiz do bot do Telegram
quiz_link_timeout() | quiz_link_date() | quiz_link()
Por favor, observe!
Há um limite de 21 dias para a validade do link, então ele precisa ser renovado!
Para ativar a exibição do quiz no Telegram, você precisa:
1. Copiar o ID de uma página do site. Para isso, vá até a seção "Sites" e selecione o site desejado:
Mais adiante no texto, nos referiremos a mini_landing_page_id como 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 duração definido em minutos
Parâmetros:
! mini_landing_page_id - ID da página do site minutes - duração 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 em que o link fica ativo (formato: dd.mm.aaaa) time - horário em que o link fica ativo (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
Exemplo
3. Crie um Telegram Web App botão e especifique o nome da variável entre chaves com o símbolo de cerquilha.
Importante! Certifique-se de que o valor da variável esteja salvo corretamente nas configurações avançadas.
Se você usar quiz_link_timeout para redirecionar um cliente para uma página do site, você 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 "John", e a descrição da página incluir "Oi #{name}, como você está?", a saída será "Oi John, como você está?". No entanto, se o cliente não tiver essa variável, o valor será obtido das variáveis globais do projeto.
Atenção! Tenha cuidado ao usar links sem tempo de expiração. Se o link for compartilhado com outra pessoa e ela concluir o quiz, os resultados serão registrados no cliente para o qual o link foi originalmente gerado.
Atualizado