⏱️ Tempo de leitura: 4 minutos
Nível: ⭐⭐⭐⭐☆ (Intermediário-Avançado)
Este artigo aborda:
Escopo do suporte oferecido pela Loja Integrada
Configuração correta de credenciais na API
Principais erros na autenticação
Introdução
Com o avanço de ferramentas de automação baseadas em inteligência artificial como Make, N8N e Zapier, muitos lojistas buscam integrar suas lojas para criar fluxos automatizados de trabalho. Essas plataformas permitem conectar diferentes serviços e automatizar processos que vão desde o envio de pedidos até atualizações de estoque.
No entanto, é importante entender desde o início que a Loja Integrada não oferece suporte técnico para configuração ou troubleshooting dessas ferramentas externas. Este artigo existe para esclarecer nosso escopo de atendimento e fornecer informações básicas que podem ajudar você a começar por conta própria.
O que a Loja Integrada oferece (e o que não oferece)
Nosso suporte inclui
A equipe de suporte da Loja Integrada está preparada para ajudar você com:
Funcionamento da plataforma e seus recursos nativos
Integrações oficiais disponíveis no painel
Disponibilização das chaves de API e personal tokens no painel
Documentação oficial da API
O que não faz parte do nosso suporte
Por outro lado, não conseguimos auxiliar com:
Configuração de ferramentas externas como Make, N8N, Zapier ou similares
Desenvolvimento de fluxos de automação personalizados
Resolução de erros específicos dessas plataformas
Consultoria sobre qual ferramenta escolher ou como estruturar suas automações
💡 Importante: Ferramentas como Make, N8N e Zapier são plataformas independentes que exigem conhecimento técnico específico. Se você não tem familiaridade com APIs e automações, considere contratar um desenvolvedor ou consultor especializado.
Primeiro passo: gerar seu personal token e sua chave de API
Antes de configurar qualquer automação externa, você precisará de um personal token e de uma chave de API. Essas chaves vão permitir que as ferramentas externas possam se comunicar com sua loja através da API.
Essa combinação funciona como uma senha especial que autoriza sistemas externos a acessarem dados da sua loja de forma segura. Sem elas, não é possível estabelecer a conexão.
Acesse o artigo Como gerar chaves de API e o personal token (chave de aplicação) da minha loja? para mais detalhes.
Como enviar o personal token nas requisições
Esta é a parte que mais gera dúvida para quem está começando: a forma correta de passar a credencial no Header de autorização.
Como funciona a autenticação
Quando sua automação faz uma requisição para a API da Loja Integrada, ela precisa enviar o personal token no Header Authorization. O personal token autentica sozinho, então você não precisa informar Chave API nem chave de aplicação junto com ele.
Configuração correta
No Header Authorization, informe a palavra Basic seguida de um espaço e do seu personal token:
Authorization: Basic seu_personal_token
⚠️ Atenção: o formato com chave_api e aplicacao no mesmo Header é usado apenas por aplicativos de parceiros. Se sua automação foi configurada nesse formato, substitua pelo personal token.
💡 Dica: o personal token é exibido uma única vez, no momento em que você o gera. Copie e guarde em local seguro antes de fechar a tela, porque ele não fica disponível para consulta depois.
Exemplo prático
Em ferramentas como Make, N8N ou Zapier, ao configurar o módulo HTTP ou a conexão com a API, você precisará:
Localizar o campo de configuração de Headers
Adicionar o Header Authorization
Preencher o valor com
Basic, um espaço e o seu personal token
A estrutura exata pode variar conforme a ferramenta que você está usando. Consulte a documentação da API da Loja Integrada para detalhes técnicos sobre o formato esperado.
Próximos passos para quem está começando
Se você está determinado a criar suas próprias automações, aqui estão algumas orientações:
Estude a documentação oficial: A API da Loja Integrada possui documentação técnica que explica endpoints, parâmetros e formatos de resposta. Familiarize-se com ela antes de começar.
Comece simples: Teste primeiro uma requisição básica (como listar produtos) antes de criar automações complexas. Isso ajuda a validar se suas credenciais estão configuradas corretamente.
Use ambientes de teste: Tanto Make quanto N8N e Zapier permitem testar fluxos antes de ativá-los. Aproveite para identificar erros sem afetar processos reais da sua loja.
Considere ajuda especializada: Se você não tem experiência técnica com APIs, pode ser mais produtivo contratar um desenvolvedor ou consultor que já trabalhe com essas ferramentas. O investimento inicial pode economizar muitas horas de frustração.
Dúvidas frequentes
A Loja Integrada pode me ajudar a configurar o Make, N8N ou Zapier?
Não. Essas são ferramentas externas e nosso suporte não cobre sua configuração ou uso. Podemos apenas fornecer a chave de aplicação e indicar nossa documentação de API.
Posso usar a mesma chave para diferentes ferramentas de automação?
Sim. A chave de aplicação serve para qualquer integração externa que precise acessar a API da sua loja.
A chave de API e a chave de aplicação são a mesma coisa?
Não. São credenciais diferentes, e você precisa de ambas para autenticar requisições na API.
Criar automações pode otimizar significativamente sua operação, mas exige conhecimento técnico específico. Use este artigo como ponto de partida e não hesite em buscar ajuda especializada quando necessário.
#automacao #api #integracao #make #n8n #zapier #personal-token