As mensagens vivem no painel da Rishi e o plugin no WordPress guarda apenas uma cópia local sincronizada. Existem dois botões na tela WooCommerce → WhatsApp → Configurações que cuidam dessa sincronização — e a confusão entre eles é o motivo mais comum de "mensagem que não aparece".
Sincronizar vs Reconectar — diferença prática
| Botão | O que faz | Quando usar |
|---|---|---|
| Sincronizar | Busca mensagens da Rishi e popula a tabela local. Não toca no registro do site. | Você criou ou editou mensagem na Rishi e quer ver atualizada na loja agora (sem esperar o auto-sync da próxima vez que abrir a tela). |
| Reconectar | Refaz o registro do site na Rishi: re-envia URL da loja + URL da REST API + recebe novo sync_token. Não puxa mensagens sozinho. |
Você trocou domínio, mudou estrutura de permalinks da REST API, ou o badge ficou desconectado por motivo de auth. |
Se você precisa "fazer dar certo de novo", a sequência segura é: clique em Reconectar primeiro, e depois em Sincronizar. Reconectar consertou a confiança; Sincronizar buscou o conteúdo.
Auto-sync ao abrir a página
Toda vez que você abre WooCommerce → WhatsApp → Configurações, o plugin dispara um Sincronizar automático em background. Você vê o spinner aparecer perto dos botões por uns segundos e depois a mensagem de resultado.
Isso significa que, em uso normal, você raramente precisa clicar em Sincronizar manualmente. O caso típico em que precisa é: você editou na Rishi numa outra aba e quer ver atualizado sem fechar e reabrir a tela do WordPress.
O que muda na tabela local quando você Sincroniza
O plugin compara as mensagens que vieram da Rishi com as que tem localmente, e:
- Mensagem nova na Rishi → cria a entrada local.
- Mensagem existente em ambos → atualiza a local com os dados da Rishi (incluindo gatilho, status, filtros, URL do webhook).
- Mensagem que só existe localmente → fica como está (não é removida automaticamente).
A última regra é importante: a Rishi não consegue remover mensagens da sua loja com base no sync. Se você quer remover uma mensagem antiga, faça pelo painel da Rishi (que dispara remoção via REST API) ou direto na lista do plugin.
O resultado do Sync aparece como mensagem do tipo:
Sincronizado! 12 mensagens (2 criadas, 10 atualizadas, 0 removidas).
Problemas comuns
Criei mensagem na Rishi e não aparece na loja
Em ordem de checagem:
- Clica em Sincronizar manualmente — pode ser timing de cache do painel.
- Verifica se o badge tá "Conectado" — se vermelho, vai pra próxima.
- Clica em Reconectar — o
sync_tokenpode estar inválido. - Verifica se sua loja está acessível externamente — se a Rishi não consegue chamar
/wp-json/automation-for-whatsapp/v1/, mensagens criadas na Rishi nunca chegam. Veja Conectando o plugin ao Rishi via token pra detalhes.
Erro "Token inválido ou expirado"
O badge fica desconectado e a mensagem de erro aparece embaixo dos botões. Vá em app.rishi.com.br/meta-api, gere um token novo, atualize em WooCommerce → WhatsApp → Configurações e clique em Reconectar.
"Erro de rede" ao clicar nos botões
Geralmente é problema do servidor da loja, não da Rishi:
- Firewall bloqueando saída pra
app.rishi.com.br. - Plugin de segurança bloqueando o AJAX do WordPress.
- Site fora do ar momentaneamente.
Verifique os logs do WooCommerce em WooCommerce → Status → Logs na fonte whatsapp-rishi-auto.
Mensagem antiga ficou "fantasma" na lista
Mensagens que existiam quando você tinha modo QR Code mas foram desativadas na Rishi continuam aparecendo localmente, porque o sync não remove. Se quer limpar, edite a mensagem na lista local e mude o status pra Inativa, ou remova direto.
Próximos passos
- Variáveis enviadas no webhook — entender o payload que o plugin manda pra Rishi quando uma mensagem dispara.
- Como funciona o plugin no modo API Oficial — visão geral do fluxo.