Voltar para documentação
Integrações

Integração Shopify

Conecte sua loja Shopify ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Visão geral

Ao integrar a Shopify, o Synchro Hub passa a:

  • Receber webhooks de pedidos, pagamentos, cancelamentos e reembolsos em tempo real (orders/create, orders/paid, orders/cancelled, refunds/create).
  • Consolidar cada pedido no dashboard com o valor correto, itens e status financeiro.

Boa notícia: a conexão é feita por autorização de 1 clique (OAuth). Você não precisa copiar nenhum token, API key ou secret — basta informar o endereço da sua loja e autorizar.

Tempo estimado: 5 minutos. O que você vai precisar:

  • Uma loja Shopify ativa, com acesso de administrador.
  • O endereço interno da sua loja no formato sua-loja.myshopify.com.
  • Workspace já criado no Synchro Hub.

Pré-requisitos

  • Estar logado no Synchro Hub com um workspace selecionado.
  • Ter acesso ao painel de administração da sua loja em admin.shopify.com.

Passo 1 — Conectar a plataforma no Synchro Hub

  1. No Beacon, acesse Configurações → Integrações → Fontes de Venda.
  2. Clique em + Adicionar Plataforma.
  3. Selecione Shopify e clique em Confirmar.

Passo 2 — Informar o endereço da loja

  1. No card da Shopify, clique em Atualizar credenciais.
  2. Informe o endereço da loja no formato sua-loja.myshopify.com.
  3. Clique em Salvar.

Importante: mesmo que a sua loja use um domínio próprio (ex.: acme.com), aqui você precisa usar o endereço interno sua-loja.myshopify.com. Ele aparece na barra de endereço do painel de administração da Shopify e é o único aceito nesta etapa.

Passo 3 — Autorizar o Synchro Hub na Shopify

  1. Ao salvar, você é redirecionado para o painel da Shopify.
  2. Revise as permissões solicitadas (leitura de pedidos) e clique em Instalar / Autorizar.
  3. A Shopify devolve você ao Beacon com a integração conectada. O card passa a exibir Ativa / Conectado.

Por que autorizar? É essa autorização que gera, com segurança, o acesso de leitura dos seus pedidos — sem que você precise manusear tokens. O acesso vale até você desinstalar o app da loja.

Passo 4 — Ativar o webhook (automático)

  1. No card da Shopify, clique em Configurar Webhook.
  2. Clique em Ativar Webhook.

O Synchro Hub registra automaticamente os eventos de pedido na Shopify — nenhuma configuração manual é necessária. Ao concluir, o card passa a exibir Webhook ativo.

Verificação

  1. Gere um pedido de teste na sua loja (uma compra real de valor baixo ou um pedido com desconto de 100%).
  2. Abra Vendas no menu lateral do Synchro Hub.
  3. A venda deve aparecer em até 1 minuto após o pagamento.

Limitações conhecidas

  • Somente a partir de agora: pedidos anteriores à conexão não são importados. Só valem os eventos recebidos a partir da ativação.
  • Rastreamento de campanhas (UTMs): os parâmetros de origem (utm_source, fbclid, gclid…) só são capturados quando chegam nos atributos do pedido (note_attributes). Origens que ficam apenas na URL da loja ainda não são lidas.
  • Moedas sem centavos: moedas sem casas decimais (ex.: iene japonês, JPY) estão fora do escopo atual. Se a sua loja opera nessas moedas, fale com o suporte antes de conectar.

Solução de problemas

SintomaO que fazer
”Endereço da loja inválido”Use o formato sua-loja.myshopify.com (endereço interno), não o seu domínio próprio. Confira se não há espaços nem https://.
A autorização não concluiVerifique se você está logado na Shopify com uma conta de administrador da loja e tente novamente. Contas sem permissão não conseguem instalar o app.
Nenhuma venda chega após o pagamentoConfirme no card se está Webhook ativo. Se não, clique em Configurar Webhook → Ativar Webhook.
Vendas antigas não aparecemEsperado — a integração é somente a partir da ativação (sem importação retroativa).

Perguntas frequentes

Tenho vários produtos na mesma loja. Preciso integrar cada um? Não. A integração é por loja. Todos os pedidos daquela loja passam a chegar pela mesma conexão.

Preciso copiar algum token ou API key da Shopify? Não. A conexão é por autorização (OAuth) — você só informa o endereço da loja e autoriza o app.

Posso reprocessar vendas antigas? Não automaticamente. A integração contabiliza vendas a partir da ativação.

Como desconecto a integração? No card da Shopify, clique em Remover. Para encerrar completamente o acesso, desinstale também o app do Synchro Hub no painel da Shopify (Configurações → Aplicativos e canais de vendas).