Integración con Magento

Conecta tu tienda Magento 2 (Open Source / Adobe Commerce) a Conviro para que tu chatbot pueda hacer seguimiento de pedidos, gestionar cancelaciones y devoluciones, y responder preguntas sobre productos dentro del chat.

Hay dos maneras de conectar, y ambas desbloquean las mismas capacidades de flujo:

1. Con la extensión oficial de Conviro – una instalación automatizada de un clic. Recomendada para la mayoría de comercios.
2. Sin ninguna extensión – una configuración manual usando la API REST nativa de Magento más un pequeño snippet del widget. Úsala si no puedes (o no quieres) instalar módulos de terceros.

> Clave: la extensión es una capa de comodidad, no un requisito. El seguimiento de pedidos, la cancelación, las devoluciones y la búsqueda de productos funcionan a través de la API REST nativa de Magento en el backend de Conviro, por lo que funcionan de cualquiera de las dos formas. La extensión solo automatiza la configuración, la inyección del widget y los webhooks de eventos.

Requisitos

• Plan Pro o superior
• Magento 2.4+ (Open Source / Community o Adobe Commerce)
• Acceso de administrador a tu tienda Magento
• Tu clave API de Conviro (genera una en Dashboard -> Settings -> API Keys)

Método A – Con la extensión oficial (recomendado)

La vía más rápida. Un campo, un clic, y todo queda conectado.

Instalación

1. Instala el módulo mediante Composer:

composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <YOUR_CONVIRO_API_KEY>
composer require conviro/module-aichat
php bin/magento module:enable Conviro_AiChat
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

(O sube el ZIP de la extensión desde el panel de Conviro si no usas Composer.)

1. En el admin de Magento, ve a Stores -> Configuration -> Conviro -> AI Chat.
2. Pega tu clave API de Conviro y haz clic en Save Config.

Qué ocurre automáticamente

Al guardar la clave API, la extensión:

• Crea una integración de Magento llamada «Conviro AI Chat» con permisos REST de mínimo privilegio (Sales orders, Catalog products, Customers, Carts) y genera un token de acceso.
• Registra tu tienda en Conviro (URL de la tienda + token) para que los flujos puedan leer tus datos.
• Inyecta automáticamente el widget de chat en cada página de la tienda – sin editar el tema.
• Envía webhooks de eventos (pedido realizado, estado de pedido cambiado, producto guardado, cliente registrado) para que los datos se mantengan actualizados casi en tiempo real.
• Almacena un secreto de webhook firmado para que los eventos entrantes/salientes se verifiquen.

Eso es todo – tus flujos están en marcha.

Método B – Sin la extensión (configuración manual)

No hace falta instalar ningún módulo. En ~5 minutos harás lo que la extensión hace automáticamente: crear un token API y pegar el snippet del widget.

Paso 1 – Crear una integración de Magento (para los flujos)

1. En el admin de Magento, ve a System -> Extensions -> Integrations.
2. Haz clic en Add New Integration.
3. Ponle un nombre (p. ej. «Conviro») e introduce tu contraseña de administrador.
4. Abre la pestaña API y concede acceso a estos recursos:

• Sales -> Operations -> Orders (búsqueda de pedidos, estado, cancelación)
• Catalog -> Inventory -> Products (búsqueda de productos)
• Customers -> Customer (verificación de titularidad del cliente/pedido)
• (opcional) Sales -> Operations -> Returns si usas el flujo de devoluciones

1. Haz clic en Save y luego en Activate.
2. Copia el Access Token que se muestra tras la activación.

Paso 2 – Conectar en Conviro

1. Ve a Dashboard -> Settings -> Integrations -> Magento.
2. Introduce la URL de tu tienda (p. ej. https://your-store.com) y pega el Access Token.
3. Haz clic en Connect. Conviro verifica el token y activa los flujos de e-commerce.

Paso 3 – Añadir el widget de chat

Como no hay una extensión que inyecte el widget automáticamente, añade el snippet tú mismo. Colócalo justo antes de la etiqueta body de cierre de tu tema, o cárgalo mediante Google Tag Manager:

<script src="https://cdn.conviro.io/widget/widget.iife.js"></script>
<script>
  cw('init', { publicKey: 'pk_YOUR_PUBLIC_KEY' });
</script>

En Magento, el lugar más limpio es Content -> Design -> Configuration -> [tu tema] -> HTML Head / Footer, o un bloque HTML misceláneo. GTM también funciona y sobrevive a las actualizaciones del tema.

Qué te da cada método

En resumen: todos los flujos de cara al cliente funcionan en ambos modos. Sin la extensión solo renuncias a la configuración de un clic, la inyección automática del widget y la sincronización por webhooks en tiempo real – todo ello tiene equivalentes manuales sencillos.

Seguridad: verificación de titularidad del pedido

Ambos métodos incluyen la misma protección contra la adivinación de números de pedido. Antes de revelar cualquier detalle del pedido, el flujo pide al cliente el e-mail del pedido:

1. El cliente proporciona un número de pedido.
2. El bot pide el e-mail usado en el checkout.
3. Conviro solo revela los detalles del pedido si el e-mail coincide con el pedido.
4. Si no coincide, el bot responde exactamente como si el pedido no se hubiera encontrado – de modo que un atacante no puede saber si un número de pedido es real.

Esto se aplica en el backend de Conviro, con independencia de la extensión, mediante el paso de verificación de e-mail del flujo de pedidos. Las plantillas de flujo de e-commerce predefinidas ya recogen el e-mail antes de cualquier búsqueda.

Flujos de e-commerce

Usa las plantillas predefinidas en Dashboard -> Flows -> New Flow -> Use Template -> E-Commerce:

• Order Status – consultar estado, envío y seguimiento por número de pedido + e-mail.
• Cancel & Refund – verificar la titularidad y luego cancelar un pedido elegible.
• Returns & Exchanges – verificar la titularidad, capturar el motivo e iniciar un RMA.
• Product Search – encontrar productos por nombre/SKU y compartir detalles en el chat.

Todo esto llama a la API REST nativa de Magento usando el token del Método A o B – no se requieren endpoints personalizados.

Consejos

• Usa la extensión si puedes – elimina cada paso manual y mantiene los datos al día mediante webhooks.
• Usa el modo manual en tiendas restringidas, marketplaces, o cuando una política de seguridad prohíba nuevos módulos.
• Concede a la integración solo los recursos mínimos que realmente uses – siempre puedes añadir Returns más tarde.
• Empieza con el flujo Order Status; responde a la pregunta n.º 1 del e-commerce y demuestra que la conexión funciona.
• Tras conectar, prueba pidiéndole al bot un pedido real (con el e-mail coincidente) y un producto/SKU real.