# VTEX

> O cliente pergunta pelo pedido no WhatsApp e o fluxo consulta a VTEX pela API, com a chave de aplicação, e responde a situação na hora.

Endereço: https://help.nextags.com.br/integracoes/vtex/
Tipo: Integração

Atualizado em: 25/10/2026

A VTEX se liga à NexTags pela API. Num fluxo, a requisição externa consulta o pedido na VTEX com uma chave de aplicação (o appKey e o appToken) e o robô responde ao cliente com a situação do pedido. A NexTags não tem cartão da VTEX em **Configurações** › **Integrações**: a chave fica em campos do bot.

## O que dá para fazer

- Responder "onde está o meu pedido?" sem ninguém da equipe. Veja [Requisição externa: enviar e receber dados de outro sistema](https://help.nextags.com.br/tutoriais/fluxos/requisicao-externa/).
- Pedir o número do pedido e guardar no contato. Veja [Adquirir Dados: perguntar e salvar a resposta](https://help.nextags.com.br/tutoriais/fluxos/perguntar-e-salvar-resposta/).
- Mandar uma resposta para cada situação e passar para a equipe quando o pedido não é achado. Veja [Etapa Condição: caminhos diferentes para cada contato](https://help.nextags.com.br/tutoriais/fluxos/condicoes/).

## Como conectar

### Passo 1: Gere a chave de aplicação na VTEX

No Admin da VTEX, gere uma chave de aplicação e copie o appKey e o appToken. Ligue a chave a um perfil de acesso que possa consultar pedidos: sem perfil, a chave não tem permissão. Guarde os dois valores em campos do bot, como `VTEX appKey` e `VTEX appToken`: veja [Campos do bot: um valor para a conta toda](https://help.nextags.com.br/tutoriais/fluxos/campos-do-bot/). Mais detalhes na [documentação da VTEX](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys).

### Passo 2: Pergunte o número do pedido

No fluxo, peça o número do pedido e guarde num campo, como `Número do pedido`. Veja [Adquirir Dados: perguntar e salvar a resposta](https://help.nextags.com.br/tutoriais/fluxos/perguntar-e-salvar-resposta/).

### Passo 3: Consulte o pedido

Numa etapa **Ações**, adicione **External API Request**, com **GET** e o endereço `https://{conta}.vtexcommercestable.com.br/api/oms/pvt/orders/{{Número do pedido}}`. Troque `{conta}` pelo nome da sua conta na VTEX. Na aba **Cabeçalhos**, ponha `X-VTEX-API-AppKey` e `X-VTEX-API-AppToken`, cada um com o seu campo.

![Janela External Request: tipo POST, endereço da API e, na aba Cabeçalhos, o cabeçalho Authorization com a chave guardada num campo.](https://help.nextags.com.br/_img/fluxos-acoes/requisicao.webp)
*A janela da requisição. O print mostra outra API: na VTEX, o método é GET e os cabeçalhos são os da chave de aplicação.*

1. **Request Type**: aqui, **GET**.
2. **Request URL**: o endereço do pedido na sua conta da VTEX.
3. As abas da janela: **Cabeçalhos**, **Corpo**, **Mapeamento de resposta** e **Testar Agora**.
4. Os cabeçalhos: `X-VTEX-API-AppKey` com `{{VTEX appKey}}` e `X-VTEX-API-AppToken` com `{{VTEX appToken}}`.

### Passo 4: Guarde a situação e responda

Abra **Testar Agora** com um número de pedido real e veja no **Corpo da resposta** onde está a situação do pedido. Na aba **Mapeamento de resposta**, guarde esse caminho num campo, como `Situação do pedido`. No quadro, ligue **Sucesso** à resposta com a situação e **Falhado** a um caminho de reserva.

![Etapa no quadro com a requisição externa e as duas saídas, Sucesso e Falhado.](https://help.nextags.com.br/_img/fluxos-acoes/requisicao-saidas.webp)
*As saídas da requisição no quadro.*

1. **Sucesso**: siga para a mensagem com a situação do pedido.
2. **Falhado**: siga para um caminho de reserva, como pedir o número de novo ou passar para a equipe. Veja [Transferir para humano e atribuir a conversa](https://help.nextags.com.br/tutoriais/fluxos/passar-para-humano/).

O passo a passo completo da requisição está em [Requisição externa: enviar e receber dados de outro sistema](https://help.nextags.com.br/tutoriais/fluxos/requisicao-externa/).

## Se não funcionou

### O teste mostra o código 401 ou 403

A VTEX não aceitou a chave ou a chave não tem permissão. Confira o appKey e o appToken e se a chave está ligada a um perfil de acesso que consulta pedidos.

### O teste mostra o código 404

O pedido não foi achado. Confira se o número tem o mesmo formato que aparece no Admin da VTEX e se `{conta}` é o nome da sua conta.

### O campo da situação ficou vazio

O caminho não bate com a resposta. Abra **Testar Agora**, veja o **Corpo da resposta** e corrija o caminho. Veja [Erros de requisição externa, webhook e planilha](https://help.nextags.com.br/tutoriais/erros/erros-de-requisicao-externa/).

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Quero responder no WhatsApp a situação dos pedidos da minha loja na VTEX, com a NexTags. Leia esta página: https://help.nextags.com.br/integracoes/vtex.md

Este é o corpo da resposta de um pedido de teste, sem dados reais de clientes: [cole aqui]. Diga o caminho (JSONPath) da situação do pedido e do link de acompanhamento, se houver, e escreva uma mensagem curta para cada situação. Não me peça o appKey nem o appToken.
```