Pidgely para lojas VTEX
Para operações VTEX que enviam muito email e se importam com onde ele chega: conecte a conta com uma chave de aplicação e o Pidgely envia os emails de pedido com a sua marca, do seu domínio, com tráfego transacional e de marketing separados.
Conectar minha loja
O que a integração faz
- Conexão por credenciais criadas por você: o nome da conta VTEX, uma chave de aplicação e o token dela, sem nada para instalar
- Os cinco emails de pedido saem conforme o pedido do OMS muda de estado, por um hook de pedidos registrado na sua conta
- O Pidgely registra um hook de pedidos por chave de aplicação e o renova na conferência, já que a VTEX deixa o hook expirar após 3 dias sem tráfego
- O email dos clientes é lido do Master Data (a entidade CL); onde a chave não alcança, a VTEX só entrega o endereço mascarado de relay
- Várias contas, marcas ou unidades B2B podem se conectar, cada uma com os seus domínios verificados e a sua reputação de envio
Como conectar
- No painel da VTEX, em Configurações da conta → Perfis de acesso, crie um perfil com View order, List Orders, Feed v3 and Hook Admin, documentos de leitura do Master Data e uma permissão de leitura do catálogo (Get Product and SKU)
- Em Configurações da conta → Chaves de aplicação, crie uma chave, associe esse perfil e copie a chave e o token
- No Pidgely, em Lojas, escolha VTEX e cole o nome da conta, a chave e o token
- O Pidgely os confere com uma chamada à API de pedidos, guarda tudo cifrado e inicia uma primeira sincronização silenciosa
- Desligue as mensagens transacionais equivalentes no lado da VTEX, para o comprador não receber duplicatas
Bom saber
Use uma chave feita só para o Pidgely: a VTEX permite um único hook de pedidos por chave de aplicação, então dividi-la com outra integração faria o hook dela ser substituído.
A VTEX não tem webhooks de clientes nem de produtos e a lista de pedidos não filtra por “atualizado desde”; por isso, a cada 6 horas o Pidgely relê os pedidos criados nos últimos 30 dias e lê os produtos um a um. Carrinhos abandonados não são capturados: a VTEX os expõe só pelo orderForm da vitrine, o que pediria um script na loja.
A VTEX também tem as próprias ferramentas transacionais. O Pidgely serve a quem quer a entregabilidade sob controle; veja emails transacionais de pedido para o conteúdo de cada um. A criação da chave está na documentação da VTEX sobre chaves de aplicação.
Perguntas frequentes
Que permissões a chave da VTEX precisa?
O perfil precisa de View order, List Orders, Feed v3 and Hook Admin, leitura de documentos do Master Data e uma permissão de leitura do catálogo, como Get Product and SKU.
Por que uma chave só para o Pidgely?
A VTEX dá um hook de pedidos para cada chave de aplicação. Uma chave dividida com outra ferramenta teria o hook sobrescrito.
Instalo algum app da VTEX App Store?
Não. A conexão usa uma chave de aplicação que você cria no painel, então não há nada para instalar.
Por que alguns emails de clientes aparecem mascarados?
A VTEX mostra o endereço de relay quando a chave não lê o Master Data. Dê ao perfil leitura da entidade CL e os emails reais passam a chegar.
Com que rapidez saem os emails de pedido?
Quando o hook de pedidos dispara. Se a VTEX perder um, a conferência de 6 em 6 horas relê os pedidos dos últimos 30 dias e envia o que faltou, uma vez por pedido e tipo.
Comece agora
Conecte a sua loja VTEX
Crie a sua conta, verifique o seu domínio e conecte a loja. A primeira sincronização começa na hora.
Criar conta