Pular para o conteúdo principal

Guia de Integração: VNDA

Conecte a sua loja VNDA (Olist Ecommerce) 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 VNDA / Olist Ecommerce.
  • Acesso de administrador para gerar um token de API no painel da loja.

2. Instalação​

  1. No painel da VNDA, acesse Configurações (engrenagem) > Área Dev > Token de API e gere um novo token.
  2. No painel do Conversaas, acesse Integrações > VNDA.
  3. Informe o Domínio da Loja (endereço completo, sem https:// e sem barra no final — ex: www.minhaloja.com.br) e cole o Token da API gerado no passo 1.
  4. Clique em Conectar Loja.
  5. Se a conexão for validada com sucesso, o Conversaas tenta registrar os webhooks automaticamente na sua loja VNDA.

3. Funcionalidades Disponíveis​

  • Recuperação de Carrinho Abandonado: [DISPONÍVEL] Captura o evento de checkout iniciado e não finalizado e dispara mensagens automáticas via WhatsApp para recuperar a venda. Quando o telefone do cliente não vem no payload do evento, o Conversaas busca automaticamente o telefone cadastrado na VNDA a partir do e-mail do cliente, como fallback.
  • Notificações de Pedido: [DISPONÍVEL] Informa o cliente via WhatsApp sobre recebimento, confirmação de pagamento, envio, entrega e cancelamento do pedido.
  • Consulta de Catálogo pelo Agente: [DISPONÍVEL] O agente busca produtos, preços e disponibilidade diretamente na VNDA para responder dúvidas dos clientes.

4. Webhooks​

Ao conectar a loja, o Conversaas tenta registrar automaticamente um único endpoint de webhook na sua conta VNDA. Se o registro automático falhar, uma mensagem no painel avisa que a configuração manual é necessária — nesse caso, cadastre a URL exibida na tela de integração (no formato https://api.conversaas.com.br/integrations/vnda/webhook/{id-da-integracao}) no painel VNDA, em Configurações > Webhooks > Adicionar webhook, para os seguintes eventos:

  • order-received
  • order-confirmed
  • package-shipped
  • package-delivered
  • order-canceled
  • cart-abandoned

Todos esses eventos chegam no mesmo endpoint — o Conversaas identifica o tipo pelo conteúdo do payload e direciona internamente para o fluxo de carrinho abandonado ou de notificação de pedido, conforme o caso.

5. Testando a Integração​

  1. Confirme que o status da integração está Ativo no painel do Conversaas.
  2. Adicione um produto ao carrinho na sua loja VNDA e inicie o checkout com um e-mail ou telefone de teste, sem concluir a compra.
  3. Aguarde o tempo configurado em Carrinho Abandonado > Configurações e verifique se a mensagem de recuperação chegou no WhatsApp de teste.
  4. Finalize um pedido de teste e altere o status no painel VNDA (ex: para "Pago") para conferir se a notificação de pedido também foi disparada.

6. Perguntas Frequentes da Integração​

A integração afeta a performance da loja? Não. A comunicação com o Conversaas acontece de forma assíncrona via webhooks, sem impacto no carregamento da loja para o cliente.

Preciso configurar o webhook manualmente? Na maioria dos casos não — o Conversaas registra o webhook automaticamente ao conectar a loja. A tela de integração mostra se o registro automático funcionou ou se é necessário configurar manualmente.

Por que às vezes o Conversaas consulta a API da VNDA de novo depois do webhook de carrinho abandonado? Quando o telefone do cliente não vem no próprio payload do evento de checkout, o Conversaas faz uma consulta adicional à API da VNDA usando o e-mail do cliente para tentar recuperar o telefone cadastrado, evitando perder a oportunidade de recuperação.

Como desativar temporariamente sem perder a configuração? Acesse Integrações > VNDA no painel do Conversaas e remova a integração, ou entre em contato com o suporte para pausá-la. Ao reconectar com o mesmo domínio e um novo token, o histórico de pedidos vinculado permanece no CRM.