A integração entre OmniChat e VTEX permite utilizar todo o catálogo de produtos do seu e-commerce, incluindo regras de logística, pagamento e promoções, diretamente nas conversas de atendimento. Este artigo apresenta o processo completo de ativação.
Parte 1 — Ativar a integração na OmniChat
Na OmniChat, acesse Configurações → Integrações → E-Commerce/ERP
Clique em Nova Integração — o formulário de integração VTEX será exibido
Preencha os campos do formulário:
Campo | Descrição |
Nome | Nome da integração (aparecerá na lista de integrações disponíveis) |
Time | (Opcional) Associe um ou mais times. Se nenhum for definido, fica disponível para todos |
API Key | Chave de aplicação gerada no admin da VTEX (formato: vtexappkey-minhaloja-ABCDE) |
API Token | Token gerado junto com a API Key no admin da VTEX |
Nome da Conta | Nome da loja na VTEX (ex.: se a URL é minha-loja.myvtex.com, o nome é minha-loja) |
Política Comercial | ID da política comercial da VTEX para as vendas na OmniChat |
URL do E-commerce | URL pública da loja (ex.: https://www.minhaloja.com.br) |
Parâmetros extras da URL | (Opcional) Parâmetros adicionais para a URL de checkout |
Utiliza preço por atacado | Marque se deseja utilizar preços de atacado nas vendas via OmniChat |
💡 Dica: Você pode incluir o nome ou código do vendedor na URL de checkout utilizando os parâmetros dinâmicos: #{salesPersonName} (nome) ou #{salesPersonCode} (código).
Após preencher, clique em Salvar. A sincronização dos dados com a VTEX será iniciada automaticamente.
Parte 2 — Criar o perfil de acesso na VTEX
No admin da VTEX, acesse Configurações da Conta → Gerenciamento da Conta → Perfis de Acesso
Clique em Novo perfil
Defina o nome do perfil (ex.: OmniChat Integration) e adicione as permissões necessárias:
Produto | Permissões obrigató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 |
Dynamic Storage | Master Data administrator |
Use o botão Configurar outro produto para adicionar cada módulo. Clique em Salvar para criar o perfil.
Parte 3 — Gerar a chave de aplicação na VTEX
Acesse Configurações de Conta → Gerenciamento de Conta → Conta
Na área Segurança, clique em Gerar chave de acesso e segredo
Informe o nome da chave (ex.: OmniChat) e clique em Gerar novo segredo
Copie o segredo gerado e guarde em local seguro — ele é exibido apenas uma vez
Clique em Gerenciar acesso e depois em + Adicionar perfis
Pesquise e selecione o perfil criado para a OmniChat e clique em Adicionar Perfis
Clique em Salvar
✅ Integração concluída! Após esses três passos, a OmniChat estará conectada à sua loja VTEX. Valide a integração realizando um pedido de teste junto ao seu Customer Success Manager.