O plugin Automações para WhatsApp tem dois modos de operação: WhatsApp Rishi (QR Code) e WhatsApp API Oficial (Meta). Esse artigo cobre o modo API Oficial — que é o foco dessa categoria. Se você está conectando via QR Code, vai em WhatsApp Rishi.
A diferença mental que você precisa fazer
No modo QR Code, você cria e edita mensagens dentro do WordPress — em WooCommerce → WhatsApp. Cada mensagem fica gravada localmente, com seu texto, gatilho, filtros, agendamento.
No modo API Oficial é diferente: as mensagens vivem no painel da Rishi. O plugin no WordPress só serve como ponte de eventos — quando algo acontece na loja (pedido pago, carrinho abandonado, etc.), ele dispara um webhook pro Rishi, que envia a mensagem pelo template pré-aprovado pela Meta.
Isso significa que:
- Templates de mensagem são criados e aprovados no painel da Rishi (que conversa com a Meta).
- Quem dispara o que (qual gatilho aciona qual template) também é configurado lá.
- No WordPress, você não cria nem edita o texto da mensagem — só conecta a loja e deixa o plugin sincronizar.
Por que essa separação? A API Oficial da Meta exige que todo template de mensagem seja aprovado antes de ser usado. A aprovação leva minutos ou horas, e é feita por template (não por mensagem individual). O painel da Rishi é o lugar onde você cuida disso de forma centralizada — e o plugin no WP só executa.
Como o fluxo funciona, na prática
- Você instala o plugin no WordPress (mesmo plugin do modo QR Code).
- Pega o token em app.rishi.com.br/meta-api e cola em
WooCommerce → WhatsApp → Configurações. - O plugin se auto-registra na Rishi: avisa qual é a URL da loja e a URL da REST API local.
- A Rishi devolve um sync_token que autentica todas as chamadas seguintes entre os dois lados.
- Você cria mensagens no painel da Rishi — escolhe template, define o gatilho (pedido pago, novo lead, etc.), mapeia variáveis pros placeholders do template (
{{1}},{{2}}...). - A Rishi popula essas mensagens na sua loja via REST API (
/wp-json/automation-for-whatsapp/v1/messages). - Quando o gatilho dispara na loja, o plugin manda webhook pra Rishi com o payload completo do evento (variáveis + metadados do pedido).
- A Rishi mapeia as variáveis recebidas pros placeholders do template e dispara via API Oficial pra Meta.
O que muda na interface do plugin
Comparado ao modo QR Code, três abas ficam escondidas porque o conteúdo correspondente é gerenciado na Rishi:
| Aba | Modo QR Code | Modo API Oficial |
|---|---|---|
| Nova mensagem | ✅ visível | ❌ escondida |
| Teste de mensagem | ✅ visível | ❌ escondida |
| Agendamentos | ✅ visível | ❌ escondida |
| Configurações | ✅ visível | ✅ visível (token + status de conexão) |
| Mensagens (lista) | ✅ visível | ✅ visível (somente leitura — vem da Rishi) |
A lista de mensagens mostra o que veio da Rishi, mas você não cria nem edita ali — vai sempre pro painel da Rishi pra qualquer mudança.
O que cada lado guarda
| WordPress (plugin) | Painel Rishi | |
|---|---|---|
| Token de conexão | ✅ | ✅ |
| Templates Meta | — | ✅ |
| Lista de gatilhos disponíveis | ✅ (registra os hooks) | — |
| Mapeamento gatilho ↔ template | — | ✅ |
| Mapeamento variável ↔ placeholder | — | ✅ |
| Mensagem espelho (cópia local) | ✅ (sincronizada) | ✅ (fonte) |
| URL do webhook pra disparo | ✅ (em custom_settings) |
✅ |
| Histórico de envios | — | ✅ |
Quando esse modo faz sentido
Use API Oficial quando:
- Você quer volume alto sem risco de bloqueio do número.
- Você precisa mensagens transacionais (utility) com baixa taxa de conversão pra marketing.
- Sua loja já tem número verificado na Meta ou está disposta a fazer a verificação.
Se sua loja tem volume baixo (até algumas centenas de mensagens por mês) e quer custo zero, o modo QR Code resolve. A API Oficial cobra por mensagem enviada (utility/marketing/etc.), mas escala sem limite e é o caminho oficial.
Próximos passos
- Conectando o plugin ao Rishi via token — setup obrigatório.
- Sincronização: por que e quando usar — entender os botões Sincronizar e Reconectar.
- Variáveis enviadas no webhook — referência completa do payload que o plugin manda pra Rishi.