Comunicação e Mensagens com OpenClaw: Templates e Formatação

Você já recebeu aquela mensagem genérica de “Olá, como posso ajudar?” e sentiu que estava falando com um robô? É exatamente isso que vamos evitar aqui. Mensagem boa não é mensagem longa — é mensagem certa, na hora certa, com o contexto certo.

Este capítulo cobre como estruturar, formatar e personalizar mensagens no OpenClaw para que pareçam humanas mesmo quando são automáticas.

Por Que a Estrutura da Mensagem Importa

O WhatsApp tem um conjunto de formatação próprio que a maioria das pessoas usa sem perceber. Textos com *negrito* e _itálico_ chamam atenção diferente de texto plano. Quando você está automatizando mensagens, usar essa formatação corretamente faz diferença entre uma mensagem que parece profissional e uma que parece spam.

O WhatsApp suporta os seguintes marcadores de formatação:

*texto* → negrito — use para valores, datas e informações-chave
_texto_ → itálico — use para ênfase suave ou termos técnicos
`texto` → monoespaçado — perfeito para códigos de pedido, chaves PIX, IDs
~texto~ → ~~tachado~~ — útil para mostrar preço original vs desconto

Mas existe uma regra não escrita mais importante do que qualquer formatação: uma mensagem, uma informação. Não sobrecarregue o cliente com tudo de uma vez.

Template Variables: O Padrão `{{VARIAVEL}}`

Templates são mensagens com lacunas que você preenche dinamicamente. A convenção usada pelo OpenClaw (e pela maioria das plataformas de mensagens) é {{NOME_DA_VARIAVEL}} em maiúsculas com underscores.

Exemplos de variáveis comuns:

{{NOME}}         → nome do cliente
{{PRODUTO}}      → nome do produto ou serviço
{{VALOR}}        → valor em R$ formatado
{{PEDIDO}}       → código do pedido
{{STATUS}}       → status atual (ex: "em preparo", "a caminho")
{{DATA}}         → data relevante
{{LINK}}         → link de pagamento ou rastreio

Uma mensagem de confirmação de pedido ficaria assim no template:

Olá, {{NOME}}! 👋

Seu pedido *#{{PEDIDO}}* foi confirmado.

📦 Item: {{PRODUTO}}
💰 Valor: R$ {{VALOR}}
📍 Status: {{STATUS}}

{{LINK_PAGAMENTO}}

Qualquer dúvida é só responder aqui.

Depois de preencher as variáveis com dados reais:

Olá, Marina! 👋

Seu pedido *#4821* foi confirmado.

📦 Item: Marmita fitness frango com batata-doce
💰 Valor: R$ 28,90
📍 Status: Em preparo

pix.openclawclubbrasil.com.br/pay/4821

Qualquer dúvida é só responder aqui.

A diferença de percepção é enorme. O cliente sente que a mensagem foi escrita para ele.

Dados Dinâmicos de API

Quando seu fluxo busca dados de uma API externa — um sistema de pedidos, uma planilha, um banco de dados — esses dados precisam ser injetados no template antes do envio. O padrão no OpenClaw é:

Disparar o fluxo com um gatilho (ex: novo pedido criado)
Buscar os dados do pedido via nó HTTP ou banco de dados
Montar o objeto de variáveis: { NOME: "Marina", PEDIDO: "4821", ... }
Passar esse objeto para o nó de mensagem
O OpenClaw substitui as variáveis e envia

O ponto de atenção é a formatação de dados. Um valor que vem da API como 2890 (em centavos) precisa ser convertido para R$ 28,90 antes de ser injetado. Nunca confie que o dado já vem formatado para exibição — trate no fluxo antes de enviar.

Tipos de Mensagem no WhatsApp

Nem toda mensagem é texto simples. O WhatsApp Business API suporta formatos mais ricos:

Mensagem de texto: o básico. Funciona sempre. Não depende de template aprovado se for dentro da janela de 24 horas de conversa ativa.

Mensagem com lista: apresenta opções numeradas para o cliente escolher. Ideal para menu de atendimento (suporte, vendas, status de pedido). Requer API Business.

Mensagem com botões: até 3 botões de resposta rápida. Ótimo para confirmações simples (Confirmar / Cancelar) ou perguntas de triagem (Quero orçamento / Só estou olhando).

Mensagem de mídia: imagem + legenda, ou documento PDF. Use para enviar comprovante PIX, boleto, cardápio, ou catálogo.

A escolha do tipo certo depende do contexto. Para notificações automáticas (confirmação, lembrete), texto simples é suficiente. Para fluxos interativos (triagem de atendimento), botões economizam tempo do cliente.

Políticas de DM por canal

A v2026.3.22 introduziu políticas de DM configuráveis para os 30+ canais suportados:

pairing (padrão) — só responde a contatos previamente pareados
allowlist — lista explícita de números/IDs autorizados
open — qualquer pessoa pode conversar com o agente
disabled — ignora DMs completamente

Para negócios que recebem mensagens de desconhecidos no WhatsApp, allowlist ou pairing evita que o agente responda a números não autorizados.

Rate Limits e Anti-Spam

Este é o ponto onde mais negócios cometem erro grave. O WhatsApp tem limites de envio que, se ultrapassados, resultam em banimento do número. Não é hipotético — acontece.

As regras gerais:

Janela de 24 horas: dentro de 24h após o cliente falar com você, pode enviar qualquer mensagem. Fora dessa janela, precisa de template aprovado pela Meta. A sessão interna do OpenClaw agora dura 48 horas por padrão (v2026.3.22 — era 10 minutos), então o contexto da conversa é mantido por toda a janela ativa do WhatsApp sem reconfiguração.
Limite de mensagens em massa: depende do nível do seu número. Números novos começam com limite baixo e sobem gradualmente com uso legítimo.
Opt-out obrigatório: toda mensagem de marketing precisa ter opção de sair. “Responda SAIR para não receber mais” não é burocracia — é o que evita denúncias.

Para automações, respeite estes princípios:

Nunca envie mais de uma mensagem não solicitada por semana para o mesmo contato
Se o cliente não respondeu a 2 mensagens consecutivas, pare de enviar
Mensagens transacionais (confirmação de pedido, lembrete de pagamento) têm mais tolerância que marketing

Flooding — bombardear o mesmo número com várias mensagens em sequência — é o caminho mais rápido para ter o número bloqueado. Se precisa enviar mais de uma informação, espere 3-5 segundos entre mensagens ou consolide tudo em uma.

Personalização em Escala

Personalizar mensagem para 10 clientes é fácil. Para 500, precisa de padrão. A regra é: personalize o que importa, padronize o resto.

O que vale personalizar:

Nome (sempre)
Produto ou serviço específico (quando relevante)
Referência a interação anterior (“Você perguntou sobre X na semana passada…”)

O que não vale personalizar:

Saudações genéricas do tipo “Como vai você hoje?”
Informações que são iguais para todos (horário de funcionamento, endereço)

A linha entre personalização útil e personalização invasiva é tênue. Usar o bairro do cliente na mensagem pode parecer atencioso ou pode parecer que você está monitorando onde ele mora. Use dados que o próprio cliente forneceu, não dados inferidos.

Tratamento de Erros no Envio

Mensagens falham. O número pode estar inválido, o WhatsApp pode estar fora do ar, a API pode estar com problema. Seu fluxo precisa lidar com isso.

Padrão recomendado:

Tentativa inicial: envia a mensagem
Falha na entrega: aguarda 5 minutos, tenta novamente
Segunda falha: registra o erro, sinaliza para revisão manual
Não tenta mais de 2 vezes automaticamente: evita spam e loops

O erro mais comum a tratar é 400 - invalid phone number. Isso acontece quando o número foi digitado errado pelo cliente. Neste caso, não adianta tentar de novo — precisa de correção humana.

Atenção (v2026.3.22): as variáveis de ambiente MOLTBOT_* e CLAWDBOT_* foram descontinuadas. Se sua configuração de envio de mensagens usa essas variáveis, renomeie para o equivalente OPENCLAW_* — a plataforma para de ler as antigas silenciosamente.

Na Prática

Cenário: pequeno e-commerce de alimentos que vende via WhatsApp. A cada pedido confirmado, o sistema precisa enviar uma mensagem com o resumo e o link PIX.

Estrutura do fluxo:

Gatilho: novo pedido inserido na planilha (Google Sheets) ou sistema
Busca dados do pedido: nome do cliente, itens, valor total, telefone
Gera cobrança PIX via API (Mercado Pago ou Pagar.me)
Monta o objeto de variáveis: { NOME, ITENS, VALOR, LINK_PIX }
Preenche o template de confirmação
Envia via WhatsApp

Template da mensagem:

Olá, {{NOME}}! Seu pedido chegou aqui 🎉

*Resumo do pedido:*
{{ITENS}}

*Total: R$ {{VALOR}}*

Para confirmar, pague via PIX:
`{{LINK_PIX}}`

Assim que o pagamento cair, começo a preparar. Tempo estimado: {{PRAZO}}.

Tratamento de erro: se o PIX não for gerado (API fora do ar), o fluxo envia uma mensagem diferente: “Recebi seu pedido! Vou te mandar o link de pagamento em instantes.” — e sinaliza para o operador resolver manualmente.

Esse padrão separa a confirmação do pedido (imediata) do envio do link (pode atrasar). Melhor uma mensagem incompleta que chega na hora do que uma mensagem perfeita que não chega.

Para ver templates prontos para esse fluxo, acesse a biblioteca de templates. O próximo capítulo cobre como agendar mensagens e rotinas automáticas em Rotinas e Cron.

Baseado no “Automate Everything: The OpenClaw Handbook” por Kelly Claude (CC BY 4.0). Adaptado e expandido para o mercado brasileiro.