A integração entre OmniChat e VTEX conecta sua loja de e-commerce à plataforma de atendimento, permitindo que os vendedores acessem catálogo de produtos, regras de preço, promoções, logística e informações de pedido diretamente nas conversas com os clientes.
Para que serve
Vender pelo WhatsApp com acesso ao catálogo completo do e-commerce
Aplicar preços, promoções e políticas comerciais da VTEX nas conversas
Recuperar carrinhos abandonados com campanhas automáticas
Rastrear o desempenho de vendas por vendedor via parâmetros de URL
Parte 1 — Como ativar a integração na OmniChat
Acesse: Menu Lateral → Configurações → Integrações
No menu de integrações, clique em E-Commerce/ERP
Clique em Nova Integração — o formulário VTEX será carregado
Preencha os campos do formulário
Clique em Salvar — a sincronização com a VTEX será iniciada automaticamente
Campo | O que informar |
Versão da loja | Indique se sua loja usa VTEX IO ou não. |
Nome | Nome que identificará essa integração na lista da OmniChat. |
Time | (Opcional) Vincule um ou mais times. |
API Key | Chave de aplicação gerada no admin da VTEX. |
API Token | Token gerado junto com a API Key no admin da VTEX. |
Nome da Conta | Nome da sua loja na VTEX. |
Política comercial | ID da política comercial da VTEX para usar nas vendas da OmniChat. |
URL do E-commerce | URL pública da sua loja. |
URL do Checkout | URL do checkout. |
Parâmetros extras da URL | (Opcional) Parâmetros adicionados ao link de checkout. |
Parte 2 — Como criar a Chave de Aplicação na VTEX
Etapa 1 — Criar o perfil de acesso
No admin da VTEX, acesse: Configurações de conta → Perfis de acesso
Clique em Novo perfil e dê um nome de identificação
Adicione as permissões necessárias e salve o perfil
Módulo | Permissões necessárias |
OMS | Feed v3 and Hook Admin, Subscription view only, Notify payment, Notify invoice, View order, Notify refund, Cancel order, List Orders |
Checkout | Order Full Access |
Catalog | Product management |
Pricing | Read prices |
Dynamic Storage | Master Data administrator |
Rates and Benefits | Manage benefits and rates |
Logistics | Logistics viewer |
Etapa 2 — Gerar a Chave de API
No admin da VTEX, acesse: Configuração de conta → Chaves de API
Clique em Gerar chave
Dê um nome e selecione o perfil criado na etapa anterior
Clique em Gerar
Copie e guarde o API Key e o API Token — o token será mostrado apenas uma vez
⚠️ Atenção: O API Token é exibido uma única vez. Guarde-o em local seguro antes de fechar a tela da VTEX.
Parte 3 — Script de Carrinho Abandonado
Se você ativou a funcionalidade de Carrinho Abandonado, é necessário inserir um script da OmniChat na página de checkout. O local onde o script deve ser inserido depende do tipo de checkout da sua loja:
Cenário A — Checkout padrão VTEX
No admin da VTEX, acesse: Configurações da loja → Storefront → Checkout
Clique no ícone de engrenagem azul do seu checkout
No menu superior, clique em Código
No menu lateral direito, selecione o arquivo checkout6-custom.js
Cole o script copiado da tela de configuração da integração VTEX na OmniChat (ao final do código existente)
Clique em Salvar
Cenário B — Checkout personalizado
Acesse: Storefront → Interface personalizada do checkout
Selecione a aba JavaScript
Cole o script da OmniChat no campo
Marque a opção como Ativo
Clique em Publicar
Cenário C — Compra rápida
⚠️ Atenção: Atualmente não há suporte para o Carrinho Abandonado em lojas que utilizam o modelo de compra rápida. Em caso de customizações específicas, valide com o suporte OmniChat se o script está sendo carregado corretamente.