Un webhook es una notificacion que se puede configurar para enviarse desde que sucede un evento específico. Se envía desde el sistema, en este caso Wisboo, a una URL https:// específica configurada por el usuario.
Los webhooks se usan comúnmente por las siguientes razones:
Integrar software de contabilidad
Notificar al equipo sobre ventas, refunds, chargebacks o clientes importantes
Sincronización de contactos con herramientas de CRM
Enviar emails personalizados después de una compra
Hacer upselling automáticamente después de una compra
Enviar datos a herramientas de analytics/BI para crear dashboards personalizados
Y más.
Consulta la documentación técnica
Consulta nuestra documentación técnica para conocer los eventos disponibles, la estructura de los datos y cómo autenticar e implementar tus Webhooks.
Eventos disponibles
Puedes seleccionar cualquiera de los eventos de la lista cuando creas un webhook. Por ejemplo, si quieres crear un webhook que se envíe cada vez que se registre una compra, utiliza el evento "product.sold". Otro ejemplo: si quieres crear un webhook que se envíe cada vez que un usuario termine un curso específico, utiliza el evento "course.completed".
Evento | Descripción |
product.sold | Se envía cuando sucede una venta en la tienda. Para los casos de Cuotas o Membresía, se registra un único evento por venta exitosa. |
payment.succeded | Se envía cuando sucede un pago en la tienda. Para los casos de Cuotas, se envía un evento por cada pago recibido. |
product.access_granted | Se envía cuando un usuario tiene acceso a un producto pago o gratis. Incluye la información del usuario, del producto y más. |
course.completed | Se envía cuando un usuario ha completado un curso, incluye toda la información del usuario, del curso, fecha, y más. |
user.created | Contiene toda la información de un usuario creado en la tienda, incluyendo nombre, correo, teléfono campos custom y más. |
¿No encuentras el webhook que estabas buscando?
Los webhooks es una funcionalidad que todavía está en fase de prueba y estamos agregando más Webhooks continuamente. Escríbenos a soporte@wisboo.com para proponernos tus webhooks.
Cómo crear un Webhook
Puedes crear un webhook en cualquier momento.
Pasos:
Accede a la administración de tu tienda y haz clic en la pestaña de "Configuración"
Selecciona la card de "Webhooks"
Posteriormente, después de ingresar en la página haz clic en el botón "+ Agregar Webhook"
El sistema mostrará un modal de creación del Webhook
Agrega el nombre del Webhook
En el campo URL, ingresa la URL donde quieres almacenar los datos. No se pueden entregar webhooks a las siguientes URL:
Localhost
Cualquier URL de un dominio personalizado asociado a la tienda
Dominios de ejemplo (como
www.ejemplo.com)
Selecciona los eventos que quieres que se envíen en este Webhook
Haz click en el botón de "Guardar y cerrar"
Editar Webhook
Puedes editar la configuración de un webhook después de crearlo.
Accede a la administración de tu tienda y haz clic en la pestaña de "Configuración"
Selecciona la card de "Webhooks" y accede al listado de Webhooks creados
En la fila del webhook que quieres editar, haz clic sobre cualquier lugar del webhook o en el menú de 3 puntos y luego en la opción de "Editar"
El sistema mostrará un modal de edición de tu webhook
Modifica los valores del webhook según sea necesario
Haz clic en el botón de "Guardar y cerrar"
Otras acciones relevantes
Desde el menú de opciones de cada Webhook puedes realizar las siguientes acciones:
Desactivar Webhook: pausa temporalmente el envío de eventos a la URL configurada. Puedes volver a activarlo cuando lo necesites, sin perder su configuración.
Copiar clave secreta: copia la clave secreta asociada al Webhook. Esta clave se utiliza para verificar que las solicitudes recibidas provienen de Wisboo y garantizar la autenticidad de los eventos.
Rotar o actualizar clave secreta: genera una nueva clave secreta para el Webhook. La clave anterior dejará de ser válida, por lo que deberás actualizarla también en la aplicación o servicio que recibe los Webhooks.
Eliminar Webhook: elimina permanentemente la configuración del Webhook. A partir de ese momento, Wisboo dejará de enviar eventos a la URL asociada. Esta acción no se puede deshacer.