[ajuda] conexões

Shopify do zero: app no Dev Dashboard, permissão só de leitura e vendas no AFK

No admin da Shopify, crie um app no Dev Dashboard com duas permissões só de leitura, read_orders e read_customers, lance a versão e instale na sua loja. Copie o Client ID e o Client secret do app. Cole no AFK, no cartão Shopify (loja online), junto com o endereço minhaempresa.myshopify.com. Depois diga ao AFK "importa as vendas da loja". O AFK só lê: não muda pedido, produto, estoque nem preço.

Isso faz parte do AFK, o Claude que você assina já configurado no seu computador. Conhecer o AFK

Para que serve no AFK

Pedido pago vira cliente no CRM. Entra com o nome, o e-mail ou telefone, o que comprou e o valor, na etapa "ganho". Cliente que já existe não é duplicado.
Pedido pago vira receita nas Finanças, com a descrição Pedido #1001 (Shopify). Aparece em Finanças → Vendas por canal, no canal Shopify.
Sem venda em dobro. Com o Mercado Pago ou o Stripe ligados no AFK, o pedido vira só cliente, porque a venda já entra pelo meio de pagamento. Veja a tabela abaixo.
Nada repete. O AFK guarda o número de cada pedido importado. Pode pedir de novo à vontade.

O que fica de fora: pedido não pago, pedido em outra moeda que não o real e pedido de valor zero. O AFK conta esses como pulados.

O que o AFK não faz: não mexe em produto, estoque, preço ou pedido. Não lê a loja sozinho em rotina: só quando você pede.

Quando a venda vira receita:

Sua situação	O que o AFK faz com o pedido
Sem Mercado Pago e sem Stripe no AFK	Cliente no CRM e receita nas Finanças
Mercado Pago ou Stripe ligados no AFK, e a loja recebe por eles	Só cliente no CRM. A receita já entra pelo meio de pagamento.
Mercado Pago ou Stripe ligados no AFK, mas a loja recebe por outro meio (Shopify Payments, outro gateway)	Só cliente, e a receita da loja não entra. Para corrigir, abra o `.env` da pasta do AFK no Bloco de Notas, acrescente a linha `LOJA_RECEITA=sim` e salve.

Antes: grátis ou pago

Item	Custo	O que saber
App no Dev Dashboard e API	Grátis	O app é só da sua loja. Não vai para a loja de apps da Shopify.
Plano da Shopify	O que você já paga	O AFK não muda nada no seu plano.

Riscos.

Com só leitura, o app não altera nada na loja. Quem tiver o Client secret consegue ler pedidos e clientes. Guarde como uma senha.
A permissão read_orders dá acesso aos pedidos dos últimos 60 dias. O AFK lê 30 dias por padrão, então isso basta.
Os dados dos seus clientes passam a morar também no seu computador, no CRM do AFK. Trate como trata a planilha de clientes.

Parte 1: conta e segurança

Entre na Shopify com a conta dona da loja. O app tem que ser criado na mesma organização da loja. Senão, o acesso não funciona.
Ligue a verificação em duas etapas na sua conta Shopify, na área de segurança da conta. Prefira o aplicativo autenticador.
Anote o endereço .myshopify.com da loja. Ele aparece em Configurações → Domínios. É ele que o AFK usa, mesmo que a loja tenha domínio próprio.

Parte 2: criar o app no Dev Dashboard

O Dev Dashboard costuma aparecer em inglês. Os nomes abaixo estão como aparecem na tela.

No admin da Shopify, abra Configurações → Apps → Desenvolver apps e clique para criar o app no Dev Dashboard.
No Dev Dashboard, clique em Create app → Start from Dev Dashboard. Nome: AFK. Clique em Create.
Na página Versions do app, preencha:
- App URL: https://shopify.dev/apps/default-app-home. O app do AFK não abre dentro do admin.
- Scopes: read_orders,read_customers. Só esses dois. Nada de write_.
Clique em Release.
No card Installs, clique em Install app, escolha a sua loja e clique em Install.
Abra App settings e copie o Client ID e o Client secret.

Já tem um app criado no próprio admin? Ele fica na seção de apps personalizados legados e continua funcionando, mas a Shopify não deixa criar app novo desse tipo. O token dele começa com shpat_ e só aparece uma vez, na criação. Se você guardou esse token e o app tem read_orders e read_customers, pode usar. Senão, siga a Parte 2.

Parte 3: colar no AFK

No painel do AFK, abra Conexões e clique no cartão Shopify (loja online).
Em Endereço da loja (minhaloja.myshopify.com), cole só minhaempresa.myshopify.com. Sem https:// e sem barra no fim.
Cole em Client ID (app do Dev Dashboard) e em Client secret o que copiou na Parte 2. Se usa o app antigo, cole o token em Token shpat_ (apps antigos) e deixe os outros dois vazios.
Clique em Salvar conexão.
Este cartão não tem botão Testar. Para conferir, diga ao AFK "importa as vendas da loja". Ele responde quantos pedidos viraram cliente e receita.

Como o acesso funciona. Com Client ID e Client secret, o AFK pede à Shopify um acesso que vale 24 horas e renova sozinho. Esse acesso fica em meu-negocio/credenciais/lojas.json, fora do git e da sincronização. O Client ID e o Client secret ficam só no .env da pasta do AFK. Nunca cole nenhum deles no chat, no WhatsApp ou em print.

No dia a dia

Você quer	Como
Trazer os pedidos da loja	Diga "importa as vendas da loja". O AFK lê os últimos 30 dias.
Trazer um período maior	Diga "importa as vendas da loja dos últimos 60 dias". Até 60 dias, a permissão de leitura basta.
Ver as vendas da loja	Finanças → Vendas por canal → Shopify.
Ver quem comprou	No CRM, os compradores aparecem na etapa "ganho", com origem `loja (Shopify)`.
Lançar a receita mesmo com Mercado Pago ou Stripe ligados	Acrescente `LOJA_RECEITA=sim` no `.env` (veja a tabela no início).
Trocar o Client secret	No Dev Dashboard, em App settings, gere outro. Cole por cima no mesmo cartão e clique em Salvar conexão.
Desligar a conexão	No cartão, clique em Desconectar e confirme. Para cortar o acesso na Shopify também, desinstale o app na loja.

Se o Client secret vazar (print, mensagem, arquivo enviado): gere outro no Dev Dashboard e cole no AFK. Se não conseguir trocar na hora, desinstale o app da loja: o acesso para na hora.

Erros e soluções

O que aparece	O que fazer
`Endereço da loja (minhaloja.myshopify.com): obrigatório.`	Preencha o endereço `.myshopify.com` (Parte 1, passo 3).
O AFK importa, mas a Shopify não aparece no resultado	Falta o token ou o Client ID. Com só o endereço, o AFK pula a Shopify. Faça a Parte 3.
`shopify: 'SHOPIFY_CLIENT_SECRET'`	Falta o Client secret. Cole no cartão e salve.
`shopify: 400: ...` ou `shopify: 401: ...`	Client ID ou Client secret errados, app não instalado na loja, ou app de outra organização. Confira a Parte 2, passos 5 e 6.
`Access denied for orders field. Required access: read_orders access scope.`	O app não tem `read_orders`. Crie uma versão nova com o escopo, clique em Release e aprove a mudança na loja.
`This app is not approved to access the Customer object`	A Shopify não liberou nome, e-mail ou telefone do cliente para o app. Confira `read_customers` e, no Dev Dashboard, se o app pede acesso aos dados protegidos de clientes.
`<urlopen error [Errno 11001] getaddrinfo failed>`	O endereço da loja está errado. Use só `minhaempresa.myshopify.com`.
A receita da loja não entrou	O Mercado Pago ou o Stripe estão ligados no AFK. Veja a tabela no início.
O pedido entrou como cliente, mas sem telefone	O comprador não deixou telefone na Shopify. O AFK usa o e-mail no lugar.

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande o Client secret nem o token.

Fontes oficiais (conferido em 30/10/2026): shopify.dev/docs/apps/build/authentication-authorization/access-tokens/client-credentials-grant (só funciona com app e loja da mesma organização; acesso de 24 horas; Client ID e Client secret em Settings do app; escopo novo exige versão nova aprovada na loja) · shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard (Create app → Start from Dev Dashboard; App URL padrão https://shopify.dev/apps/default-app-home; Scopes; Release; Install app; App settings) · changelog.shopify.com/posts/legacy-custom-apps-can-t-be-created-after-january-1-2026 (app personalizado novo não se cria mais no admin; os antigos continuam funcionando) · shopify.dev/docs/apps/build/authentication-authorization/legacy/admin-custom-apps (token do app criado no admin aparece uma vez só) · shopify.dev/docs/apps/launch/protected-customer-data (nome, e-mail, telefone e endereço são dados protegidos; sem liberação, o campo volta vazio com This app is not approved to access the Customer object) · help.shopify.com/en/manual/apps/install-setup-apps (no admin: Configurações → Apps → Desenvolver apps → criar no Dev Dashboard) · shopify.dev/docs/api/admin-graphql/latest/objects/Order (por padrão, só os pedidos dos últimos 60 dias; mais antigo exige read_all_orders).

trilha Receber e controlar as vendas · passo 4 de 5

próximoMandar proposta, orçamento ou página por link (e usar o seu domínio)

ainda não tem o AFK?

Com a Shopify ligada, cada pedido pago da loja vira cliente no CRM do AFK e, quando a loja não recebe pelo Mercado Pago ou pelo Stripe, vira receita nas Finanças.

O AFK deixa o Claude que você assina configurado e atualizado no seu computador: painel do negócio, conteúdo, documentos, travas e antivírus prontos. Você fala, o sistema opera. 7 dias de garantia.

Conhecer o AFK

Chaves e conexões

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.