Para conectar sua loja quando o app oficial da Briza ainda não está disponível, você cria um app na sua própria conta Shopify e informa as credenciais dele na Briza. Este artigo é para marcas. Ao final, a Briza cria cupons e atribui pedidos aos creators igual à conexão comum.
Antes de começar: você precisa ser admin da organização na Briza e administrador da loja Shopify. O app precisa ser criado na mesma conta Shopify que é dona da loja, senão a Shopify recusa a conexão.
Criar o app na Shopify
No admin da sua loja, abra Configurações e vá em Apps, Desenvolver apps.
Clique em criar app. A Shopify abre o Dev Dashboard, que é onde os apps são configurados hoje. Dê o nome que preferir, por exemplo `Briza`.
Preencha os campos da versão do app conforme a tabela abaixo.
Clique em Lançar para publicar a versão.
Abra Instalações e instale o app na sua loja. Esse passo é separado de criar e lançar: sem ele, a conexão na Briza falha dizendo que o app não está instalado.
Campos do app
| Campo | O que preencher | | --- | --- | | Nome do app | O que você preferir, por exemplo `Briza`. É o nome que aparece no admin da sua loja. | | Incorporar app no admin da Shopify | Deixe desmarcado. A Briza não roda dentro do admin da Shopify. | | Versão da API de webhooks | `2026-07` | | Escopos | `read_orders,read_discounts,write_discounts` | | Escopos opcionais | Deixe vazio. | | Usar fluxo de instalação legado | Deixe desmarcado. | | POS | Não precisa mexer. | | Proxy do app | Só para link de afiliado. Ver a seção abaixo. |
Os campos de URL que aparecem nessa tela não são usados por esta conexão, então pode deixar como vierem.
Sobre os escopos, informe exatamente esses três, separados por vírgula. Eles são o mínimo necessário: ler pedidos para atribuir as vendas, e criar cupons para os creators. Não adicione outros por precaução, porque cada escopo extra é um acesso à sua loja que a Briza não usa, e mudar a lista depois obriga a lançar uma versão nova e reinstalar o app.
Você não precisa cadastrar webhooks nessa tela. A Briza registra os dela automaticamente depois que a loja for conectada.
Proxy do app, para link de afiliado
O rastreamento por cupom funciona sem essa configuração. Preencha esta seção só se você também quiser o link de afiliado, aquele que o creator publica e que leva direto para a sua loja.
Na seção Proxy do app, informe:
| Campo | Valor | | --- | --- | | Prefixo do subcaminho | `apps` | | Subcaminho | `briza` | | URL do proxy | `https://api.heybriza.com/track/click` |
Com isso, os links dos creators ficam no formato `https://sualoja.com.br/apps/briza/CODIGO`, no seu próprio domínio. Se você deixar essa seção vazia, esses links retornam página não encontrada.
Conectar na Briza
No Dev Dashboard, abra Configurações do app e copie, na seção Credenciais, o ID do cliente e a chave secreta.
Na Briza, abra Configurações, Integrações, aba E-commerce.
Preencha o Domínio da loja com o endereço interno da Shopify, no formato `sualoja.myshopify.com`. Ele não é o domínio do seu site: você encontra esse valor no admin da Shopify, em Configurações, Domínios.
Cole o ID do cliente e a chave secreta.
Defina o Prefixo de cupom, por exemplo `BRIZA`. Os cupons dos creators vão sair no formato `PREFIXO-X7K2M9`.
Marque o aceite dos termos e conclua. A loja aparece como conectada.
Você não precisa gerar nenhum token: a Briza gera e renova sozinha os tokens de acesso a partir dessas duas credenciais.
O que muda nesse modo
O rastreamento por cupom funciona normalmente, e é por ele que as vendas são atribuídas aos creators.
O link de afiliado depende do Proxy do app estar configurado, conforme a seção acima. Sem ele, os links dos creators não abrem. A Briza não tem como saber se você configurou o proxy, então ela avisa na tela de integrações que o link pode não funcionar: se você configurou, pode ignorar esse aviso.
O rastreamento de cliques no tema, que na conexão comum é ativado pelo Theme Customizer, não existe nessa modalidade. Ele depende de um componente que só o app oficial da Briza instala. Na prática, isso significa que a atribuição do link acontece pela página de entrada da visita, e não sobrevive se a pessoa voltar à loja dias depois por outro caminho. A atribuição por cupom não é afetada.
Se a conexão falhar
A Briza mostra o motivo exato devolvido pela Shopify. Os mais comuns:
App não instalado na loja: você criou e lançou o app, mas pulou a instalação. Volte em Instalações no Dev Dashboard.
Credenciais não conferem: copie de novo o ID do cliente e a chave secreta. São dois valores diferentes, na mesma tela.
Domínio recusado: confira se você usou o `.myshopify.com`, e não o domínio do seu site.
Se você alterar os escopos depois de instalar, lance uma versão nova e reinstale o app, senão a loja continua concedendo os escopos antigos.
Perguntas relacionadas
Como crio um app na Shopify para conectar na Briza?
Onde encontro o ID do cliente e a chave secreta da minha loja?
Por que a Briza diz que meu app não está instalado?
Artigos relacionados: Integração com Shopify · Sincronização de vendas · Problemas de sincronização