Conectar WooCommerce

Haz que cada pedido de tu tienda WooCommerce sume puntos al socio que lo hizo. Dura unos 20 minutos y necesitas acceso de administrador a WordPress.

Antes de empezar

• Permisos: Integraciones, Creando integración y Editando integración.
• Un programa de puntos con una regla de acumulación por compra.
• Los clientes ya son socios del programa y usan en la tienda el mismo email o teléfono de facturación. Si no hay socio, el pedido se omite.

1. Crea el conector

Ve a Integraciones › Conectores y pulsa Crear Nuevo.

1. Escribe un Nombre, por ejemplo «Tienda WooCommerce».
2. Elige Tipo de integración › ECommerce y Proveedor › WooCommerce.
3. En Secreto de API, escribe una cadena larga y aleatoria. La repetirás en WooCommerce.
4. En Programa de Lealtad, elige el programa que recibe los puntos.
5. Marca Activo y pulsa Guardar.

Programa y secreto

Sin Programa de Lealtad, los pedidos se omiten. Sin Secreto de API, IncentIA rechaza todos los avisos.

2. Averigua la dirección del aviso

La pantalla no muestra la dirección a la que WooCommerce debe avisar. Tiene esta forma:

https://<dirección de IncentIA>/api/webhooks/woocommerce/<número del conector>

Pide a soporte la dirección de tu cuenta y el número del conector que acabas de crear.

3. Crea el webhook en WooCommerce

En WordPress, ve a WooCommerce › Ajustes › Avanzado › Webhooks y pulsa Añadir webhook.

1. Estado: Activo.
2. Tema: order.updated (Pedido actualizado). Un webhook con order.completed también suma, pero no cubre reembolsos ni cancelaciones.
3. URL de entrega: la dirección del paso 2.
4. Secreto: el mismo texto que pusiste en Secreto de API.
5. Guarda.

Con order.updated, IncentIA decide según el estado del pedido:

Pedido en WooCommerce	Qué hace IncentIA
Completado o en proceso	Suma los puntos
Cancelado o fallido	Descuenta los puntos que dio
Reembolso total	Descuenta todos los puntos del pedido
Reembolso parcial	Descuenta en proporción al importe devuelto
Pedido eliminado	Descuenta los puntos que dio. Necesita otro webhook con tema order.deleted

Un aviso repetido no duplica puntos.

4. Prueba con un pedido

1. Haz un pedido de prueba con el email de un socio y márcalo como completado.
2. Abre Administración › Webhooks Entrantes y filtra Fuente › WooCommerce. Debe aparecer el aviso.
3. Abre la ficha del socio: tiene los puntos del pedido.

Comprueba que funciona

• El aviso figura como procesado en Administración › Webhooks Entrantes.
• Un reembolso de prueba descuenta los puntos del socio.
• En Integraciones › Conectores, el conector está Activo.

Si algo falla

Síntoma	Causa probable	Qué hacer
WooCommerce marca la entrega como fallida	Dirección o secreto incorrectos, o conector inactivo	Revisa los pasos 1 y 2; el secreto debe ser idéntico en ambos lados
El pedido se omite	No hay socio activo con ese email o teléfono de facturación	Pide a tu cliente que use el mismo email que en el programa
El pedido se omite sin puntos	El conector no tiene Programa de Lealtad	Edítalo y elige uno
No suma un pedido pendiente de pago	Solo suman los pedidos completados o en proceso	Espera a que cambie de estado

Siguientes pasos

• Conectar Shopify, si tienes otra tienda.
• Montar un programa de puntos
• Referencia: Conectores de eCommerce · Webhooks