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