Configurar la integración con Shopify
Con la integración de Shopify, tu agente IA lee datos en vivo de tu tienda Shopify. Los clientes que preguntan "¿dónde está mi pedido?", "¿todavía está en stock?" o "¿está aprobada mi devolución?" reciben una respuesta al instante, en lenguaje natural, 24/7.
En resumen
Heyloha se conecta a tu tienda Shopify mediante una custom app. Tú mismo lo configuras en 5 minutos desde el panel de Heyloha. Solo lectura, cifrado, sin código.
Lo que tu agente puede hacer
- Consultar el estado de un pedido. El agente busca un pedido por número y responde con los detalles de envío y seguimiento.
- Buscar productos. El agente revisa tu catálogo por palabra clave, marca o tipo y devuelve hasta 10 resultados con precio y disponibilidad.
- Comprobar stock. El agente obtiene los stocks en vivo por variante. Si hay poco stock, dice "quedan pocos" en lugar de un número exacto.
- Reportar el estado de una devolución. El agente busca devoluciones asociadas a un pedido y reporta el estado en lenguaje natural.
Las cuatro capacidades son de solo lectura. El agente no puede modificar pedidos, cancelar nada ni cambiar stock.
Lo que necesitas
- Una cuenta de Heyloha con al menos un agente IA creado.
- Acceso de administrador a tu tienda Shopify, específicamente la capacidad de crear custom apps.
- Unos 5 minutos.
No hace falta desarrollador, cuenta de Shopify Partner ni código. El flujo de custom app funciona en cualquier plan de Shopify.
Conectar Shopify
Abre los ajustes de Shopify en Heyloha
En el panel de Heyloha haz clic en Ajustes en el menú de la izquierda. Dentro de Sistemas externos haz clic en Shopify. Verás una tarjeta por sitio web. Pulsa "Conectar Shopify" en el sitio que quieras enlazar.
Permite el desarrollo de custom apps (tiendas nuevas)
Las tiendas creadas desde 2026 tienen el desarrollo de custom apps deshabilitado por defecto. En el admin de Shopify ve a Ajustes → Apps y canales de venta → Desarrollar apps. Si ves un botón "Permitir desarrollo de custom apps", haz clic y confirma.
Crea la custom app en Shopify
Ve a Ajustes → Apps y canales de venta → Desarrollar apps y haz clic en "Crear una app". Dale un nombre reconocible, por ejemplo "Heyloha".
Configura los scopes de Admin API
Haz clic en la pestaña Configuración y después en Configurar junto a Admin API integration. Marca exactamente estos cuatro scopes: read_orders, read_products, read_inventory y read_returns. Guarda.
Instala la app y copia el token
Ve a la pestaña API credentials y haz clic en "Instalar app" en la parte superior. Aparece el token de Admin API (empieza con shpat_ seguido de 32 caracteres). Cópialo de inmediato: Shopify solo lo muestra una vez.
Pega dominio y token en Heyloha
En la ventana de Heyloha pega tu dominio de tienda (siempre termina en .myshopify.com, incluso con dominio personalizado) y el token de Admin API. Haz clic en Conectar. La tarjeta pasa a Conectada con tu dominio y la fecha.
¿Olvidaste copiar el token? Shopify solo lo muestra una vez. Tendrás que desinstalar y reinstalar la app para obtener uno nuevo.
¿Funciona?
Para comprobar que la conexión funciona:
- Abre el widget de chat de Heyloha en tu web (u otro canal).
- Haz una pregunta tipo "¿Vendéis [producto conocido]?". El agente debería devolver productos con precio y disponibilidad.
- Pregunta por el estado de uno de tus pedidos (por ejemplo "¿dónde está el pedido #1001?"). El agente responde o pide primero el email del cliente, según tu política de verificación.
¿El agente sigue diciendo "alguien se pondrá en contacto" tras conectar? Probablemente falte un scope o el token sea incorrecto. Ve a Solución de problemas más abajo.
Gestionar la conexión
Pausar
Desactiva el interruptor Activo en la tarjeta. El agente deja de llamar a Shopify para este sitio web al instante. No más consultas de pedidos, no más búsquedas de productos. Volver a activarlo es un clic, sin reconexión.
Rotar el token
En la tarjeta conectada haz clic en el menú de tres puntos y elige "Rotar token". Genera un nuevo token de Admin API en Shopify (misma app, pestaña API credentials) y pégalo. El nuevo sustituye al antiguo en Heyloha sin interrupción.
Hazlo si el token antiguo se compartió por error, si un compañero reinstaló la app, o si una auditoría de seguridad exige rotación periódica.
Desconectar
En el menú de tres puntos elige Desconectar. Heyloha pide confirmación y lista lo que el agente perderá: estado de pedidos, búsqueda de productos, comprobación de stock y estado de devoluciones. Tras confirmar, el token se elimina definitivamente.
Seguridad
- El token de Admin API se almacena cifrado (AES-256). La clave vive fuera de la base de datos.
- El token nunca aparece en respuestas de API, logs ni mensajes de error. Ante un 401, Heyloha registra "auth fallida para integración X", no el token.
- El agente solo puede leer: sin cambios en pedidos, stock o productos.
- Aislado por sitio web. Un agente para la tienda A literalmente no puede ver datos de la tienda B. Se comprueba en cada llamada.
Solución de problemas
"Permitir desarrollo de custom apps" no aparece en Shopify
Tu rol en Shopify no tiene el permiso "Desarrollar apps". El propietario (u otro admin con permisos completos) debe activarlo una vez, o conceder el permiso a tu cuenta.
"El dominio debe terminar en .myshopify.com"
Pegaste un dominio personalizado (por ejemplo www.acme.com) en vez del dominio interno de Shopify (acme.myshopify.com). Encuentra el dominio interno en Shopify admin → Ajustes → Dominios bajo "Gestionados por Shopify".
"Esto no parece un token de Shopify válido"
El token debe empezar por shpat_ seguido de 32 caracteres hexadecimales. Errores frecuentes: copiar el API key o API secret en vez del token de Admin API, copiar espacios alrededor, o usar un token de Storefront API.
El agente sigue diciendo "alguien se pondrá en contacto"
Causas posibles: la conexión está desactivada (mira la tarjeta), falta un scope (ve el banner), o el token fue revocado en Shopify. Reinstala la app, copia el nuevo token y usa "Rotar token" en Heyloha.
Preguntas frecuentes
¿Funciona en todos los planes de Shopify?
Sí. El flujo de custom app está disponible en todos los planes de Shopify, incluidos Basic, Advanced, Plus y pruebas gratuitas.
¿Puede el agente modificar pedidos?
Todavía no. Las cuatro capacidades son de solo lectura. Las acciones de escritura como cancelar o reembolsar no se han lanzado a propósito: requieren flujos de verificación de cliente más sólidos.
¿Mis clientes verán "Shopify" en el chat?
No. El agente responde en lenguaje natural sin mencionar el sistema que hay detrás. Dice "tu pedido se envió con DHL", no "según Shopify, tu pedido...".
Configurar integraciones CRM y webhookConfigurar la integración con HubSpot