Webhook es la herramienta de API y notificaciones de Hotmart. Al utilizarla, es posible recibir las notificaciones a través de la dirección URL(s) registrada(s) por el(la) Productor(a) en la plataforma Hotmart, de acuerdo con la actualización del estado de una transacción.
Por ejemplo, si un productor dispone el contenido de su producto en un área de miembros externa, Webhook permite el desbloqueo del acceso del cliente al producto una vez que la transacción asuma el estado de "compra aprobada".
Conoce los recursos que están a disposición del productor que decide entregar su acceso utilizando notificación POST y cómo configurarlos:
Adición de nuevas configuraciones
- Accede a tu cuenta en Hotmart a través de https://app.hotmart.com/login;
- En el menú superior derecho, haz clic en Navega y selecciona Herramientas;
- Haz clic en Webhook;
- En la nueva pantalla puedes añadir tus configuraciones en +Register Webhook;
- Formata la nueva configuración. En esta pantalla debes introducir el nombre de tu segmentación y marcar los eventos deseados;
Los eventos disponibles son: compra cancelada, compra finalizada, pago en efectivo impreso, compra aprobada, pedido de reembolso, compra reembolsada, chargeback, compra expirada y compra atrasada.
A continuación elige si deseas que la segmentación cubra todos los productos o solo un producto específico e introduce la dirección URL de envío.
Sugerencia: Puedes explorar estos eventos con el fin de crear segmentaciones importantes para tu negocio. Un ejemplo sería llevar a cabo una segmentación para la recuperación de ventas, seleccionando solicitudes de reembolso, devoluciones de cargo, suscripciones retrasadas, etc.
Sugerencia para baloto y oxxo: Con el webhook, también puedes permitir que tu afiliado reciba una notificación que contenga el enlace y código del ticket de pago en efectivo cada vez que se hace una compra por su Hotlink. Atención: Para que la notificación sea enviada, es necesario que permitas que el afiliado tenga acceso a los datos del comprador. Mira cómo hacerlo aquí.
- Haz clic en Guardar.
Puede crear tantas configuraciones como desees, editarlas, desactivarlas o eliminarlas de tu lista. Para ello, basta con seleccionar el botón correspondiente a la acción en el lateral derecho de la configuración
NOTA: Si la URL insertada contiene algún error, la configuración se desactivará automáticamente para que no sean enviadas nuevas notificaciones de manera innecesaria.
Cómo crear la integración
Dentro del menú Webhook encontrarás toda la documentación necesaria para configurar tu integración.
Solo tienes que hacer clic en la pestaña Documentación y consultar los parámetros utilizados para generar las notificaciones. Ahora encontrarás las siguientes informaciones:
- nombre del parámetro
- si la información se envía o no al afiliado
- descripción y explicación del parámetro
- formato y tamaño
En esta pestaña, también puede encontrar el token de verificación y seguridad.
Atención: Para efectuar esta integración te recomendamos que pidas ayuda a un programador o que tengas conocimientos en programación, ¿ok?
Siguiendo el envío de posts
En el menú Webhook, encontrarás la pestaña Historial. En ella puedes monitorear todos los envíos realizados y el estado.
Los mensajes que presenten error serán reprocesados hasta que tengan una respuesta positiva del servidor o completen 5 intentos. Si deseas procesarlo de nuevo, simplemente haz clic en el botón con una flecha al lado del status de la publicación.
El estatus siempre será indicado por los códigos HTTP.
En la pestaña Historial, también puedes ver el Payload enviado (cada notificación enviada) y el historial de respuestas a la notificación. Es decir, la carga de información relevante que se envió en aquel evento y cuál fue la respuesta del sistema notificado, además de tener las acciones pasadas registradas.
Comprueba dónde puedes encontrar el Historial de Responses:
Atención: si ya utilizabas Webhook (Postback) antes de la actualización, podrás consultar los posts enviados antes de la actualización de la herramienta. Para ello, haz clic en las pestañas Posts Enviados o Posts Pendientes
Envío de teste de post
Puedes realizar pruebas para verificar el funcionamiento correcto de la integración mediante eventos de pruebas en el producto y en la URL seleccionadas.
Cómo configurar la integración usando Zapier
Conoce el paso a paso para configurar la integración usando Zapier:
- Para dar inicio en la configuración de Zapier, accede a https://app.hotmart.com/ y selecciona Zapier;
- Entonces, serás encaminado a la plataforma de Zapier. En ella, haz clic en Accept Invite and Build a Zap;
- En la plataforma de Zapier, busca “Make a zap” y selecciona la app Hotmart (1.0.0);
- Selecciona el evento. Los eventos disponibles para su integración son: solicitud, abandono de carrito, cambio de plan y cancelación de suscripción.
En la plataforma de Hotmart, en Herramientas, busca WebHook (API y Notificaciones), y en la pestaña de documentación constarán los detalles de cada atributo de los eventos.
- Selecciona Cuenta Hotmart (1.0.0) y haz clic en continuar.
- Acepta que Zapier acceda a tus datos de Hotmart.
Obs.: El campo “connection name” es apenas un identificador de la conexión Hotmart en la app de Zapier.
Ejemplo:
Por medio de imágenes. Conoce un ejemplo de configuración “ZAP” con Hotmart y Matrix LMS utilizando Action Find User (Matrix LMS).