Como separar ofertas e produtos nos webhooks recebidos
Os critérios funcionam como filtros de entrega. Por exemplo, duas ofertas de um curso podem conceder selos diferentes quando cada listener aceita apenas o identificador da oferta correspondente.
Você precisa de permissão para consultar e gerenciar o recurso na sua plataforma.
Na plataforma, abra sua foto de perfil e clique em Painel administrativo. Depois siga: Integrações → Webhooks → Recebidos → Novo Listener.
1Defina um destino por listener
Preencha o nome e escolha Ação ao receber. Cada listener tem sua própria URL e uma ação. Planeje um listener por oferta ou entrega. Uma mesma URL pode receber eventos de vários produtos, mas isso não cria filtros automaticamente.
2Configure o critério com um payload real
Em Critérios de disparo → Adicionar critério, informe o caminho do campo e o valor esperado. Todos os critérios precisam corresponder. Use o JSON real de cada oferta; não presuma que o gateway usa sempre o mesmo campo. Se os eventos não trazem nenhuma diferença identificável, esses filtros não conseguem separá-los.
3Confira mudanças e resultados
Ao recriar um produto, atualize o ID usado no filtro e confira a URL no gateway. Salve, configure o mapeamento da ação e valide uma entrega de cada oferta, olhando o log e o selo resultante. Duas contas do gateway com IDs diferentes podem precisar de listeners separados.
Dica
A captura de payload pode deixar o listener temporariamente inativo: reserve uma janela sem vendas e confira eventos recebidos durante o intervalo. Leia também Como investigar erros nos webhooks recebidos.
Dúvidas comuns
Sem critérios, o que acontece?
O listener pode executar sua ação para qualquer payload recebido. O nome da oferta no listener não é um filtro.