Rishidocs

Sites: conectando sua loja ao Rishi CRM

4 min de leituraAtualizado há 4 dias

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

  1. 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
  2. Clique em Criar Site. O status fica como Pendente.
  3. 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.
  4. Aprove a conexão dentro do admin do WordPress. O WooCommerce devolve as credenciais (consumer key/secret) automaticamente para o Rishi.
  5. 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:

  1. Abra a aba Status no detalhe do site.
  2. Na seção Webhook, copie a URL de entrega e o Secret.
  3. Selecione os tópicos: Pedido criado, Pedido atualizado (ou ambos).
  4. 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):

  1. Copie a URL exibida.
  2. 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

Foi útil?