Rishidocs

Criando mensagens automáticas em eventos do WooCommerce

5 min de leituraAtualizado há 1 semana

Com o plugin já conectado, o trabalho do dia a dia é decidir qual evento da loja dispara qual mensagem. Tudo isso é feito no Rishi — você não precisa voltar no WordPress pra mexer em nada (a menos que mude o token).

Cada mensagem é a ligação entre um evento do WooCommerce (chamamos de "gatilho") e um template aprovado da Meta. Quando o evento acontece, o plugin avisa o Rishi e o Rishi dispara o template pro número do cliente, com as variáveis preenchidas automaticamente.

Onde criar uma mensagem

  1. No Rishi, abra a sua conexão Meta e vá na aba WooCommerce.
  2. Clique em Nova mensagem (canto superior direito) — ou em Criar primeira mensagem se for a primeira.

Você cai numa tela com três blocos principais: gatilho, template e variáveis.

Escolhendo o gatilho

O campo Gatilho é uma lista de eventos que o plugin escuta no WooCommerce. Os mais usados:

Pedidos

  • Pedido novo — disparado assim que um pedido é registrado, antes mesmo de pagamento.
  • Pedido aguardando pagamento — quando um pedido fica em "aguardando" (pix gerado, boleto emitido).
  • Pedido em processamento — quando o pagamento é confirmado e o pedido vai pra fila de envio.
  • Pedido concluído — quando você marca como concluído no painel.
  • Status do pedido alterado — qualquer mudança de status (mais genérico, dá pra refinar com filtros).

Estoque

  • Estoque baixo — pra avisar você (ou um cliente VIP) que um produto está acabando.
  • Sem estoque — quando um produto chega a zero.

Cliente

  • Recuperação de senha — substitui o email padrão do WooCommerce por uma mensagem WhatsApp.

Rastreio

  • Hooks específicos pra plugins de rastreio (Correios, Mandaê e outros). Quando o código de rastreio é gerado, dispara mensagem com o link.

A lista completa fica visível no próprio campo — clique pra abrir e veja tudo que está disponível pra você.

Se a sua loja tem um plugin que dispara um hook customizado (CartFlows, Sumo Subscriptions, etc), ele aparece aqui também. O plugin Automações para WhatsApp já mapeia dezenas de integrações comuns.

Filtros do gatilho (parâmetros opcionais)

Em Parâmetros do gatilho (acordeão clicável abaixo do campo de gatilho) você refina quando a mensagem dispara. Útil pra evitar mandar a mesma mensagem em todos os casos.

  • Gateway de pagamento — restringe a um ou mais gateways. Exemplo: pix,boleto faz a mensagem disparar só pra esses meios. Bom pra mandar instruções específicas de Pix sem confundir clientes que pagaram com cartão.
  • Delay em segundos — adiciona um atraso antes do envio. Exemplo: 60 espera 1 minuto. Útil pra dar tempo do email do WooCommerce chegar antes da sua mensagem.
  • Categorias permitidas — só dispara se o pedido contém produtos das categorias listadas (IDs separados por vírgula).
  • Categorias bloqueadas — não dispara se o pedido contém produtos dessas categorias. Exemplo: você não quer mandar mensagem de pós-venda pra quem comprou só serviço de assinatura.

Os IDs de categoria você pega no painel do WooCommerce em Produtos → Categorias. Cada categoria tem um número visível na URL ao editar.

Se nenhum filtro é preenchido, a mensagem dispara em todos os casos do gatilho escolhido.

Escolhendo o template

Em Template, você seleciona um dos modelos aprovados pela Meta na sua conexão. Só aparecem templates com status Aprovado — se você acabou de criar um e ainda está pendente, ele não vai estar disponível aqui ainda.

Se você ainda não tem um template adequado pra esse caso, crie um agora — vale o tempo de aprendizado.

Ao escolher o template, o Rishi mostra abaixo:

  • O conteúdo do template com as variáveis em destaque.
  • Um editor de variáveis onde você liga cada variável ({{1}}, {{2}}...) a um caminho do gatilho.

Mapeando variáveis

Cada placeholder do template ({{1}}, {{2}}...) precisa ser preenchido com um valor que vem do contexto do pedido. Você faz isso por dot notation: order.total, customer.first_name, order.shipping.address.

Exemplo: um template "Olá {{1}}, seu pedido #{{2}} foi confirmado!" — você liga {{1}} em customer.first_name e {{2}} em order.id.

A boa notícia: o Rishi sugere o mapeamento automaticamente com IA. Quando você escolhe o template, ele lê o texto e propõe qual variável liga em qual caminho. Você só revisa e ajusta o que ficou estranho.

Quais variáveis estão disponíveis em cada gatilho? Veja Quais variáveis usar em cada tipo de gatilho — tem uma referência por tipo de evento.

Salvar e ativar

Quando terminar:

  1. Clique em Criar mensagem.
  2. A mensagem aparece na lista da aba WooCommerce com um interruptor de status (verde = ativa, cinza = pausada).
  3. Use o interruptor pra ativar/pausar sem precisar deletar.

A partir desse momento, toda vez que o evento acontecer no seu WooCommerce, a mensagem é disparada automaticamente.

Editando ou removendo

  • Editar — clique no card da mensagem na lista. Você pode trocar o template, refazer o mapeamento de variáveis, mudar o gatilho ou ajustar filtros. As alterações são sincronizadas com o plugin no WordPress automaticamente.
  • Pausar/ativar — use o interruptor no card. Pausada não dispara, mas mantém toda a configuração.
  • Deletar — pelo menu da mensagem. Remove no Rishi e no plugin do WordPress.

Vendo o que disparou (logs)

Cada mensagem editável tem um histórico de execuções mostrando quando o gatilho disparou, qual payload chegou e se a mensagem foi enviada. Isso é o que você consulta pra entender por que uma mensagem específica não saiu — geralmente é variável faltando, número inválido, ou o template foi rejeitado.

Se um envio falhou, dá pra reprocessar ele a partir do log, sem precisar refazer nada.

Próximos passos

Foi útil?