Conectar a loja online · Shopify, WooCommerce e Magento
Guia da conexão entre o SellioCRM e a sua loja online. Você informa o endereço da loja e o segredo do webhook em Configurações, em Integrações, copia a URL gerada para dentro da plataforma e passa a receber clientes e pedidos automaticamente. O modelo é traga a sua loja: a conta é sua, sem custo nem intermediação nossa.
A conexão com a loja online não fica na tela Varejo: ela fica em Configurações, em Integrações, junto das demais integrações da conta. São três cartões, E-commerce (Shopify), E-commerce (WooCommerce) e E-commerce (Magento). O modelo é o mesmo nos três: a loja é sua, a credencial é sua, e nós não cobramos nem ficamos no meio da transação. A integração nasce inerte, ou seja, nada acontece até você configurar e ativar.
O que a conexão traz para dentro do CRM
Os clientes da loja viram Contatos e os pedidos viram Pedidos de venda. A cada evento, a loja avisa o CRM e o registro é criado ou atualizado. Duas garantias importam aqui. A primeira: reentrega não duplica, porque o registro é procurado pelo identificador da loja antes de qualquer criação, e o contato ainda cai para o e-mail como segunda chave. A segunda: só os campos preenchidos que vêm da loja são gravados, então o que a sua equipe editou no CRM não é apagado por uma atualização vinda de fora.
Conectar o Shopify
- Abra Configurações, vá em Integrações e localize o cartão E-commerce (Shopify).
- Preencha Domínio da loja com o endereço .myshopify.com, por exemplo minhaloja.myshopify.com.
- Preencha Webhook secret (API secret) com o segredo usado para assinar os webhooks, que fica no Shopify Admin, em Settings, Notifications, ou é o API secret da sua app.
- Se quiser que o CRM também leia dados da loja por API, preencha Admin API access token (opcional). Ele não é necessário para receber os webhooks.
- Clique em Salvar credenciais. A partir daí a tela mostra a URL do webhook (Shopify), com o botão Copiar.
- No Shopify Admin, em Settings, Notifications, Webhooks, crie um webhook para cada tópico apontando para essa URL, em formato JSON. Os tópicos são customers/create, customers/update, orders/create e orders/paid.
- De volta ao cartão, clique em Ativar. O selo passa a mostrar Conectado.
WooCommerce e Magento
- WooCommerce: preencha URL da loja e Webhook secret, salve, copie a URL do webhook (WooCommerce) e crie os webhooks em Settings, Advanced, Webhooks, usando o mesmo Secret. Os tópicos são Customer created, Customer updated, Order created e Order updated.
- Magento e Adobe Commerce: a plataforma não tem webhooks nativos padronizados, então você informa URL da loja e um Segredo de autenticação que você mesmo inventa, e configura um módulo ou integração que envie os clientes e pedidos para a URL do webhook (Magento), autenticando com esse segredo.
Segurança das credenciais
Todo segredo salvo fica cifrado e nunca é exibido de volta. Depois de salvar, a tela informa que as credenciais estão guardadas com segurança e que você só precisa preencher de novo para trocá-las: deixar o campo em branco mantém o que já está lá. Cada chamada recebida é verificada com o segredo da sua organização antes de qualquer gravação. Chamada com assinatura inválida é recusada, e endereço de integração desativada também. A URL do webhook é um ponto de entrega para máquinas: abri-la no navegador devolve uma explicação, e não uma página do sistema.
Como isso conversa com a tela Varejo
A conexão descrita acima alimenta os Contatos e os Pedidos de venda do CRM. A tela Varejo trabalha com uma camada própria de espelho, aquela em que cada linha mostra Origem e Lido em, e que é alimentada pela sincronização da vertical. Essa camada guarda a versão já vista de cada registro, de modo que aviso repetido ou fora de ordem não faz nada, e compara periodicamente a sua contagem com a da plataforma: quando falta registro, a diferença fica visível como divergência em vez de ficar em silêncio. É por isso que as duas coisas podem crescer em ritmos diferentes, e por isso a coluna Lido em existe.
Limites e perguntas comuns
- Configurar integração é ação de quem administra a conta.
- Desativar a integração para de receber eventos e não apaga o que já entrou. Remover a credencial exige informá-la de novo depois.
- Nada é enviado do CRM para a loja por esta conexão: o fluxo é de entrada.
- Se nada chega, confira nesta ordem: a integração está ativada, os webhooks apontam para a URL copiada, o segredo é o mesmo dos dois lados e os tópicos foram todos criados.
- A conexão com a loja é independente da vertical Varejo: você pode receber clientes e pedidos como Contatos e Pedidos de venda sem ativar a vertical, e ativar a vertical depois para ganhar as leituras de identidade, carrinho, devolução, avaliação e risco.