Configurar Webhook de Catálogo VTEX
O webhook de catálogo envia atualizações de produtos, SKUs e categorias da sua loja VTEX para o Implementaê em tempo real. Com ele configurado, qualquer mudança no seu catálogo é refletida automaticamente nas integrações ativas.
Pré-requisitos
- AppKey + AppToken VTEX já gerados (veja Gerar AppKey)
- Permissão Catalog (leitura) na chave de aplicação
O que é o webhook de catálogo?
Passo 1 — Localizar o endpoint de webhook no painel
- Acesse hub.implementae.com
- Vá em Integrações → VTEX → Catálogo
- Copie o Endpoint de webhook exibido na tela
Passo 2 — Registrar o webhook na VTEX via API
Use a API da VTEX para registrar o hook. Exemplo com curl:
curl --request POST \ --url 'https://{accountName}.vtexcommercestable.com.br/api/catalog_system/pvt/hook/config' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'X-VTEX-API-AppKey: {appKey}' \ --header 'X-VTEX-API-AppToken: {appToken}' \ --data '{ "hookConfig": { "address": "https://implementae-webhook.{seu-worker}.workers.dev/vtex/catalog", "active": true } }'Substitua
{accountName},{appKey},{appToken}e o endpoint pelos valores do seu ambiente.
Passo 3 — Verificar recebimento
- Faça uma pequena edição em um produto de teste na VTEX
- Volte ao painel Implementaê → Logs → Catálogo
- Confirme que o evento aparece na lista
Resolução de problemas
| Problema | Causa comum | Solução |
|---|---|---|
| Webhook não chega | Endpoint incorreto | Verifique o URL copiado do painel |
| Erro 401 | AppKey sem permissão Catalog | Adicione a role no admin VTEX |
| Produtos desatualizados | Hook inativo | Verifique "active": true no payload |