Conector de Shopify
Funciona con Shopify
Conecta Shopify a FreeScout para que las conversaciones muestren pedidos de clientes coincidentes y contexto de compra. Creas una app personalizada de solo lectura en tu administrador de Shopify y pegas su token de acceso en FreeScout, así que no hay cuenta de Partner ni revisión de app de por medio. ReplyRabbit también alimenta el contexto de propiedad de productos en la capa de IA para que los borradores puedan referenciar lo que ha comprado un cliente.
¿Buscas la descripción general?
Resumen
El conector de Shopify añade una barra lateral de pedido a las conversaciones de FreeScout. Cuando una conversación tiene una dirección de correo del cliente, el conector consulta la API de administración GraphQL de Shopify en tu tienda para encontrar pedidos coincidentes y los muestra junto a la conversación.
La barra lateral muestra un panel del cliente, el historial completo de pedidos, los artículos de cada pedido con cantidades y precios, los totales financieros, el valor de vida del cliente (CLV), el valor medio del pedido (AOV) y la titularidad de productos que fluye al contexto de ReplyRabbit AI para borradores más relevantes.
Hay un componente que instalar: el Módulo conector de Shopify para FreeScout. Lee la API de administración GraphQL de Shopify por HTTPS usando un token de acceso de la API de administración de una aplicación personalizada y luego muestra la barra lateral del pedido. Tiene su propia página de configuración por buzón en FreeScout.
La barra lateral de pedidos funciona por sí sola. El derecho de propiedad de productos que fluye a los borradores de IA es la parte que usa ReplyRabbit.
Requisitos previos
Antes de empezar, asegúrate de tener:
- Una instalación de FreeScout en funcionamiento.
- Una tienda Shopify en un
your-store.myshopify.comdominio (o un dominio personalizado que apunte a uno), con permisos de personal para desarrollar apps. - ReplyRabbit instalado y activado si quieres contexto de propiedad de productos en los borradores de IA.
- Una licencia de Shopify Connector (18 EUR pago único, para una instalación de FreeScout), o un plan ReplyRabbit Pro o Team activo, que la incluye.
Si ReplyRabbit aún no está instalado, empieza con Cómo instalar el módulo de ReplyRabbit, luego completa Cómo configurar ReplyRabbit.
Crear una app personalizada en Shopify
El conector se autentica con un token de acceso de la API de administración de una app personalizada que reside en tu propia tienda.
Abrir Desarrollar apps
En el administrador de Shopify, ve a Configuración, luego Aplicaciones y canales de venta, luego Desarrollar aplicaciones. Si se te solicita, permite el desarrollo de aplicaciones personalizadas.Crear la app
Hacer clic Crear una app, ponle el nombre "ReplyRabbit Connector" y créala.Configura los ámbitos de la API de administración
Abrir Configurar los ámbitos de la API de administración y marcaread_customers,read_orders, yread_products. Marcaread_all_orderstambién si quieres historial de pedidos de más de 60 días. Guarda.Instala y copia el token
Hacer clic Instalar app, luego Revelar token una vez y copia el Token de acceso de la API de administrador (empieza porshpat_). Shopify solo lo muestra una vez, así que guárdalo en un lugar seguro.
Acceso de solo lectura
Instala el módulo conector de FreeScout
Descargar el módulo conector
Descargue el ZIP del módulo conector de FreeScout desde el Panel de ReplyRabbit. La descarga aparece una vez que hayas comprado el conector o tengas un plan ReplyRabbit Pro o Team activo.Subir a FreeScout
En FreeScout, ve a Módulos, haz clic en el botón de subida, elige el ZIP e instálalo.Activa el módulo
Activa el Integración con Shopify módulo desde la lista de Módulos.
Configurar por buzón
Abre los ajustes del conector
En FreeScout, abre el buzón que debe mostrar los datos de pedidos de Shopify, abre el menú de configuración del buzón y elige Conector de tienda. Esta es la página de configuración del conector de Shopify, no una sección dentro de los ajustes de ReplyRabbit.Introduce el dominio de la tienda y el token de acceso
Introduce el dominio de tu tienda, por ejemployour-store.myshopify.com, y pega el token de acceso de la API de administración. Guarda. El conector comprueba el token y los permisos contra tu tienda antes de almacenarlo; el token se almacena cifrado y nunca se vuelve a mostrar.Añade tu clave de licencia del conector
Si compraste el conector, configuraSHOPIFYINTEGRATION_LICENSE_KEYen tu FreeScout.enva su clave de licencia. Omite este paso si un plan activo de ReplyRabbit Pro o Team cubre la instalación.Probar
Abre una conversación de FreeScout donde el correo del cliente coincida con un pedido de Shopify y confirma que aparece la barra lateral del pedido.
Cada buzón de FreeScout almacena su propio dominio de tienda y token de acceso, por lo que puede conectar diferentes buzones a diferentes tiendas.
Qué muestra el conector
- Un panel de cliente para la persona en la conversación.
- Historial completo de pedidos con número de pedido, fecha, estado y total.
- Líneas de pedido por pedido con cantidades y precios.
- Totales financieros (subtotal, descuento, envío, impuestos, reembolsos).
- Valor de vida del cliente (CLV) y valor promedio del pedido (AOV).
- Derecho de propiedad del producto para borradores de IA.
Cómo obtener el conector
El Conector de Shopify es un módulo de pago. Puedes obtenerlo de dos formas:
- Compra el Conector de Shopify por 18 EUR como licencia única para una instalación de FreeScout, luego configura su clave de licencia como
SHOPIFYINTEGRATION_LICENSE_KEYen el FreeScout.env. - Usa un plan activo de ReplyRabbit Pro o Team, que incluye el conector sin coste adicional.
Compra la licencia o descarga el conector desde tu Panel de ReplyRabbit. Visita la página de precios para las opciones de plan de ReplyRabbit. Si un plan activo de ReplyRabbit Pro o Team cubre la instalación, el conector funciona una vez configurado, sin necesidad de una clave de licencia aparte.
Resolución de problemas
| Síntoma | Qué comprobar |
|---|---|
| "Shopify rechazó la conexión" al guardar | El token se escribió mal, se revocó o pertenece a otra tienda. Revela un token nuevo reinstalando la aplicación personalizada y pégalo de nuevo. |
| "Faltan estos permisos de la API de administración" al guardar | Abre la app personalizada, añade los scopes que faltan en Configurar los ámbitos de la API de administración, guarda y vuelve a instalar la aplicación. Reinstalar emite un nuevo token. |
| El dominio de la tienda es rechazado | Usa el your-store.myshopify.com dominio, o un dominio personalizado que apunte a él. Los hosts privados y las direcciones IP se rechazan. |
| La barra lateral de pedido no aparece | Confirmar que el panel del buzón está habilitado y que la conexión aparece como conectada en la página de configuración. |
| Los pedidos están vacíos para un cliente conocido | Confirmar que el correo electrónico del cliente en la conversación de FreeScout coincide con el correo electrónico de sus pedidos de Shopify. |
| Solo se muestran los pedidos de los últimos 60 días | Añade el read_all_orders alcance a la aplicación personalizada, reinstálala y pega el nuevo token. |
| Las líneas de pedido, los datos financieros o el CLV no se muestran | Confirmar que la clave de licencia del conector está guardada, o que un plan activo de ReplyRabbit Pro o Team cubre la instalación. |
| El contexto de propiedad del producto no aparece en los borradores | Confirmar que el conector tiene licencia, que ReplyRabbit está instalado, que el conector devuelve pedidos y que la función de contexto de IA está habilitada para el buzón. |
Para problemas más amplios, consulta Resolución de problemas de ReplyRabbit.
Privacidad y tratamiento de datos
Cuando el conector consulta Shopify, envía la dirección de correo del cliente a la API GraphQL Admin de Shopify por HTTPS usando el token de tu app personalizada. Los datos de pedidos devueltos por tu tienda rellenan la barra lateral de FreeScout y, con ReplyRabbit, construyen el contexto de IA para los borradores.
La app personalizada solo tiene ámbitos de lectura, así que el conector nunca escribe en tu tienda. El token de acceso se almacena cifrado en FreeScout, y las solicitudes salientes verifican TLS y no siguen redirecciones.
Ningún dato de pedido de Shopify se envía a terceros excepto a través del proveedor de IA seleccionado para el buzón, y solo cuando la función de contexto de IA lo usa. Si tu política exige que los datos de pedidos permanezcan completamente en tus propios servidores, usa un proveedor de IA local (como Ollama) para el buzón.
Próximos pasos
- Finalizar Cómo configurar ReplyRabbit si el buzón aún necesita configuración de proveedor, contexto o estilo.
- ¿También en WooCommerce o Magento? Consulta la Conector de WooCommerce y Conector de Magento guías.
Preguntas frecuentes
¿Cómo se conecta el conector de Shopify a mi tienda?
Con una app personalizada que crees en el panel de administración de Shopify (Settings, Apps and sales channels, Develop apps). Dale los permisos read_customers, read_orders y read_products, instálala y pega su token de acceso a la Admin API junto con el dominio de tu tienda en los ajustes del conector de FreeScout. El conector verifica el token contra tu tienda antes de guardarlo.
¿Necesito una cuenta de Shopify Partner o un listado en la App Store?
No. Una app personalizada se crea dentro del panel de administración de tu propia tienda y no necesita cuenta de Partner, ni revisión de app, ni listado público.
¿Cuánto cuesta el conector de Shopify?
El Conector de Shopify está incluido con un plan ReplyRabbit Pro o Team activo. De lo contrario, cuesta 18 EUR como licencia única para una instalación de FreeScout. Si lo compras, establece su clave de licencia como SHOPIFYINTEGRATION_LICENSE_KEY en tu .env de FreeScout.
¿Por qué solo veo pedidos de los últimos 60 días?
Shopify limita las apps a 60 días de historial de pedidos a menos que la app tenga el ámbito read_all_orders. Marca read_all_orders al configurar la app personalizada para ver el historial completo.
¿Puede cada buzón de FreeScout conectarse a una tienda Shopify diferente?
Sí. Cada buzón almacena su propio dominio de tienda y token de acceso en la configuración del conector, por lo que diferentes tiendas pueden conectarse a diferentes buzones.