Bot do Afiliado

Como personalizar as mensagens e variáveis (templates) do bot

Personalize as mensagens do Bot do Afiliado com variáveis como nome, link, título e preço. Referência completa dos placeholders disponíveis.

Nesta página

As mensagens do bot aceitam placeholders no formato {variavel}. No envio, o sistema substitui pelos valores reais do contexto (usuário, chat, bot e link).

Variáveis disponíveis

VariávelDescriçãoExemplo
{nome}Primeiro nome do usuárioOlá {nome}!
{@usuario}Menção clicável do usuário (HTML)Oi {@usuario}!
{usuario}Username sem @ (quando existir)Seu user: {usuario}
{id}ID do usuário (Telegram)Seu id: {id}
{chatid}ID do chatchat: {chatid}
{data}Data atual (America/Sao_Paulo)Hoje: {data}
{hora}Hora atual (America/Sao_Paulo)Agora: {hora}
{bot}Nome do botBem-vindo ao {bot}
{linkgerado}Link final geradoSeu link: {linkgerado}
{link}Alias de {linkgerado}{link}
{linkoriginal}URL original enviada{linkoriginal}
{linkresolvido}URL após resolver redirects{linkresolvido}
{titulo}Título da oferta (quando disponível){titulo}
{preco}Preço (quando disponível){preco}
{mensagemextra}Mensagem extra configurada no plugin{mensagemextra}

Regras

  • Variáveis desconhecidas viram string vazia.
  • Em mensagens HTML, os valores de usuário/chat são escapados para evitar injeção; {@usuario} é gerado de forma segura.

Onde usar

  • Templates de oferta (/oferta, /cupom) — veja Ofertas.
  • Mensagem de boas-vindas (/start).
  • Comandos personalizados e broadcast.
Editor de template no painel com variáveis como {senderName} e {link} e o botão de pré-visualizar

Customizar o formato no painel

Na aba Customizar, você ajusta o formato de cada tipo de post (oferta, cupom e rodapé; 1 produto ou lista) usando essas variáveis — com chips clicáveis para inserir cada uma:

Além das variáveis acima, os formatos de oferta/cupom têm variáveis próprias:

VariávelDescrição
{cupom}Código do cupom da oferta.
{itens}Lista de produtos já formatados (posts com vários itens).
{footer}Texto do rodapé configurado (por marketplace ou global).
{cta}Chamada para ação da oferta (ex.: Compre aqui 👇). Aparece exatamente onde você colocar {cta} no formato. Se você não usar {cta}, a chamada não aparece — mesmo que preencha o campo CTA.
Tela Customização do formato no painel: abas de template (post com cupom, post de oferta, rodapé) e as variáveis título, preço e link como chips

Em Prévia com links reais, cole um link de verdade e veja o resultado renderizado na hora — com imagem, título e preço — antes de usar:

Prévia com links reais: campo para colar um link e a oferta renderizada com imagem, título, preço e cupom

Perguntas frequentes

O que acontece se eu usar uma variável que não existe na mensagem do bot?

Variáveis desconhecidas viram texto vazio. Use apenas as variáveis listadas para garantir o resultado.

É seguro usar dados do usuário nas variáveis da mensagem do bot no Telegram?

Sim. Em mensagens HTML, os valores de usuário/chat são escapados automaticamente para evitar injeção de HTML.

Onde edito os templates de mensagem do bot do Telegram?

No painel (aba de mensagens/templates) ou, para admins, pelo comando de template no Telegram.

Pronto para automatizar suas comissões?

Crie seu bot, conecte suas integrações e comece a converter links em segundos.