Conectar Shopify · Central de Ajuda do Entagl

Visão geral

O proprietário cria um app Shopify e informa Client ID e Client secret uma vez na Entagl. A Entagl criptografa o secret e renova automaticamente o acesso de curta duração. Depois, a AI pode consultar pedidos recentes e estoque com as permissões aprovadas pelo lojista.

Recursos

Sem manutenção de token

A Entagl renova automaticamente o token de acesso do Shopify. O lojista mantém o controle e pode rotacionar o Client secret no Shopify a qualquer momento.

Suporte a pedidos e estoque

Com as permissões necessárias, a AI pode verificar clientes e consultar pedidos recentes, rastreamento e estoque na loja que eles usaram.

Tarefas comuns

Crie um app Shopify

Cerca de 5 min

O proprietário abre https://dev.shopify.com/dashboard e seleciona Apps → Create app → Start from Dev Dashboard. Colaboradores não podem concluir esta etapa. O app e a loja de destino devem aparecer na mesma organização do Shopify.
Dê ao app o nome “Entagl Integration” e clique em Create.
Abra Versions → Create version. Use https://shopify.dev/apps/default-app-home como App URL e desative “Embed app in Shopify admin”.
Na seção Scopes da versão, cole a linha completa de escopos e salve: read_products,read_customers,read_orders,write_orders,read_draft_orders,write_draft_orders,read_inventory
Clique em Release e confirme Release. Aguarde até o status da versão ficar Active.
Na página Home do app, clique em Install app, escolha uma loja, revise as permissões e instale. Repita para cada loja que você quiser conectar.
Abra Settings. Em Credentials, copie o Client ID e revele o Secret. Cole o secret diretamente no Entagl.
No Entagl, abra Channels → Shopify. Conecte uma loja com o domínio, o Client ID e o secret. Clique em Connect another store para adicionar a próxima loja.

Rotacionar um Client secret

Cerca de 2 min

Abra Settings do app no Shopify Dev Dashboard e clique em Rotate ao lado do Client secret.
Confirme a rotação e copie o novo secret. Considere o antigo revogado.
Na Entagl, abra Canais → Shopify e informe o mesmo domínio e Client ID com o novo secret.
Clique em Conectar e confirme que nenhum aviso permanece.

Dicas

O proprietário deve concluir as etapas do Dev Dashboard. Contas de colaborador não podem concluir esta configuração. O app e a loja de destino devem aparecer na mesma organização do Shopify.

Apps criados pelo merchant não têm as etapas de dados do cliente no Partner Dashboard mostradas em guias antigos. Se o Shopify bloquear o acesso aos pedidos, verifique os scopes do app e o plano da sua loja.

A consulta padrão de pedidos Shopify cobre os últimos 60 dias. Pedidos mais antigos precisam de atendimento humano.