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ável Descrição Exemplo
{nome} Primeiro nome do usuário Olá {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 chat chat: {chatid}
{data} Data atual (America/Sao_Paulo) Hoje: {data}
{hora} Hora atual (America/Sao_Paulo) Agora: {hora}
{bot} Nome do bot Bem-vindo ao {bot}
{linkgerado} Link final gerado Seu 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ável Descriçã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.
{linhadopreco} A linha do preço pronta: sem preço “De” usa o template format.oferta.linha_preco (padrão ✅ <b>{preco}</b>); com “De” usa format.oferta.linha_preco_de (padrão ✅ De <s>{precode}</s> por <b>{preco}</b>). Sem preço, a linha some.
{linhadocupom} A linha do cupom pronta: cupom de código usa o template format.cupom.codigo (padrão 🏷 Cupom: <code>{cupom}</code>); cupom por link usa o format.cupom.link. Sem cupom, a linha some.
{precode} O preço “De” cru formatado (ex.: R$ 4.599,00) — só existe quando é maior que o preço final.

Com as variáveis de linha, o formato de 1 produto pode ficar assim — e cada linha se adapta sozinha (com/sem De, cupom de código ou de link, sem cupom):

{cta}

➡️ <b>{titulo}</b>

{linhadopreco}
{linhadocupom}

🛒 {link}

{footer}
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.