Gatilhos: a lista completa de eventos
O gatilho é o evento da loja que faz uma mensagem disparar. O plugin cobre praticamente tudo o que acontece num pedido WooCommerce + integrações com plugins de terceiros.
Esse artigo é uma referência: lista completa, agrupada por contexto, com o que cada gatilho dispara e quando usar.
Gatilhos de pedido (WooCommerce)
Os gatilhos mais comuns. Disparam em eventos do ciclo de vida do pedido.
| Gatilho | Quando dispara | Caso de uso típico |
|---|---|---|
| Novo pedido | Pedido recém-criado, antes de qualquer mudança de status | Lembrete de Pix/boleto (com filtro de delay) |
| Atualização de status (qualquer) | Toda vez que o pedido muda de status | Mensagens genéricas que dependem da transição (raro) |
| Status pendente | Pedido entra em "Pendente" | Cliente fechou compra mas ainda não pagou |
| Status falhou | Pedido entra em "Falhou" | Pagamento recusado, oferecer outra forma de pagamento |
| Status processando | Pedido entra em "Processando" | Pagamento confirmado — embalando |
| Status concluído | Pedido entra em "Concluído" | Pedido entregue / NPS / pesquisa de satisfação |
| Status aguardando | Pedido entra em "Aguardando" (on-hold) | Pix gerado, aguardando confirmação |
| Status cancelado | Pedido cancelado | Aviso de cancelamento, oferta pra finalizar de novo |
| Status reembolsado | Pedido reembolsado | Confirmação do estorno |
Status customizados (criados via plugins como Order Status Manager) também aparecem na lista automaticamente.
Diferença entre Novo pedido e Status pendente: "Novo pedido" dispara uma vez só, no momento da criação. "Status pendente" dispara sempre que o pedido entrar em pendente — pode ser na criação, ou depois de uma mudança manual de status. Pra lembretes de Pix/boleto, prefira Novo pedido com filtro de status.
Gatilhos de rastreio
Disparam quando um plugin de rastreio adiciona código de rastreio ao pedido. Cada plugin tem seu gatilho próprio:
| Plugin de rastreio | Gatilho |
|---|---|
| Correios for WooCommerce (Claudio Sanches) | Código de rastreio: Correios |
| Mandaê - Plugin Oficial | Código de rastreio: Mandaê |
| Melhor Envio - Fernando Acosta | Código de rastreio: Melhor Envio (FA) |
| Melhor Envio - Oficial | Código de rastreio: Melhor Envio (Oficial) |
| JadLog - Fernando Acosta | Código de rastreio: JadLog |
| Infixs Correios | Código de rastreio: Infixs Correios |
| WooCommerce Shipment Tracking | Código de rastreio: WC Shipment Tracking |
| Any Shipping Notify (Fernando Acosta) | Código de rastreio: Any Shipping |
| Orders Tracking for WooCommerce (VillaTheme) | Código de rastreio: Orders Tracking |
A variável {{tracking_code}} está disponível em todos eles. Veja Códigos de rastreio pra detalhes de cada integração.
Gatilho de entrega (Correios Updater)
| Gatilho | Quando dispara |
|---|---|
| Atualização na entrega | Cada nova movimentação dos Correios (saiu pra entrega, em trânsito, entregue) |
Requer o plugin Correios Status Updater for WooCommerce instalado e ativo. Variáveis específicas: {{correios_updater_message}}, {{correios_updater_place}}, {{correios_updater_date}}.
Gatilhos de cliente
| Gatilho | Quando dispara | Caso de uso |
|---|---|---|
| Recuperação de senha - Envio de link | Cliente clicou em "esqueci a senha" | Mandar o link via WhatsApp em vez de e-mail |
| Link de acesso direto no checkout (WC Smart Checkout) | Cliente solicitou login passwordless no checkout | Autenticar sem digitar senha |
Gatilhos de produto/estoque
| Gatilho | Quando dispara | Caso de uso |
|---|---|---|
| Produto - baixo nível de estoque | Estoque caiu abaixo do limiar configurado no produto | Aviso interno pro gerente repor |
| Produto - sem estoque | Estoque chegou a zero | Aviso interno + avisar interessados (com Back In Stock Notifier) |
Pra avisar clientes quando produto volta ao estoque, use a integração com Back In Stock Notifier. Veja Estoque.
Gatilhos administrativos / agendados
Pra mensagens pro lojista, não pro cliente. Disparam em horários fixos.
| Gatilho | Quando dispara | Caso de uso |
|---|---|---|
| Pedido feito há X dias | Diariamente, varre pedidos antigos. Filtro define quantos dias atrás | NPS pós-entrega, recompra, "saudades de você" |
| Segunda-feira, às 8h da manhã | Toda segunda 8h UTC | Relatório semanal de vendas (variáveis {{reports:weekly_report}}) |
| Sexta-feira, às 18h | Toda sexta 18h UTC | Relatório de fechamento de semana (variável {{reports:friday_report}}) |
Veja Relatórios automáticos pro lojista pra montar.
Gatilho de comunicação interna
| Gatilho | Quando dispara | Caso de uso |
|---|---|---|
| Nota pública adicionada ao pedido | Lojista adiciona nota pública no pedido (que é enviada por e-mail ao cliente) | Espelhar a nota no WhatsApp do cliente |
A variável {{order_note_content}} traz o texto da nota.
Gatilhos de carrinho abandonado
Vêm via integração com plugins de terceiros. Dependem do plugin estar ativo:
- CartFlows Cart Abandonment (gratuito) — disparos baseados nos templates de e-mail do plugin
- AutomateWoo — workflows visuais com nó de WhatsApp
Veja Carrinho abandonado (CartFlows).
Gatilhos de assinatura, licença e boleto
Aparecem na lista quando os plugins correspondentes estão ativos:
- SumoSubscriptions — primeira renovação, renovação, pausa, cancelamento
- License Manager for WooCommerce / Freemius License Manager — licença gerada/enviada
- WC Boleto Reminder — lembretes automáticos de boleto
Veja Outras integrações.
Gatilhos customizados
Se você (ou seu dev) precisa disparar mensagens em eventos próprios — um plugin custom da sua loja, um webhook externo, uma action específica — dá pra registrar gatilhos novos via filtros do plugin.
Veja Customização via código.
Próximos passos
- Variáveis de mensagem — placeholders disponíveis em cada gatilho
- Filtros: gateway, categoria, status, delay — refinar quando o gatilho dispara
- Anatomia de uma mensagem — o formulário em si