VTEX
Atualizado em 24 de agosto de 2026
A integração da VTEX importa para a Pluspoint os pedidos concluídos da sua loja. Cada pedido importado cria ou localiza um contato e grava uma entrada datada da VTEX na linha do tempo dele. É essa entrada que uma automação pós-compra escuta. Conecte a integração quando quiser que uma compra dispare uma pesquisa, uma mensagem ou um cupom, sem exportar nada manualmente.
Antes de começar
- Permissão de Configurações de conta definida como Completo — a aba Integrações fica oculta para todos os demais.
- Acesso ao seu VTEX Admin, com permissão para gerar chaves de aplicação.
- Uma localização da Pluspoint para vincular a loja.
- Uma assinatura ativa e dentro dos limites de localizações e de usuários.
Onde encontrar
Configurações → Integrações, ou acesse https://app.pluspoint.io/account-settings/integrations.
Gerar uma App Key e um App Token na VTEX
A App Key identifica a aplicação que se conecta à sua loja e o App Token a autoriza. A Pluspoint precisa dos dois, mais o nome da sua conta.
- Entre no seu VTEX Admin.
- Vá em Account Management → Apps.
- Clique em Generate App Key and Token.
- Escolha Internal app keys como tipo de chave. Este é o nível de acesso de que a Pluspoint precisa.
- Nas permissões, inclua o recurso View order. Ele faz parte de OMS - Full access e de IntegrationProfile - Fulfillment Oms. Sem ele a Pluspoint não consegue ler os detalhes dos pedidos.
- Clique em Generate.
- Copie a App Key e o App Token na hora.
Aviso A App Key e o App Token dão acesso à sua loja VTEX. Guarde-os em local seguro e não os compartilhe além da pessoa que está fazendo esta configuração.
Conectar a sua loja VTEX
- Acesse Configurações → Integrações.
- Clique em Adicionar integração e localize VTEX.
- Clique em Conectar.
- Preencha os três campos de credenciais listados em Campos de credenciais, abaixo.
- Clique em Conectar.
A Pluspoint valida as credenciais antes de salvá-las. Se a VTEX as recusar, a conexão falha com “Falha na autenticação do VTEX” e nada é armazenado.
Quando dá certo, a janela Gerir integração abre para você associar a conta a uma localização.
Campos de credenciais
| Campo | O que informar |
|---|---|
| Nome da Conta | O nome da sua conta VTEX — o identificador da loja que aparece na URL do seu VTEX Admin |
| Application Token | O App Token gerado na VTEX |
| Application Key | A App Key gerada na VTEX |
Os três são obrigatórios, e nenhum é verificado quanto a formato ou tamanho.
Vincular a loja a uma localização
Os pedidos são importados por localização, então a conta VTEX precisa estar associada a uma.
- Abra a janela Gerir integração. Ela abre sozinha depois de conectar, e o botão Gerir na linha da VTEX a reabre mais tarde.
- Escolha Conectar ao local e selecione a localização na lista Localização, ou escolha Não conectar para deixá-la sem vínculo.
- Clique em Salvar.
Você pode fazer o mesmo a partir da localização: Localizações → Gerir localizações → abra a localização → Integrações → a linha VTEX → Conectar Perfil.
A lista Localização oculta as localizações que já têm uma conexão da VTEX, então uma localização pode ter apenas uma loja.
Como funciona a importação de pedidos
| Comportamento | Detalhe |
|---|---|
| Agendamento | Uma vez por dia, às 12:00 UTC |
| O que é importado | Os pedidos que a VTEX reporta para o dia anterior, para cada localização vinculada a uma conta VTEX. Apenas pedidos completos — pedidos incompletos são ignorados |
| Identificação de contatos | Pelo número de telefone tratado do comprador, ou pelo e-mail dele |
| Atualização de contatos | Primeiro nome, sobrenome, e-mail ou telefone que faltem são preenchidos em um contato existente; os valores já existentes são preservados |
| E-mails mascarados | Endereços de proxy da VTEX terminados em .ct.vtex.com.br são desembrulhados até o endereço real antes de o contato ser salvo |
| Evento registrado | Um evento de pedido VTEX cai na linha do tempo de atividades do contato, que é o que o gatilho Pedido da VTEX escuta |
| Clientes recorrentes | O evento de pedido só é escrito para um contato que ainda não tem nenhum evento de integração na linha do tempo. Um comprador que volta, portanto, não gera um segundo evento. O mesmo vale para um comprador cujo contato já carrega um evento de outra integração conectada |
| Envio | Nenhum. A importação registra dados; qualquer coisa enviada ao comprador vem de uma automação que você monta |
| Contas por conta da Pluspoint | Uma. Conectar de novo substitui o nome da conta, a chave e o token armazenados |
Como a importação é um lote diário, nada chega a um comprador antes da primeira execução das 12:00 UTC depois do pedido dele. Leve isso em conta ao planejar qualquer espera adicional.
Transformar pedidos em uma mensagem pós-compra
Conectar a loja é apenas a primeira metade. Para agir sobre um pedido, monte uma automação em Campanhas → Automatizadas — montá-la exige acesso completo a Campanhas e um plano que inclua Campanhas.
O uso mais comum é uma pesquisa de satisfação pós-compra:
- Vá em Campanhas → Automatizadas e clique em Criar automação.
- Dê um nome a ela, por exemplo “Pesquisa pós-compra”.
- Clique no nó Gatilho e selecione Pedido da VTEX em Eventos de desencadeamento. Essa opção só aparece depois que a integração VTEX está conectada.
- Opcionalmente ligue Uma vez por contato e, se quiser, restrinja o público em Quem pode entrar.
- Clique no + da conexão abaixo do gatilho e acrescente um Aguardar, se quiser dar tempo para a entrega. Um aguardar colocado logo depois do gatilho é medido a partir do próprio evento do pedido. Ou seja, “3 dias” significa três dias depois do pedido, e não três dias depois de a automação ter percebido o pedido.
- Clique no + de novo e acrescente Enviar pesquisa, do grupo Enviar.
- Escolha o Canal e o modelo em Pesquisa. Só são listados modelos com Ativar envio de pesquisas ligado.
- Se o canal for de e-mail, escolha um design de e-mail da Biblioteca que tenha um botão Link da pesquisa. Se for WhatsApp Business, escolha um modelo do WhatsApp aprovado cujo botão de URL seja um link de pesquisa. SMS e WhatsApp (Beta) usam o próprio texto de Modelo de mensagem do modelo de pesquisa.
- Clique em Salvar e depois ligue Ativado na lista Automatizadas. Até você fazer isso, a automação é um rascunho e não envia nada.
Automatizando pesquisas cobre por completo o canvas de automação, a preparação do modelo e o tempo de envio.
Desconectando a VTEX
- Na linha VTEX, clique em Eliminar. A mesma confirmação está disponível no botão vermelho Eliminar dentro da janela Gerir integração.
- Confirme na janela Eliminar integração?.
O vínculo da VTEX na sua localização passa para Desconectado, então nenhum pedido a mais é importado. Os contatos e as atividades já importados permanecem. Qualquer automação que use o gatilho Pedido da VTEX deixa de receber entradas novas.
Solução de problemas
| Sintoma | Causa | Correção |
|---|---|---|
| A VTEX não está na lista Adicionar integração | Ela já está conectada | Existe apenas uma conta VTEX por conta da Pluspoint, então a linha sai da lista assim que é conectada. Use Gerir ou Eliminar na linha existente |
| A aba Integrações está ausente ou esmaecida | Você não tem Configurações de conta definida como Completo, ou a assinatura expirou ou ultrapassou os limites do plano | Peça a um proprietário da conta ou a um administrador com acesso completo, ou resolva a questão de cobrança em Configurações → Faturação |
| ”Falha na autenticação do VTEX” | As credenciais estão erradas, ou a chave não tem permissão para ler pedidos | Gere uma nova App Key e um novo App Token na VTEX com acesso de leitura de pedidos e tente de novo |
| O painel na localização indica que não há integração ativa | A conexão da VTEX no nível da conta está faltando ou inativa | Use Acessar integrações e conecte a VTEX primeiro — essa etapa exige Configurações de conta definida como Completo |
| Uma localização não aparece na lista Localização | Ela já tem uma conexão da VTEX | Desconecte a loja daquela localização primeiro |
| Pedido da VTEX não aparece na lista de gatilhos de automação | A VTEX não está conectada nesta conta | Conecte-a em Configurações → Integrações |
| Nenhum contato aparece depois de conectar | A importação diária ainda não rodou, ou a localização não está vinculada | O job roda uma vez por dia às 12:00 UTC e lê os pedidos do dia anterior. Confirme o vínculo em Gerir integração ou na localização |
| Os contatos chegam, mas nada é enviado | Importar pedidos não envia nada por si só, ou a automação ainda é um rascunho | Monte uma automação com o gatilho Pedido da VTEX, confira a chave Ativado dela e procure nós com borda vermelha |
| Alguns compradores nunca recebem convite | Eles cancelaram a inscrição, não têm endereço para o canal escolhido, ou estão dentro da janela de proteção contra sobreopiniões do modelo | Verifique o registro do contato e revise a Proteção contra sobreopiniões na aba Partilha do modelo |
| Um comprador recorrente não é pesquisado de novo | O evento de pedido só é escrito para um contato que ainda não tem nenhum evento de integração | Use outro gatilho, como um Evento personalizado publicado pelos seus próprios sistemas, se você precisa que todo pedido conte |