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.
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.
- Pedir o número do pedido e guardar no contato. Veja Adquirir Dados: perguntar e salvar a 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.
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. Mais detalhes na documentação da VTEX.
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.
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.
- Request Type: aqui, GET.
- Request URL: o endereço do pedido na sua conta da VTEX.
- As abas da janela: Cabeçalhos, Corpo, Mapeamento de resposta e Testar Agora.
- Os cabeçalhos:
X-VTEX-API-AppKeycom{{VTEX appKey}}eX-VTEX-API-AppTokencom{{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.
- Sucesso: siga para a mensagem com a situação do pedido.
- 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.
O passo a passo completo da requisição está em Requisição externa: enviar e receber dados de outro sistema.
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.
Faça com a IA
Copie o pedido e cole no ChatGPT ou no Claude.
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.
Relacionados
Este conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.