Guia de Integração: VTEX

Conecte a sua loja VTEX ao Conversaas para automatizar a recuperação de carrinhos abandonados, enviar notificações de pedido e permitir que o agente consulte o catálogo de produtos em tempo real.

1. Pré-Requisitos

• Loja ativa na plataforma VTEX.
• Acesso de administrador para gerar uma Chave de Aplicação (App Key/App Token) na conta VTEX.

2. Instalação

1. No painel VTEX, acesse Conta > Gerenciamento da Conta > Chaves de Aplicação e crie uma nova chave.
2. Conceda permissão de leitura nas categorias Orders, Master Data e Catalog.
3. No painel do Conversaas, acesse Integrações > VTEX.
4. Informe o Account Name (nome da conta VTEX, sem .vtexcommercestable.com.br — é o trecho que aparece na URL do seu painel, ex: minhaloja em minhaloja.myvtex.com), o App Key e o App Token gerados no passo 1.
5. Clique em Testar e Salvar Conexão.
6. Ao salvar com sucesso, o Conversaas registra automaticamente um Order Hook na sua conta VTEX — você não precisa copiar nem colar nenhuma URL de webhook manualmente na VTEX.

3. Funcionalidades Disponíveis

• Recuperação de Carrinho Abandonado: [DISPONÍVEL] O Conversaas verifica periodicamente carrinhos sem interação recente diretamente na API da VTEX (não depende de webhook) e dispara mensagens automáticas via WhatsApp para recuperar a venda.
• Notificações de Pedido: [DISPONÍVEL] O agente envia atualizações automáticas sobre pagamento aprovado, faturamento, pedido concluído e cancelamento.
• Consulta de Catálogo pelo Agente: [DISPONÍVEL] O agente busca produtos, preços e disponibilidade diretamente na VTEX para responder dúvidas dos clientes.

4. Webhooks

Diferente de outras plataformas, você não precisa configurar nada manualmente: o Conversaas registra o Order Hook automaticamente na sua conta VTEX assim que a conexão é salva com sucesso. Os eventos monitorados são: Pagamento Aprovado, Faturado, Pedido Concluído e Cancelado.

Por padrão de infraestrutura da VTEX, o endpoint do Conversaas responde imediatamente com sucesso ao receber a notificação e processa o pedido de forma assíncrona em segundo plano (busca os detalhes completos do pedido na API da VTEX antes de disparar a mensagem), evitando timeouts do lado da VTEX.

O carrinho abandonado funciona de forma diferente: não existe webhook de checkout na VTEX, então o Conversaas consulta a API da VTEX periodicamente em busca de carrinhos sem interação — não é necessário nenhum cadastro adicional para esse fluxo.

5. Testando a Integração

1. Confirme que o status da integração está Ativo no painel do Conversaas, na tela Integrações > VTEX.
2. Crie um pedido de teste na sua loja VTEX com um número de WhatsApp válido e avance o status até "Pagamento Aprovado".
3. Verifique no Conversaas (em CRM & Leads ou Histórico de Conversas) se a notificação foi recebida e enviada ao cliente.
4. Para testar a recuperação de carrinho, inicie um checkout sem finalizar e aguarde a próxima verificação periódica — o intervalo é de poucos minutos.

6. Perguntas Frequentes da Integração

A integração afeta a performance da loja? Não. A comunicação com o Conversaas é feita de forma assíncrona via Order Hook e consultas de API em segundo plano, sem impacto no carregamento da loja para o cliente.

Preciso colar alguma URL de webhook no painel da VTEX? Não. O Conversaas registra o Order Hook automaticamente na sua conta durante a conexão. Se esse registro falhar por algum motivo, a integração ainda é salva e você pode tentar reconectar para registrar o hook novamente.

O carrinho abandonado é detectado em tempo real? Não exatamente — como a VTEX não dispara um webhook de checkout, o Conversaas verifica periodicamente os carrinhos em aberto pela API. Pode levar alguns minutos entre o abandono e a detecção, diferente da notificação de pedido, que é acionada pelo Order Hook.

Como desativar temporariamente sem perder a configuração? Acesse Integrações > VTEX no painel do Conversaas e remova a integração quando quiser pausar. Para reativar, basta reconectar com as mesmas credenciais.