La integración vía Webhook permite que tu plataforma envíe automáticamente datos y eventos a otro sistema externo en tiempo real.
Al configurar un Webhook, cada vez que ocurra un evento —como una compra, cancelación, suscripción o cualquier otro evento definido— se enviará una notificación con los detalles a la dirección que tú especifiques.
A continuación te mostramos cómo configurar esta integración paso a paso.
1. ¿Qué es un Webhook?
Un Webhook es una forma de que una aplicación envíe información a otra aplicación cuando ocurre un evento específico.
A diferencia de una API tradicional, el Webhook empuja la información cuando sucede, sin que tengas que consultarla manualmente.
2. ¿Para qué sirve la integración vía Webhook?
La integración vía Webhook se utiliza para:
✔ Sincronizar información con otros sistemas en tiempo real.
✔ Notificar a tu CRM, sistema de afiliados, servicio de facturación o cualquier otro sistema cuando ocurre un evento.
✔ Automatizar procesos sin intervención manual.
✔ Reducir errores de duplicación o falta de datos entre plataformas.
3. Ejemplos de eventos que pueden enviarse vía Webhook
Puedes configurar Webhooks para eventos como:
-
Compra completada
-
Venta aprobada
-
Subscripción creada
-
Suscripción cancelada
-
Reembolso emitido
-
Lead creado
-
Cualquier otro evento que la plataforma soporte
4. Accede a la configuración de Webhooks
-
Inicia sesión en tu cuenta de la plataforma con tu correo electrónico y contraseña.
-
En el menú lateral, selecciona Integraciones.
-
Busca la opción Webhooks o Integración vía Webhook.
5. Crea un nuevo Webhook
Dentro de la sección de Webhooks:
-
Haz clic en Agregar Webhook o Crear nuevo.
-
Se abrirá un formulario donde podrás configurar las propiedades del Webhook.
6. Completa los datos del Webhook
URL de destino
En el campo correspondiente, ingresa la URL de tu servidor o servicio externo donde deseas recibir las notificaciones.
Esta URL debe ser capaz de recibir solicitudes HTTP POST con los datos del evento.
Nombre del Webhook
Escribe un nombre descriptivo para identificar este Webhook dentro de tu panel (por ejemplo: “Notificaciones de venta a CRM”).
Eventos a enviar
Selecciona los eventos que deseas que desencadenen el envío del Webhook.
Puedes elegir uno o varios según tus necesidades.
Ejemplos:
-
Venta aprobada
-
Compra completada
-
Reembolso emitido
Método de envío
Normalmente se utiliza POST para enviar los datos en el cuerpo de la solicitud.
Formato de datos
Generalmente el Webhook enviará la información en formato JSON.
Asegúrate de que tu sistema receptor pueda interpretar este formato.
7. Guardar la configuración
Una vez que hayas completado los campos:
-
Revisa que la URL de destino esté correctamente escrita.
-
Verifica que los eventos seleccionados sean los correctos.
-
Haz clic en Guardar para finalizar la creación del Webhook.
8. Cómo se envían los datos
Una vez configurado el Webhook:
✔ Cada vez que ocurra uno de los eventos seleccionados, la plataforma enviará un request HTTP POST a la URL de destino.
✔ Ese request contendrá un payload en JSON con los detalles del evento (como datos del comprador, producto, monto, estado, etc.).
✔ El sistema receptor deberá leer ese JSON y procesarlo según la lógica que hayas definido (por ejemplo, registrar la venta, generar notificaciones, actualizar un CRM, etc.).
9. Verificación y pruebas
Antes de poner en producción tu Webhook:
-
Realiza pruebas enviando eventos desde la plataforma para asegurarte de que tu sistema los recibe correctamente.
-
Verifica que los datos en el JSON sean los que tu sistema está esperando.
-
Asegúrate de que no haya errores de conexión o interpretación de datos.
10. Manejo de fallos
Si tu servidor no responde correctamente al Webhook (por ejemplo, devuelve un error 500 o no responde):
-
La plataforma puede intentar reenviar varias veces, dependiendo de su política interna.
-
Asegúrate de que tu URL de destino esté disponible y preparada para recibir múltiples solicitudes en poco tiempo.
-
Implementa respuestas con códigos HTTP adecuados para indicar que el mensaje fue recibido correctamente (por ejemplo: 200 OK).
11. Consejos para aprovechar al máximo los Webhooks
✔ Utiliza URLs seguras (HTTPS) para proteger los datos.
✔ Valida la integridad de las solicitudes usando firmas o tokens si tu sistema lo permite.
✔ Monitorea los logs de tu sistema para verificar que no haya errores de recepción.
✔ Documenta qué eventos estás escuchando y qué acciones se disparan para cada uno.
12. Soporte y ayuda
Si tienes dificultades con la configuración del Webhook o necesitas ayuda para interpretar los datos que se envían, el equipo de soporte de la plataforma está disponible para asistirte paso a paso.