¿Cómo configuro la API de mi producto usando el Webhook (Postback)?

Si quieres automatizar acciones importantes en tu negocio digital, como liberar el acceso a un curso en cuanto se aprueba una compra, configurar tu API por medio del Webhook es una excelente opción.

En este artículo, te explicamos qué es el Webhook, cómo configurar tus notificaciones automáticas de acuerdo con eventos de compra, dónde seguir los envíos realizados, además de cómo probar la integración para asegurarte de que todo funcione correctamente.

¿Qué es el Webhook de Hotmart?

El Webhook es una herramienta de Hotmart que permite integrar tu API para recibir notificaciones automáticas cada vez que se actualiza el estado de una transacción. En otras palabras, configuras una URL y, cada vez que ocurre un evento (como una venta aprobada, un reembolso o la cancelación de una suscripción), Hotmart envía una notificación a esa URL.

Esta funcionalidad es muy útil, por ejemplo, si ofreces tu producto en un área de miembros externa y deseas liberar el acceso del comprador de forma automática tras la confirmación del pago.

¿Cómo configurar el Webhook?

La configuración es sencilla y puedes personalizar todo según los eventos que tengan más sentido para tu negocio. Para eso, solo sigue los pasos indicados a continuación:

1. Accede a tu cuenta desde el enlace: https://app.hotmart.com/login. 
2. En el menú lateral izquierdo, haz clic en Herramientas y luego en Mostrar todas.
3. Selecciona la opción Webhook (API y notificaciones) o búscala directamente en la barra de búsqueda de la página.
4. Haz clic en + Registrar Webhook para iniciar una nueva configuración.
5. Crea la nueva configuración. Ingresa el nombre de la segmentación y marca los eventos que desees.
6. A continuación, elige si deseas que la segmentación incluya todos los productos o solo un producto específico, e ingresa la URL de envío.
   • Nota: Si la URL registrada presenta algún error, Hotmart desactivará automáticamente la configuración para evitar el envío de notificaciones incorrectas.
7. Haz clic en Guardar.

Puedes crear todas las configuraciones que desees, editarlas, desactivarlas o eliminarlas de la lista. Para hacerlo, solo debes seleccionar el botón correspondiente a la acción en el lateral derecha de la configuración.

❯ ¿Qué eventos puedo seguir con el Webhook?

Al configurar el Webhook, puedes elegir entre los siguientes eventos:

• Para compras: compra cancelada, compra completada, a la espera de pago, compra aprobada, compra reembolsada, chargeback, compra con plazo vencido, pedido de reembolso, compra atrasada.
• Para suscripciones: cancelación de suscripción, cambio de plan, actualización de fecha de cobro de la suscripción.
• Para Club: primer acceso, módulo completo.
• Otros: abandono de carrito.

Tip: Aprovecha estos eventos para crear segmentaciones que beneficien tu negocio.  Por ejemplo, una segmentación para recuperación de ventas, seleccionando eventos como solicitud de reembolso, contracargo, suscripciones atrasadas, etc.

Para más información sobre el uso de Webhooks y APIs para optimizar los procesos de tu negocio, consulta esta página.

¿Cómo sigo el historial de notificaciones enviadas?

En el propio menú del Webhook encontrarás la pestaña Historial, donde puedes ver todos los envíos realizados, su estado e incluso el contenido de cada notificación.

Las notificaciones con error se reintentan automáticamente hasta cinco veces o hasta recibir una respuesta exitosa del servidor. También puedes reenviarlas manualmente haciendo clic en el ícono de flecha en la columna Acciones.

Además, puedes consultar el Payload (contenido de la notificación enviada) y el Historial de respuestas, que muestra la respuesta de tu URL a cada evento. Para eso, haz clic en el ícono de lupa ubicado en la columna Acciones.

Importante: Si ya usabas el Webhook (Postback) antes de alguna actualización, aún puedes consultar las notificaciones anteriores. Solo accede a las pestañas Posts enviados o Posts pendientes.
Los eventos se almacenan y se muestran en el historial durante un máximo de 60 días.

Preguntas frecuentes

❯ ¿Puedo probar si el Webhook está funcionando?

¡Sí! Hotmart permite realizar pruebas de envío para verificar si la integración funciona correctamente.

Para eso, accede a la pantalla de Webhook, ve a la pestaña Mis configuraciones y haz clic en el ícono de lista, ubicado a la derecha de la configuración que quieres probar. Allí, podrás ejecutar una prueba de envío y confirmar si la URL configurada está recibiendo correctamente las notificaciones.