Cómo separar ofertas y productos en los webhooks recibidos
Los criterios funcionan como filtros de entrega. Por ejemplo, dos ofertas de un curso pueden conceder insignias distintas si cada listener acepta únicamente el identificador de su oferta.
Necesitas permiso para consultar y administrar esta función en tu plataforma.
En la plataforma, abre tu foto de perfil y elige el panel administrativo. Después sigue: Integraciones → Webhooks → Recibidos → Nuevo listener.
1Define un destino por listener
Introduce el nombre y elige Ação ao receber (acción al recibir). Cada listener tiene su propia URL y una acción. Planifica un listener por oferta o entrega. La misma URL puede recibir eventos de varios productos, pero eso no crea filtros automáticamente.
2Configura el criterio con un payload real
En Criterios de disparo → Añadir criterio, introduce la ruta del campo y el valor esperado. Todos los criterios deben coincidir. Usa el JSON real de cada oferta; no supongas que los gateways utilizan el mismo campo. Si los eventos no contienen ninguna diferencia identificable, estos filtros no podrán separarlos.
3Comprueba cambios y resultados
Al recrear un producto, actualiza el ID del filtro y revisa la URL en el gateway. Guarda, configura el mapeo de la acción y verifica una entrega de cada oferta mediante el registro y la insignia resultante. Dos cuentas del gateway con IDs distintos pueden necesitar listeners separados.
Consejo
La captura del payload puede desactivar temporalmente el listener: reserva una ventana sin ventas y revisa los eventos recibidos durante ese intervalo. Consulta también Cómo investigar errores en los webhooks recibidos.
Preguntas frecuentes
¿Qué ocurre sin criterios?
El listener puede ejecutar su acción para cualquier payload recibido. Poner el nombre de la oferta al listener no filtra los eventos.