Integraciones y webhooks
Dos pantallas resuelven casi todo: Administración › Webhooks Entrantes (lo que recibe IncentIA) y Integraciones › Webhooks (lo que envía a tu sistema).
Pedidos de tu tienda que no dan puntos
Busca primero la entrega en Administración › Webhooks Entrantes: filtra por Fuente (Shopify o WooCommerce) y abre Detalles.
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| El aviso no aparece en Webhooks Entrantes | Dirección mal copiada en la tienda, o conector inactivo | Revisa la dirección en la tienda y que el conector esté Activo en Integraciones › Conectores |
| El aviso aparece rechazado | Secreto de API distinto del de la tienda | Copia de nuevo el secreto, igual en ambos lados, y guarda el conector |
| El pedido se omite y no suma | El conector no tiene Programa de Lealtad | Edita el conector y elige uno |
| El pedido se omite | No hay socio activo con ese email o teléfono | El cliente debe usar el mismo email que en el programa. Mira Importar e invitar socios |
| Estado Failed | Hubo un error al procesar | Pulsa Reenviar (permiso Reenviar Webhook) y refresca |
| Estado de Sincronización: Falló | La última sincronización del conector no terminó bien | Revisa los datos del conector y vuelve a guardarlo |
| NeverSynced (sin traducir) | Aún no hay sincronización | Es normal en un conector recién creado |
Guías paso a paso: Conectar Shopify · Conectar WooCommerce.
Webhooks salientes que no llegan a tu sistema
Mira Fallos Consecutivos en Integraciones › Webhooks.
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Fallos Consecutivos sube | Tu destino no responde 2xx en 30 segundos | Responde 200 enseguida y procesa en segundo plano |
| La suscripción deja de enviar (Activo desmarcado) | Se desactiva sola tras 10 fallos seguidos, o 50 respuestas de saturación seguidas | Arregla el destino, edita la suscripción y marca Activo |
El destino devuelve 3xx | IncentIA no sigue redirecciones | Pon en URL de Destino la dirección final |
| La suscripción se rechaza | La URL no es pública (dirección interna) | Usa una URL accesible desde internet |
| No llega un evento que esperabas | Una suscripción escucha un solo Tipo de Evento | Crea una suscripción por evento |
| Tu sistema rechaza la firma | Secreto distinto o verificación mal hecha | Mira Webhooks: formato y firma. Al editar, Secreto vacío conserva el actual |
Otras integraciones
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Tu plataforma no es Shopify ni WooCommerce | No hay conector nativo | Usa la API pública o los webhooks |
| El OCR no lee tickets | Proveedor o clave mal configurados | Mira Evidencias y OCR |
| Un socio pagó una membresía y no la ve | El aviso de Stripe no se procesó, o falta la configuración de Stripe en la plataforma | Busca el cobro en Webhooks Entrantes con Fuente Stripe. Mira Pagos (Stripe) |