Conector de Magento
Funciona con Magento
Conecta Magento 2 o Adobe Commerce a FreeScout para que las conversaciones muestren pedidos de clientes coincidentes y contexto de compra. Un pequeño módulo de Magento de solo lectura expone un resumen de soporte a través de la API REST de Magento, y el conector de FreeScout lo muestra en la barra lateral de la conversación. 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 Magento 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 llama a la moo-support/summary endpoint en tu tienda Magento para asociar pedidos 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 dos componentes que instalar:
- El Módulo del conector de ReplyRabbit para Magento 2. Añade dos endpoints REST de solo lectura (
/rest/V1/moo-support/summaryy/rest/V1/moo-support/purchased-products) detrás de un permiso de administración dedicado llamado API del conector de ReplyRabbit. No modifica la tienda ni el proceso de pago. - El Módulo conector de Magento para FreeScout. Llama a esos endpoints por HTTPS usando un token de acceso de integración de Magento y 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 Magento 2.4 o posterior (Magento Open Source o Adobe Commerce) accesible por HTTPS, con acceso SSH para ejecutar comandos de la CLI de Magento.
- Acceso de administrador de Magento para crear una integración.
- ReplyRabbit instalado y activado si quieres contexto de propiedad de productos en los borradores de IA.
- Una licencia de Magento 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.
Instala el módulo de Magento
Descargar el módulo de Magento
Inicia sesión en app.replyrabbit.app y descarga el ZIP del módulo de Magento desde la tarjeta del conector de Magento.Descomprímelo en app/code
Sube el ZIP a la raíz de Magento y descomprímelo. Creaapp/code/Moogento/SupportData.Activar el módulo
Desde la raíz de Magento, ejecuta:En una tienda en modo producción, ejecuta tambiénbashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploycomo lo harías para cualquier instalación de módulo.
Instalaciones del compositor
moogento/m2-supportdata desde el repositorio de paquetes de Moogento. La instalación por ZIP de arriba no necesita credenciales de Composer.Crear un token de integración de Magento
El conector se autentica con un token de acceso de una Integración de Magento. Crea uno con el permiso de solo lectura del módulo.
Abrir Integraciones
En el administrador de Magento, ve a Sistema, luego Extensiones, luego Integraciones, y haz clic en Añadir nueva integración.Nómbrala y establece el alcance de la API
Introduce un nombre como "ReplyRabbit Connector" y tu contraseña de administrador. En el API pestaña, establece Acceso a recursos a Personalizado y marca solo API del conector de ReplyRabbit (bajo el árbol de administración de nivel superior). Guarda.Activa y copia el token de acceso
Hacer clic Activar junto a la nueva integración, y luego Permitir. Copia el Token de acceso. Magento muestra el token en los detalles de la integración, así que puedes volver a consultarlo más tarde.
Acceso de solo lectura
Instala el módulo conector de FreeScout
El módulo conector de Magento para FreeScout llama a los endpoints de Magento y muestra la barra lateral del pedido en las conversaciones. Es un módulo propio con su propia configuración, independiente de ReplyRabbit.
Descargar el módulo conector
Inicia sesión en app.replyrabbit.app para descargar el ZIP del módulo conector de FreeScout. Ambas descargas aparecen una vez que hayas comprado el conector o tengas un plan activo de ReplyRabbit Pro o Team.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 de Magento módulo desde la lista de Módulos.
Configurar por buzón
Después de instalar el módulo, conéctalo a tu tienda en la página de ajustes por buzón propia del conector.
Abre los ajustes del conector
En FreeScout, abre el buzón que debe mostrar los datos de pedidos de Magento, 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 Magento, no una sección dentro de los ajustes de ReplyRabbit.Introduce la URL base de Magento
Pega la URL base de tu tienda de Magento sobre HTTPS, por ejemplohttps://your-store.com. No se necesita una barra final.Introduce el token de acceso
Pega el Token de acceso desde la integración de Magento. Se almacena cifrada, y solo se muestra una vista previa enmascarada tras guardar.Configura el ID de la tienda (opcional)
Déjalo en blanco para hacer coincidir pedidos de todas las tiendas. Introduce un ID de tienda de Magento para limitar la barra lateral a una tienda o vista de tienda.Añade tu clave de licencia del conector
Si compraste el conector, introduce su clave de licencia. Omite este paso si un plan ReplyRabbit Pro o Team activo cubre la instalación.Guardar y probar
Guarda la configuración. Abre una conversación de FreeScout donde el correo del cliente coincida con un pedido de Magento y confirma que aparece la barra lateral del pedido.
Cada buzón de FreeScout almacena su propia URL base, token de acceso e ID de tienda, por lo que puede conectar diferentes buzones a diferentes tiendas o vistas de tienda de Magento.
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 Magento es un módulo de pago. Puedes obtenerlo de dos formas:
- Compra el Conector de Magento por 18 EUR como licencia única para una instalación de FreeScout, luego pega su clave de licencia en los ajustes del conector.
- 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 |
|---|---|
| La barra lateral de pedido no aparece | Confirmar que la URL base y el token de acceso en la configuración del conector son correctos, y que el panel del buzón está habilitado. |
| HTTP 404 desde la tienda | El módulo Conector de ReplyRabbit no está instalado o habilitado. Vuelve a ejecutar bin/magento module:enable Moogento_SupportData y bin/magento setup:upgrade, luego vacía la caché. |
| HTTP 401 o 403 desde la tienda | La integración no está activada, el token se regeneró, o a la integración le falta el API del conector de ReplyRabbit recurso. Reactiva la integración y pega el token actual. |
| "Conexión rechazada" o error de tiempo de espera | Comprobar que el servidor de FreeScout puede alcanzar la URL de tu tienda por HTTPS. Los firewalls, las listas de IP permitidas o el modo de mantenimiento pueden bloquear la solicitud. |
| La URL base es rechazada | La tienda debe servirse por HTTPS. Un http:// Se rechaza una URL o un host inaccesible. |
| 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 Magento, y que el ID de tienda (si está definido) coincide con la tienda en la que hicieron el pedido. |
| 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 Magento, envía la dirección de correo del cliente a tu propia tienda Magento por HTTPS. 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.
El token de integración solo necesita el API del conector de ReplyRabbit recurso, por lo que el conector nunca escribe en tu tienda. El token se almacena cifrado en FreeScout, y las solicitudes salientes verifican TLS y no siguen redirecciones.
Ningún dato de pedido de Magento 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? Consulta la Conector de WooCommerce guía.
Preguntas frecuentes
¿Necesito un módulo de Magento para el conector?
Sí. El conector lee un endpoint de resumen de soporte que el módulo ReplyRabbit Connector añade a la API REST de Magento 2. Hay dos descargas, el módulo de Magento y el módulo conector de Magento para FreeScout, ambas disponibles desde tu cuenta de ReplyRabbit.
¿Qué versiones de Magento son compatibles?
Magento 2.4 y posteriores, incluidos Magento Open Source y Adobe Commerce, en PHP 8.0 a 8.4. Magento 1 no es compatible.
¿Cuánto cuesta el conector de Magento?
El Conector de Magento 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, pega su clave de licencia en la configuración del conector.
¿Qué permiso necesita el token de acceso?
Solo el recurso de la API del Conector de ReplyRabbit, que es de solo lectura. El conector nunca escribe en tu tienda, así que la integración no necesita ningún otro permiso de administrador.
¿Puede cada buzón de FreeScout conectarse a una tienda Magento diferente?
Sí. Cada buzón almacena su propia URL base, token de acceso y store ID opcional en la configuración del conector, por lo que diferentes tiendas o vistas de tienda pueden conectarse a diferentes buzones.