A conexão entre o plugin e o Rishi é feita por um token único que você copia do painel da Rishi e cola nas configurações do WordPress. É o passo obrigatório — sem ele, nenhuma mensagem é enviada e nenhuma mensagem aparece na lista local.
Passo a passo
1. Pegar o token na Rishi
Acesse app.rishi.com.br/meta-api e clique no menu WooCommerce. Você verá um botão pra gerar o token.
O token tem o formato de uma string longa (Bearer token) — copie inteiro.
O token concede acesso de escrita à sua loja (criar/atualizar mensagens via REST API). Trate ele como senha: não compartilhe em e-mail, screenshot público nem repositórios. Se vazar, gere um novo na Rishi (o antigo passa a ser inválido na hora).
2. Colar no plugin
No WordPress, abra WooCommerce → WhatsApp → Configurações. No campo Token da API, cole o token e clique em Salvar alterações.
Assim que você salva, o plugin tenta se conectar à Rishi automaticamente. Você não precisa fazer mais nada além disso.
3. Confirmar a conexão
Logo abaixo do campo de token, o plugin mostra um badge com o estado da conexão:
- 🟢 Conectado — registro feito, sync_token recebido, tudo OK.
- 🔴 Desconectado — token inválido, expirado, ou a Rishi não respondeu.
Ao lado, ficam três coisas:
- Botão Sincronizar — busca a lista de mensagens da Rishi e popula localmente. Roda automaticamente toda vez que a página é aberta.
- Botão Reconectar — refaz o registro do site na Rishi (útil se você trocou de URL, por exemplo).
- Mensagem de resultado abaixo dos botões — confirma o que aconteceu na última operação.
O que o plugin faz internamente quando você salva o token
Pra você saber o que esperar:
- Faz
POSTemapp.rishi.com.br/api/v2/wordpress/registercom sua URL e a URL da REST API local. - A Rishi devolve um
sync_tokenque é guardado emwp_options(chaveafw_rishi_auto_sync_token). - Esse
sync_tokenautentica as chamadas que a Rishi faz de volta pra sua loja (pra criar/atualizar mensagens).
Se algo der errado nesse fluxo, o badge fica vermelho e o resultado aparece no painel — você não precisa olhar log pra entender.
Problemas comuns
Badge "Desconectado" logo após salvar o token
Três causas mais frequentes:
Token errado — copiou parcial, ou copiou outro token (de outro produto da Rishi). Volte em app.rishi.com.br/meta-api, copie de novo, e cole.
Token expirado/revogado — você gerou novo na Rishi e o antigo deixou de valer. Volte lá, gere outro e atualize aqui.
A Rishi não conseguiu acessar sua loja — durante o registro, a Rishi testa se consegue chamar /wp-json/automation-for-whatsapp/v1/ da sua loja. Se essa URL estiver bloqueada por firewall, autenticada com plugin de segurança, ou com manutenção habilitada, o registro falha. Verifique se a URL responde publicamente (pode testar no navegador — você deve ver um JSON, mesmo que com erro de auth).
Mensagens criadas na Rishi não aparecem na loja
Clique em Sincronizar manualmente. Se persistir, é provável que o sync_token esteja inválido — clique em Reconectar pra refazer o registro.
Troquei de domínio (staging → produção) e parou
A URL da loja é parte do registro. Quando você muda o domínio, o sync_token antigo continua válido mas aponta pro domínio antigo. Clique em Reconectar com o token atual — o plugin re-registra com a URL nova.
Em ambientes de staging, configure o filtro PHP afw_rishi_auto_api_base_url pra apontar pra outra instância da Rishi (se existir). Senão, use um token diferente em cada ambiente — assim staging não conflita com produção. Veja Configurações avançadas para devs (em breve).
Próximos passos
- Sincronização: por que e quando usar — entenda quando rodar Sincronizar vs Reconectar.
- Como funciona o plugin no modo API Oficial — visão geral, caso você tenha caído direto aqui.