Anatomia de uma mensagem
Cada automação no plugin é uma mensagem — uma linha na tabela com texto, gatilho e regras. Esse artigo cobre cada campo do formulário de criação e edição, pra você saber o que cada um faz antes de configurar a sua primeira.
Acesse WooCommerce → WhatsApp → Adicionar nova pra acompanhar.
Os campos do formulário
Nome da mensagem
Rótulo interno pra você se organizar. Não vai pro cliente. Aparece só na listagem do painel.
Use nomes descritivos do tipo "Lembrete Pix 30min", "Pedido enviado - Correios", "NPS 7 dias após entrega". Quando você tiver 15 mensagens cadastradas, vai agradecer.
Gatilho
O evento que dispara a mensagem. Exemplos: "Novo pedido", "Status processando", "Status concluído", "Código de rastreio adicionado".
A lista é grande e cobre quase tudo do WooCommerce + integrações com plugins de terceiros. Veja Gatilhos: a lista completa de eventos.
Cada mensagem tem um único gatilho. Se você quer disparar dois eventos diferentes, cria duas mensagens.
Mensagem
O texto que vai pro cliente. Suporta:
- Quebras de linha normais (Enter) — viram quebra na mensagem do WhatsApp
- Variáveis entre
{{ }}—{{first_name}},{{order_number}},{{order_total}}etc. Veja Variáveis de mensagem pra lista completa - Formatação WhatsApp —
*negrito*,_itálico_,~tachado~,```código```(cuidado pra não escapar caractere) - Emojis — copie do celular ou use atalhos do WordPress (
:smile:etc, depende do tema)
Sequências
Você pode cadastrar várias mensagens em sequência num mesmo gatilho. O plugin envia uma após a outra automaticamente. Útil pra separar instruções (texto explicativo numa, código Pix sozinho na outra — facilita o copiar/colar).
Detalhes em Sequências de mensagens.
Status
Ativo ou Inativo. Mensagens inativas continuam cadastradas mas não disparam — útil pra pausar sem perder a config.
Quando você está montando uma mensagem e ainda não testou, deixe inativa. Ative só depois de testar pelo menos uma vez (veja a aba Testar).
Destinatário (Receiver)
Pra quem vai a mensagem. Padrão: {{phone_number}} — pega o telefone do pedido/cliente automaticamente.
Casos onde você muda esse campo:
- Mensagem pra um número fixo (ex: notificação interna pro gerente). Coloque o número direto:
5511999999999 - Cópia pra um segundo destinatário — não dá em uma mensagem só (cria uma segunda mensagem com o mesmo gatilho e o número fixo)
Sempre prefira {{phone_number}}. Forçar número fixo só faz sentido pra notificações administrativas (avisar o lojista, não o cliente).
Contato (Google Contacts)
Nome usado se a mensagem incluir um cartão de contato anexado à conversa. Funciona em conjunto com algumas integrações Rishi específicas.
Pra automações comuns (texto puro pro cliente), deixe em branco.
Envio assíncrono
Define se a mensagem vai direto ou entra numa fila do Action Scheduler do WooCommerce.
| Opção | Quando usar |
|---|---|
| Não (síncrono) | Padrão. Mensagem é enviada imediatamente quando o evento ocorre |
| Sim (assíncrono) | Mensagens em alto volume, ou quando você quer que o checkout não fique esperando o envio. A mensagem entra na fila e é processada em background |
Mensagens com delay (ex: lembrete Pix 30min depois) sempre vão pelo agendamento, independente dessa opção. Veja Mensagens agendadas e fila assíncrona.
Filtros (hook_params)
Aqui você refina quando a mensagem deve disparar dentro do gatilho escolhido. Ex: dispara só pra Pix, só pra produtos da categoria X, só com 30 minutos de atraso.
Esse é um campo poderoso e tem artigo próprio: Filtros: gateway, categoria, status, delay.
Salvando
Clicou em Salvar com Ativo? A mensagem já está valendo. O próximo evento que bater no gatilho vai disparar pro cliente real.
Antes de ativar, faça um teste. Use a aba Testar com um número seu pra ver se o texto sai como esperado, se as variáveis estão preenchendo, se a quebra de linha está OK. É 30 segundos que evita uma mensagem quebrada chegando em 200 clientes.