⏱️ Tempo de leitura: 4 minutos
Nível: ⭐⭐⭐⭐☆ (Intermediário-Avançado)
Este artigo aborda:
Escopo do suporte oferecido pela Loja Integrada
Requisito essencial: chave de aplicação
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
Fornecimento da chave de aplicação necessária para APIs
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: obter sua chave de aplicação
Antes de configurar qualquer automação externa, você precisará de uma chave de aplicação. Esse é um requisito obrigatório para que ferramentas externas possam se comunicar com sua loja através da API.
A chave de aplicação funciona como uma senha especial que autoriza sistemas externos a acessarem dados da sua loja de forma segura. Sem ela, não é possível estabelecer a conexão.
Como solicitar sua chave
Acesse o artigo Como obter a chave de aplicação para integrar com a Loja Integrada e preencha o formulário disponível. A solicitação é analisada pela nossa equipe e você recebe a chave por e-mail assim que aprovada.
O erro mais comum: configuração de credenciais
Aqui está a informação que causa mais dificuldades para quem está começando: a forma correta de passar as credenciais no Header de autorização.
Como funciona a autenticação
Quando você faz uma requisição para a API da Loja Integrada, precisa enviar suas credenciais no Header Authorization
. Muitas pessoas cometem o erro de enviar apenas a chave de aplicação ou apenas a chave de API, mas é necessário enviar ambas no mesmo campo.
Configuração correta
No Header Authorization
, você deve passar:
chave_api: sua chave de API
aplicacao: sua chave de aplicação
⚠️ Erro comum: Colocar apenas um dos valores ou tentar enviá-los em campos separados. A API exige que ambas as credenciais estejam presentes no mesmo Header de autorização para validar sua requisição.
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
Incluir tanto a chave_api quanto a aplicacao juntas neste campo
A estrutura exata e o formato podem 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.
Quanto tempo demora para receber a chave de aplicação?
O prazo varia conforme a análise da solicitação. Você receberá a chave por e-mail assim que o processo for concluído.
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.
O que faço se minhas requisições retornam erro de autenticação?
Verifique se você está enviando tanto a chave_api quanto a aplicacao no mesmo Header Authorization. Esse é o erro mais comum.
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 #chave-aplicacao