Automações

Loja Integrada API — pedidos, produtos e clientes.

Nó Loja Integrada

O nó de workflow Loja Integrada é um cliente REST para a Loja Integrada API. Use-o para consultar e gerenciar pedidos (pedidos), produtos (produtos) e clientes (clientes).

Node ID no editor: lojaintegrada_request
URL padrão: GET https://api.awsli.com.br/v1/pedido/search

O que faz

  • Envia requisições HTTP autenticadas para a API da Loja Integrada (api.awsli.com.br)
  • Suporta GET, POST, PUT e DELETE
  • Retorna HTTP status, data da resposta e headers da resposta
  • Auth padrão: Authorization: chave_api {{lojaintegrada_api_key}}

Pré-requisitos

  1. Uma loja Loja Integrada
  2. API key (chave de 20 caracteres) do admin Loja Integrada → API
  3. Integration key em Configurações → API Keys:
    • lojaintegrada_api_key

Como configurar

Passo 1 — Obter sua API key

No admin Loja Integrada, gere ou copie sua chave de API (20 caracteres). A Loja Integrada usa esquema de auth customizado — não Bearer token.

Passo 2 — Definir credenciais

Adicione lojaintegrada_api_key como integration key. O formato do header é:

Authorization: chave_api YOUR_20_CHAR_KEY

Passo 3 — Configurar o nó

CampoObrigatórioDescrição
URL / EndpointSimURL completa da Loja Integrada API
MethodNãoGET, POST, PUT, DELETE (padrão: GET)
Headers (JSON)NãoDeve incluir Authorization: chave_api ... se sobrescrever
Body (JSON)NãoRequest body para POST/PUT

Templates de operação integrados

OperaçãoMethodEndpoint
Search ordersGET/v1/pedido/search
List productsGET/v1/produto
List customersGET/v1/cliente
Create customerPOST/v1/cliente
Update customerPUT/v1/cliente/{cliente_id}

Exemplo — criar cliente (POST body):

{
  "nome": "{{contact.name}}",
  "email": "{{contact.email}}",
  "cpf_cnpj": "{{variables.cpf}}"
}

Nomes de endpoints estão em português (pedido, produto, cliente) conforme convenção da Loja Integrada API.

Passo 4 — Usar dados da resposta

Order number: {{lojaintegrada_1.data.numero}}
Customer email: {{lojaintegrada_1.data.cliente.email}}

Saídas do nó

Campo de saídaDescrição
statusHTTP status code
dataCorpo da resposta JSON parseado
headersResponse headers

Dicas e boas práticas

  • Auth usa prefixo chave_api — não use Bearer a menos que a documentação Loja Integrada especifique
  • Use /pedido/search com filtros de query para status e intervalos de data
  • Webhooks Loja Integrada notificam eventos de pedido — combine com este nó para payload completo do pedido
  • Armazene cliente_id nos contatos WhatsWave após create para fluxos de update

Exemplos de uso

Confirmação WhatsApp de novo pedido

  1. Webhook — novo pedido Loja Integrada
  2. Loja Integrada GET — busca de pedido por ID
  3. Send WhatsApp — "Pedido #{{lojaintegrada_1.data.numero}} recebido!"

Verificação de estoque antes da venda

  1. WhatsWave Agent — cliente pergunta sobre disponibilidade
  2. Loja Integrada GET/v1/produto/{id}
  3. Agent response — estoque de {{lojaintegrada_1.data.estoque}}

FAQ

Por que 401 Unauthorized?
API key incorreta ou prefixo chave_api ausente no header Authorization. Use o template de header integrado.

Por que endpoints estão em português?
A Loja Integrada API usa nomes de recursos em português (pedido, cliente).

Posso filtrar pedidos por status?
Sim — adicione query parameters em /v1/pedido/search conforme documentação Loja Integrada API.

Isso difere do nó HTTP?
Pré-configurado com URLs Loja Integrada, formato de auth header e atalhos de operação.

Referência da API

ItemValor
Base URLhttps://api.awsli.com.br/v1/
AuthAuthorization: chave_api {api_key}
Docs oficiaisLoja Integrada developer

Relacionado

Este artigo foi útil?

Precisa de mais ajuda? Falar com suporte

Central de Ajuda