Lojas Shopify e Nuvemshop

Para lojas Shopify e Nuvemshop, você não monta webhook nem chama endpoint da owiew. Você autoriza a owiew na própria loja, e a loja passa a avisar a owiew de cada pedido. Os pedidos viram eventos que alimentam a conciliação, o funil e as regras de conversões.

O que você precisa

• Ser administrador do projeto na owiew. Só administradores conectam lojas.
• Ser dono ou administrador da loja, para autorizar o aplicativo.
• A conexão da plataforma ativada para a sua empresa. Se a tela avisar que a integração ainda não foi configurada, fale com o suporte da owiew.

Conectar a loja

Shopify

1. Na tela de integrações do projeto, abra Conectar loja Shopify.
2. Informe o Endereço da loja na Shopify, no formato minha-loja.myshopify.com. Você pode colar o endereço inteiro do painel da Shopify.
3. Clique em Conectar loja Shopify e autorize a owiew na Shopify.
4. Ao voltar, a tela confirma que a loja foi conectada. Os pedidos começam a chegar em instantes.

O acesso é de leitura de pedidos. Nada na loja é alterado e você pode remover o acesso pela própria Shopify. Há também a opção avançada Conectar com token, para quem prefere um aplicativo personalizado.

Nuvemshop

1. Na tela de integrações do projeto, abra Conectar loja Nuvemshop.
2. Clique em Conectar loja Nuvemshop e autorize a owiew na Nuvemshop.
3. Ao voltar, a tela confirma que a loja foi conectada.

A Nuvemshop só aceita a conexão pela autorização na própria plataforma. Isso comprova que a loja é sua.

Uma loja só pode estar conectada a um cliente da owiew por vez. Se ela já estiver em outro, desconecte-a lá antes.

O que a owiew recebe

Na conexão, a owiew registra na loja os avisos de pedido:

• Shopify: criação, atualização, pagamento, cancelamento e atendimento de pedido, e desinstalação do aplicativo.
• Nuvemshop: order/created, paid, updated, cancelled e fulfilled, e desinstalação do aplicativo.

Esses avisos chegam assinados pela plataforma da loja. A owiew confere a assinatura de cada um. Eles não são endpoints para você chamar.

A owiew também trata os pedidos de privacidade da plataforma (dados de cliente e remoção de cliente ou de loja), conforme a LGPD.

Eventos gerados

Cada pedido gera eventos normalizados. Eles são o que as regras de conversões usam como gatilho.

Evento	Quando
pedido.criado	Na primeira vez que o pedido é visto, em qualquer estado.
pedido.pago	Quando o pedido entra no estado pago.
pedido.cancelado	Quando o pedido entra no estado cancelado.
pedido.reembolsado	Quando o pedido entra no estado reembolsado (reembolso integral).
negocio.estado	Para CRMs: quando um negócio nasce ou muda de estado. Gera negocio.qualificado e negocio.ganho para as regras.

Um pedido visto pela primeira vez já pago gera pedido.criado e depois pedido.pago. Reembolso parcial, mudança de itens ou de valor sem mudança de estado, e estados como autorizado, recusado e expirado não geram evento.

Valores seguem em micros (R$ 1,00 é 1000000). Dados do cliente (e-mail, telefone, nome, CEP e id) existem só como hash SHA-256 e nunca em claro. O endereço IP e o navegador do comprador acompanham o evento para melhorar a correspondência nas plataformas de anúncio, mas não são guardados.

A ordem é garantida por pedido, não entre pedidos. A entrega é pelo menos uma vez, e as regras deduplicam.

Melhorar a atribuição

A owiew liga o pedido à campanha que o gerou por identificadores de clique. Na Shopify ela os lê de duas fontes, com a URL de chegada tendo precedência:

1. A URL de chegada do pedido: fbclid, gclid, wbraid, gbraid e ttclid presentes na query.
2. Os atributos do carrinho (note_attributes): _fbp, _fbc, fbclid, gclid, wbraid, gbraid, ttclid e client_id_ga (ou ga_client_id). Aplicativos de rastreio costumam gravá-los.

Se a sua loja já grava esses atributos no carrinho, nada mais é preciso. Se não grava, a atribuição depende da URL de chegada e fica mais fraca. Dos atributos do carrinho, a owiew guarda somente essas chaves e descarta o restante, como CPF ou campos livres de aplicativos de personalização.

Para o consentimento, a owiew lê da Shopify o estado de marketing do cliente (e-mail e SMS). Cliente inscrito com opt-in simples ou confirmado conta como consentimento; inscrição cancelada ou ausente conta como recusa; estados pendentes ficam sem informação. Quando não há sinal, o envio de dados da pessoa depende da base legal padrão da regra. Nuvemshop e CRMs não trazem sinal de consentimento confiável.

Teste ponta a ponta

1. Conecte a loja.
2. Crie um pedido de teste na loja e marque-o como pago.
3. No painel de conciliação, confirme que o pedido aparece.
4. Se há uma regra com gatilho pedido.pago, abra Conversões, aba Entregas, e procure a entrega. Com destino em modo teste ou envio real inativo, ela aparece como Gravada.

Se algo der errado

Sintoma	O que verificar
“Essa loja já está conectada a outro cliente”	A loja está em outro projeto ou empresa. Desconecte-a de lá.
“Esse não parece o endereço de uma loja Shopify”	Use o formato minha-loja.myshopify.com.
“Integração ainda não configurada”	A conexão não está ativada para a sua empresa. Fale com o suporte.
Pedido não aparece	A loja pode ter sido desinstalada ou a autorização revogada. Reconecte.
Pedido aparece sem campanha	O carrinho e a URL de chegada não trazem identificadores de clique.
Reembolso parcial não gerou evento	Esperado: só o reembolso integral gera pedido.reembolsado.

Próximos passos

• Destinos, regras e entregas de conversões
• Receber conversões por webhook
• Visão geral das integrações