Flujo completo de creación y prueba de webhooks
Esta guía recorre la creación y prueba de un webhook de principio a fin. Lee primero webhooks y seguridad de webhooks.
Para fallos de entrega tras el lanzamiento, consulta fallos de entrega de webhooks.
Parte 1 — Planifica y crea
- Confirma que estás en el espacio de trabajo empresarial correcto.
[Screenshot: App header — correct business workspace selected.]
- Documenta qué eventos necesita tu automatización (venta aprobada, suscripción, etc.).
[Screenshot: Event plan — required webhook events listed.]
- Abre Integraciones → Webhooks → crear webhook.
[Screenshot: Create webhook — new webhook form opened.]
- Introduce la URL del endpoint HTTPS (accesible públicamente).
[Screenshot: Endpoint URL — valid HTTPS URL entered.]
- Selecciona eventos — prefiere eventos de venta aprobada sobre PIX generado solo.
[Screenshot: Event checkboxes — approved purchase events selected.]
- Guarda el webhook y anota el secreto de firma si se muestra. Consulta seguridad de webhooks.
[Screenshot: Webhook secret — signing key copied securely.]
Parte 2 — Prueba con simulador
- Abre el simulador del webhook para un tipo de evento seleccionado.
[Screenshot: Simulator — test event type chosen.]
- Envía el payload simulado al endpoint.
[Screenshot: Simulator send — test delivery triggered.]
- Abre los registros de entrega — confirma respuesta de éxito 2xx.
[Screenshot: Logs — simulator delivery success with 200 status.]
- Verifica que el sistema externo (Zapier, Make, API personalizada) recibió el payload.
[Screenshot: External system — test event received and parsed.]
- Si falló, corrige el endpoint antes de producción. Consulta Zapier/Make.
[Screenshot: Endpoint fix — error response resolved to 200.]
Parte 3 — Verificación en producción
- Ejecuta una compra de prueba segura en staging o con oferta de bajo valor.
[Screenshot: Test checkout — purchase completed for webhook test.]
- Confirma venta aprobada en Ventas.
[Screenshot: Sales — approved test sale for webhook trigger.]
- Revisa los registros del webhook para el intento de entrega en producción.
[Screenshot: Production log — real event delivered successfully.]
- Confirma que la automatización externa se ejecuta una vez (sin procesamiento duplicado).
[Screenshot: External automation — single execution for one sale.]
- Habilita alerta de monitoreo para entregas fallidas si está disponible.
[Screenshot: Monitoring — alert or log review scheduled.]
Hoja de referencia de selección de eventos
| Evento | ¿Seguro para entrega? |
|---|---|
| Venta aprobada | Sí |
| Solo PIX generado | No — no pagado |
| Carrito abandonado | Solo recuperación |
| Suscripción cancelada | Flujos de acceso |