Webhooks
Un webhook es un aviso automático. Cuando ocurre un evento en tu programa, IncentIA envía los datos a una dirección web tuya. Menú: Integraciones › Webhooks.
Para el formato de los avisos y la firma, consulta la documentación para desarrolladores.
Permiso Suscripciones webhook · Edición: Growth y Enterprise
Suscripciones a webhook
La pantalla se titula Suscripciones webhook. Arriba tienes un buscador (Buscar...) y Refrescar. Crear Nuevo abre el formulario.
| Columna | Qué es | Notas |
|---|---|---|
| Nombre | Nombre de la suscripción | |
| URL de Destino | Dirección que recibe el aviso | |
| Tipo de Evento | Qué evento dispara el aviso | Ver tabla de eventos |
| Activo | Si la suscripción envía avisos | |
| Fallos Consecutivos | Envíos seguidos que no llegaron | Vigílalo: indica que tu destino no responde |
Con Acciones puedes Editar o Eliminar cada suscripción.
Crear una suscripción
| Campo | Qué poner |
|---|---|
| Nombre | Un nombre que reconozcas |
| URL de Destino | La dirección de tu sistema que recibirá los avisos |
| Tipo de Evento | Un evento de la lista. Una suscripción escucha un evento |
| Secreto | Una clave tuya. Sirve para comprobar que el aviso viene de IncentIA |
| Activo | Marca la casilla para empezar a enviar |
Al editar, deja Secreto vacío para conservar el actual.
Eventos disponibles
Los nombres se ven en inglés en la lista.
| Evento | Cuándo se envía |
|---|---|
| MemberCreated | Se registra un socio |
| PointsEarned | Un socio gana puntos |
| PointsRedeemed | Un socio gasta puntos |
| TierChanged | Un socio cambia de nivel |
| RewardRedeemed | Un socio canjea una recompensa |
| CouponUsed | Se usa un cupón |
| PointsExpiring | A un socio le van a caducar puntos |
| GamePrizeWon | Un participante gana un premio en un juego |
Para escuchar varios eventos, crea una suscripción por evento.
Webhooks entrantes
Menú: Administración › Webhooks Entrantes. Es el registro de los avisos que recibe IncentIA de Shopify, WooCommerce, Stripe y los proveedores de evidencias.
La pantalla permite inspeccionar, reintentar y auditar cada entrega.
| Campo | Qué es |
|---|---|
| Fuente | Quién lo envió: Shopify, WooCommerce, Stripe, Evidence u Other |
| Estado | Received, Processing, Processed, Failed o Retrying |
| Ruta y Método HTTP | A qué dirección llegó |
| Recibido | Fecha y hora |
| Reintentos | Veces que se ha vuelto a procesar |
Filtra por Fuente, Estado y fechas (Desde, Hasta), y pulsa Buscar. Detalles abre el contenido de la entrega. En las entregas de tiendas, los datos personales del comprador se ocultan.
Si una entrega falló, Reenviar la vuelve a procesar. Pide confirmación. La entrega se encola y verás el resultado al refrescar.
Si un pedido de tu tienda no dio puntos, busca su entrega aquí y abre Detalles. Comprueba si llegó y en qué estado quedó.
Permisos
| Acción | Permiso (texto UI) | Id técnico |
|---|---|---|
| Ver suscripciones | Suscripciones webhook | Pages.Loyalty.Webhooks |
| Crear | Creando suscripción webhook | Pages.Loyalty.Webhooks.Create |
| Editar | Editando suscripción webhook | Pages.Loyalty.Webhooks.Edit |
| Eliminar | Eliminando suscripción webhook | Pages.Loyalty.Webhooks.Delete |
| Ver webhooks entrantes | Webhooks Entrantes | Pages.Administration.IncomingWebhooks |
| Reenviar una entrega | Reenviar Webhook | Pages.Administration.IncomingWebhooks.Replay |