Sites: conectando sua loja ao Rishi CRM
Cada loja que você conecta ao Rishi vira um site no CRM. A partir dele, o Rishi sincroniza pedidos, clientes, cupons e carrinhos abandonados — e dispara automações, segmentos e campanhas.
Você pode conectar quantas lojas quiser na mesma conta. Cada site é independente: tem suas próprias credenciais, fluxos, segmentos, templates de e-mail e webhooks.
Provedores suportados
O Rishi conversa com quatro tipos de loja:
- WooCommerce — integração via plugin OAuth. É o caminho mais comum. Exige aprovar a conexão no admin do WordPress.
- Checkout Rishi — para clientes do produto Checkout Rishi. Conecta automaticamente, sem credenciais externas.
- Payee — integração interna via observers. Conecta automaticamente, sem configuração.
- API — recebe dados exclusivamente via webhook (
order-created,order-updated). Não tem sync ativo. Útil pra integrações customizadas ou plataformas sem plugin.
Conectando uma loja WooCommerce
- Em CRM → Sites → Criar novo site, preencha:
- Nome do Site — como você quer que apareça na lista
- URL completa — com
https://(ex:https://minhaloja.com.br) - Provedor — selecione WooCommerce
- Clique em Criar Site. O status fica como Pendente.
- Na próxima tela, clique no botão de conexão. Você é redirecionado para a tela de autorização OAuth do WooCommerce na sua loja.
- Aprove a conexão dentro do admin do WordPress. O WooCommerce devolve as credenciais (consumer key/secret) automaticamente para o Rishi.
- O status muda para Conectado e a primeira sincronização começa em background.
Checkout Rishi, Payee e API não passam pela etapa de conexão OAuth. Esses providers ficam com status Conectado no momento de criação.
Sincronização de pedidos
Toda vez que você clica em Sincronizar no painel do site, o Rishi busca pedidos da loja em lotes paginados.
A barra de progresso mostra:
- Página atual / total — quantas páginas já foram processadas
- Horário de início — quando começou
- Último erro — se algo deu errado (em vermelho)
A tela faz polling a cada 5 segundos enquanto a sincronização está ativa. Quando termina, a barra desaparece.
Sincronização travada? O sistema detecta paradas longas (10 minutos sem avançar de página) e dispara um restart automático. Se ainda assim não destravar, fale com o suporte.
Importação incremental
Depois da primeira sincronização completa, novos pedidos chegam por sincronização incremental — bem mais rápida. O Rishi guarda a data do último pedido importado e busca só o que veio depois.
Limitando o histórico
Lojas com histórico muito grande podem demorar pra sincronizar. Use o campo Importar pedidos a partir de nas configurações pra ignorar pedidos anteriores a uma data específica.
Webhooks: pedidos em tempo real
Pra receber pedidos no instante em que acontecem (sem depender da sincronização), configure os webhooks WooCommerce direto pelo painel:
- Abra a aba Status no detalhe do site.
- Na seção Webhook, copie a URL de entrega e o Secret.
- Selecione os tópicos: Pedido criado, Pedido atualizado (ou ambos).
- Clique em Criar webhooks.
O Rishi cria os webhooks via API REST do WooCommerce. Eles aparecem marcados em verde quando ativos.
Webhook de carrinho abandonado
Cada site tem uma URL assinada exclusiva pra receber eventos de carrinho abandonado. Encontre no modal Configurações (ícone de engrenagem):
- Copie a URL exibida.
- Cole no campo de webhook do plugin de carrinho abandonado da sua loja (ex: CartBounty).
Quando o plugin disparar um POST pra essa URL, o Rishi armazena o carrinho e dispara fluxos com gatilho Carrinho abandonado. Detalhes em Carrinhos abandonados.
E-mails
Cada site tem seu próprio servidor SMTP e visual de e-mail. Configure pelo modal E-mails:
- Servidor SMTP — host, porta, criptografia (TLS/SSL), usuário, senha
- Remetente — nome e e-mail que aparecem no campo "De:"
- Visual — logo (URL), cores de fundo/texto/borda do cabeçalho, alinhamento, altura máxima
A senha SMTP é criptografada no banco e nunca é reexibida — só pode ser atualizada.
Métricas no painel
O painel do site mostra os números dos últimos 30 dias:
| Métrica | O que conta |
|---|---|
| Pedidos Totais | Pedidos no período |
| Clientes no período | Clientes distintos com pedidos no período |
| Faturamento | Soma do total de pedidos pagos no período |
Logo abaixo, você vê os 3 fluxos e 3 segmentos mais recentes do site, e tabelas dos 5 últimos pedidos e 5 últimos clientes.
Excluindo um site
Você só consegue excluir um site quando todas as listas relacionadas estão vazias:
- Sem pedidos
- Sem clientes
- Sem fluxos de automação
- Sem segmentos / campanhas
O botão Excluir site fica desabilitado enquanto qualquer um desses contadores for maior que zero. Pra remover um site com dados, fale com o suporte.
Sites suspensos administrativamente (por violação de termos, por exemplo) ficam bloqueados e não podem ser reativados pela UI. Entre em contato pra resolver.
Próximos passos
- Crie segmentos pra agrupar seus clientes por comportamento.
- Monte fluxos no Flow Builder pra automatizar respostas a eventos.
- Conecte uma instância WhatsApp via QR Code pra começar a disparar mensagens automáticas.