Conectar Shopify
Haz que cada pedido pagado en tu tienda Shopify sume puntos al socio que lo hizo. Dura unos 20 minutos y necesitas acceso de administrador a Shopify.
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. Si no hay socio, el pedido se omite.
1. Crea el conector
Ve a Integraciones › Conectores y pulsa Crear Nuevo.
- Escribe un Nombre, por ejemplo «Tienda online».
- Elige Tipo de integración › ECommerce y Proveedor › Shopify.
- En Secreto de API, pon el secreto con el que Shopify firma los avisos. IncentIA lo usa para comprobar que el pedido viene de tu tienda.
- En Programa de Lealtad, elige el programa que recibe los puntos.
- 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 Shopify debe avisar. Tiene esta forma:
https://<dirección de IncentIA>/api/webhooks/shopify/<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 aviso en Shopify
En el administrador de Shopify, ve a Settings › Notifications › Webhooks y crea un webhook por cada evento de la tabla. Usa formato JSON y la dirección del paso 2.
| Evento en Shopify | Qué hace IncentIA |
|---|---|
orders/paid | Suma los puntos del pedido |
orders/cancelled | Descuenta los puntos que dio |
refunds/create | Descuenta los puntos en proporción al importe devuelto |
IncentIA ignora cualquier otro evento. Un aviso repetido no duplica puntos.
4. Prueba con un pedido
- Haz un pedido de prueba en Shopify con el email de un socio y págalo.
- Abre Administración › Webhooks Entrantes y filtra Fuente › Shopify. Debe aparecer el aviso.
- Abre la ficha del socio: tiene los puntos del pedido.
Comprueba que funciona
- El aviso figura como procesado en Administración › Webhooks Entrantes.
- El socio ve los puntos en su portal.
- En Integraciones › Conectores, el conector está Activo.
Si algo falla
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| El aviso no aparece en Webhooks Entrantes | Dirección incorrecta o conector inactivo | Revisa el paso 2 y que Activo esté marcado |
| El aviso se rechaza | Secreto de API distinto del de Shopify | Copia de nuevo el secreto y guarda el conector |
| El pedido se omite | No hay socio activo con ese email o teléfono | 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 |
Siguientes pasos
- Conectar WooCommerce, si tienes otra tienda.
- Importar e invitar socios para que tus clientes ya estén en el programa.
- Referencia: Conectores de eCommerce · Webhooks