Visão geral das integrações
Esta seção descreve as formas de levar dados dos seus sistemas para a owiew. Cada integração tem uma página própria com pré-requisitos, autenticação, endpoints, exemplos curl, erros, teste ponta a ponta e problemas comuns.
Aqui entra só o que existe e é acessível a quem integra. Para ler dados da owiew, veja a API de leitura. O que ainda não existe aparece marcado como planejado.
Qual integração usar
Seção intitulada “Qual integração usar”| Você quer | Use | Como o dado entra | Página |
|---|---|---|---|
| Medir visitas, cliques, formulários e desempenho do seu site | Pixel de primeira parte | Tag no site (script) ou Google Tag Manager |
Instalar o pixel |
| Mandar um evento do seu servidor, ou de um tag manager próprio, sem a tag | Endpoint de coleta do pixel | POST JSON em /e, na sua própria zona de coleta |
Enviar eventos direto |
| Respeitar a decisão de consentimento do visitante | Consentimento no pixel | Variável window.__vwConsent antes da tag |
Consentimento e identificação |
| Avisar Meta, Google Analytics 4 ou TikTok de uma venda ou lead que aconteceu fora do site (CRM, planilha, ERP, telefone) | Conversões por webhook | POST assinado para um endereço de recepção da owiew |
Receber conversões |
| Escolher para onde as conversões vão e conferir se chegaram | Destinos e entregas | Telas de Conversões do painel | Destinos e entregas |
| Trazer pedidos da Shopify ou da Nuvemshop | Eventos de comércio | Conexão da loja pelo painel (OAuth); pedidos chegam por webhook da própria loja | Lojas Shopify e Nuvemshop |
| Receber leads de formulário nativo de anúncio | Recepção de leads | Meta pela conexão no painel; Google Ads por endereço e chave | Receber leads |
Como escolher entre pixel e conversões
Seção intitulada “Como escolher entre pixel e conversões”O pixel mede o que acontece no navegador do visitante. Ele não enxerga uma venda fechada por telefone, um negócio ganho no CRM ou um pedido pago depois que o cliente saiu do site.
As conversões por webhook cobrem esse caso: o seu sistema avisa a owiew quando o fato acontece, e a owiew decide se avisa as plataformas de anúncio. Para lojas Shopify e Nuvemshop, você não precisa montar o webhook: a conexão da loja já traz os pedidos.
Os dois podem convivir. O pixel alimenta os relatórios de tráfego e comportamento. As conversões alimentam as plataformas de anúncio com o resultado real.
Autenticação de cada integração
Seção intitulada “Autenticação de cada integração”| Integração | Quem chama | Credencial |
|---|---|---|
| Pixel | O navegador do visitante, ou o seu servidor | Chave pública do stream (pk_...) e origem declarada. A chave é pública por desenho. |
| Conversões, fonte com assinatura | O seu sistema | HMAC-SHA256 do corpo com o segredo da fonte, no cabeçalho X-Owiew-Signature. |
| Conversões, fonte com segredo no caminho | O seu sistema, quando não consegue assinar | Segredo no final do endereço. Menos seguro. |
| Lojas | A Shopify ou a Nuvemshop | Assinatura do corpo feita pela plataforma. Você só autoriza a conexão no painel. |
| Leads | A Meta ou o Google Ads | Assinatura da Meta; chave do formulário do Google. Você só configura a conexão. |
Nenhuma dessas rotas usa a chave de API da API de leitura. Chave de API serve para ler; as rotas de recepção servem para escrever, e cada uma prova a origem do seu jeito.
O que não está disponível
Seção intitulada “O que não está disponível”- Webhooks de saída genéricos para o seu sistema. Hoje a owiew não emite um webhook configurável por URL para os leads ou para as conversões. Os leads seguem para CRMs conectados pelo painel (Asender, Kommo e RD Station). Webhooks assinados de eventos existem para aplicativos da loja de apps; veja a seção de aplicativos.
- Leitura de dados do pixel por API. Planejado. Para consultar o que o pixel coletou, use o painel.
- Gestão de conversões por API pública. As fontes, os destinos e as regras de conversões são configuradas no painel. As rotas de gestão exigem a sessão de uma pessoa do projeto e não aceitam chave de API.
- Login federado (OIDC) para sistemas de terceiros. Esta seção não o descreve porque não há cliente público documentado para terceiros.
- LinkedIn e TikTok em leads. Aparecem no painel como “Em breve”.
Antes de integrar em produção
Seção intitulada “Antes de integrar em produção”- Teste em ambiente que não dispare efeito real. As conversões nascem em modo de teste e, enquanto o envio real não está ativo, ficam só gravadas.
- Use dados inventados nos primeiros envios.
- Confirme o resultado no painel (tempo real do pixel, entregas das conversões, caixa de leads). É o único retorno confiável de algumas rotas, como explicado em cada página.