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.
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}
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: