Conecta tu tienda online

Con el plan E-commerce, tu asistente puede responder «¿dónde está mi pedido?» con datos reales de tu tienda Magento, Shopify, WooCommerce o PrestaShop. Si tu tienda es PrestaShop, también puede confirmar si un producto tiene stock en este momento. Esta guía te lleva paso a paso por la conexión: dónde crear la credencial en cada plataforma y cómo activarla en ChatME en unos cinco minutos.

Antes de empezar

• Necesitas el plan E-commerce (99 €/mes o 999 €/año). Si estás en Free, Basic o Pro, puedes cambiar de plan desde Facturación en tu panel.
• Necesitas acceso de administrador a tu tienda para crear una credencial de API.
• ChatME solo consulta: el asistente lee pedidos (y, en PrestaShop, el stock), pero nunca los modifica, cancela ni crea nada. En Shopify, WooCommerce y PrestaShop la credencial es, además, de solo lectura. Magento no tiene permisos de solo lectura: en su sección te decimos qué marcar para darle el mínimo acceso posible.
• Tu tienda tiene que servirse por HTTPS: ChatME no se conecta a direcciones http://.
• ¿Tu tienda no es Magento, Shopify, WooCommerce ni PrestaShop? Las conexiones con otras plataformas las desarrollamos bajo petición — escríbenos a info@chatme.es.

La conexión se hace desde tu panel de ChatME, en la sección E-commerce del menú (dentro de Integraciones), en la página Conecta tu tienda. Eliges tu plataforma (Magento, Magento 1, Shopify, WooCommerce o PrestaShop), escribes la URL de tu tienda y pegas la credencial en los campos que pide esa plataforma. ChatME prueba la conexión contra tu tienda antes de guardar nada: si la credencial no funciona, no se guarda.

La URL de tu tienda es la dirección exacta con la que se abre, empezando por https:// (con o sin www, según abra tu tienda). Si tu tienda redirige a otra dirección —por ejemplo, de https://mitienda.com a https://www.mitienda.com—, la prueba falla y el panel te dice qué dirección usar (si la redirección va a http://, te pide activar https en tu tienda): por seguridad, ChatME nunca envía tu clave a otra dirección ni sin https. Si tu tienda cambia de dirección después de conectarla, el asistente deja de consultarla hasta que la desconectes y la conectes con la dirección nueva. Shopify, WooCommerce y PrestaShop tienen su propio matiz; lo verás en su sección.

Si la prueba falla, el panel te explica el motivo: la clave rechazada, un permiso que falta, un cortafuegos que bloquea la petición, una dirección que no es la de la API… Las causas más habituales de cada plataforma están en su sección.

Conectar Magento 2

Funciona con Magento Open Source y Adobe Commerce 2.x, en tu propio servidor o en Adobe Commerce on cloud infrastructure. No funciona con Adobe Commerce as a Cloud Service (la edición SaaS de Adobe), que no tiene claves de integración.

1. En el admin de Magento, ve a Sistema → Extensiones → Integraciones y pulsa Add New Integration.
2. Dale un nombre (por ejemplo, «ChatME») y, en la pestaña API, pon Resource Access en Custom y marca solo Sales → Operations → Orders → Actions → View y Sales → Operations → Shipments (este último, para que el asistente pueda dar el número de seguimiento).
3. Guarda. En la lista de integraciones, pulsa Activate y después Allow: Magento te muestra cuatro claves (Consumer Key, Consumer Secret, Access Token y Access Token Secret). Cópialas las cuatro.
4. En ChatME, elige Magento, pega la URL de tu tienda (por ejemplo, https://www.mitienda.com; si Magento está en una subcarpeta, inclúyela) y las cuatro claves, cada una en su campo.
5. Pulsa Probar y guardar.

• No marques «Orders» entero. Magento no tiene permisos de solo lectura: la casilla Orders completa también permite crear, editar, cancelar, facturar y reembolsar pedidos, y Shipments también permite crear envíos. ChatME solo consulta, pero con esas dos casillas la integración tiene el mínimo acceso posible.
• No tienes que cambiar ningún ajuste de tu tienda. ChatME firma cada petición con las cuatro claves (OAuth 1.0a), así que no hace falta activar «Allow OAuth Access Tokens to be used as standalone Bearer tokens».
• Todas las vistas de tienda. ChatME consulta los pedidos de todas tus vistas de tienda (también si tienes varios idiomas): no hay que indicar ningún código de vista.
• Sin el permiso Shipments, la tienda se conecta y el asistente da el estado de los pedidos, pero no el número de seguimiento. Justo después de la prueba, el panel te lo indica bajo Estado de pedidos: añade el permiso en tu tienda y pulsa Probar de nuevo.

Consejo: si tu tienda está detrás de Cloudflare u otro cortafuegos, deja pasar las peticiones de servidores a /rest/. Un cortafuegos es la causa más común de un error de conexión (403) en Magento.

Conectar Magento 1

¿Sigues en Magento 1 u OpenMage? También puedes conectarla. Magento 1 no tiene la API REST moderna, así que la conexión se hace con su API SOAP mediante un usuario de servicios web. Crea primero el rol y después el usuario:

1. En el admin de Magento 1, ve a Sistema → Servicios web → SOAP/XML-RPC - Roles y pulsa Add New Role. Dale un nombre (por ejemplo, «ChatME»).
2. En la pestaña Role Resources, pon Resource Access en Custom y marca solo Sales → Order → Retrieve orders info y Sales → Order → Order shipments → Retrieve shipment info (este último, para el número de seguimiento). Las casillas superiores se marcan solas. Guarda el rol.
3. Ve a Sistema → Servicios web → SOAP/XML-RPC - Users y pulsa Add New User. Crea el usuario (por ejemplo, chatme) con su API Key y déjalo activo. En la pestaña User Role, elige el rol que acabas de crear y guarda.
4. En ChatME, elige Magento 1, pega la URL de tu tienda, el usuario SOAP y su API Key.
5. Pulsa Probar y guardar. ChatME entra con ese usuario y hace dos consultas de lectura, sin leer ningún pedido real, para comprobar que el rol puede ver los pedidos y los envíos.

• Magento 1 no tiene modo de solo lectura. No marques Order entero (también permite cambiar el estado, facturar y reembolsar) ni Order shipments entero (también permite crear envíos). ChatME solo consulta.
• Si el rol no puede ver los pedidos, la conexión no se guarda y el panel te dice qué permiso marcar. Sin Retrieve shipment info, la tienda se conecta, pero el asistente no dará números de seguimiento hasta que lo añadas y pulses Probar de nuevo.
• Las rutas /api/soap/ deben ser accesibles desde internet (mismo aviso de cortafuegos que en Magento 2). Si tu tienda no usa URLs amigables, ChatME prueba también /index.php/api/soap/ por sí solo.
• Consejo: activa la caché del WSDL en Sistema → Configuración → Servicios → Magento Core API → Enable WSDL Cache: Yes. Sin ella, cada consulta es más lenta.

Nota: como Magento 1 está fuera de soporte oficial desde 2020, te recomendamos que la tienda corra al menos sobre OpenMage LTS con HTTPS.

Conectar Shopify

Desde el 1 de enero de 2026, Shopify ya no deja crear apps personalizadas en el admin de la tienda: las apps nuevas se crean en su Dev Dashboard y no muestran ningún token. ChatME se conecta con el Client ID y el Client secret de esa app.

1. En el admin de Shopify, ve a Configuración → Aplicaciones → Desarrollar aplicaciones y pulsa Crear aplicaciones en Dev Dashboard. Crea la app (por ejemplo, «ChatME»).
2. En la versión de la app (Versions), añade solo el permiso read_orders y pulsa Release.
3. Pulsa Install app e instala la app en tu tienda.
4. En Settings de la app, copia el Client ID y el Client secret.
5. En ChatME, elige Shopify y deja marcada la opción App del Dev Dashboard (Client ID + Secret). Pega la dirección https://tu-tienda.myshopify.com de tu tienda (la ves en Shopify → Configuración → Dominios; también vale la del admin, https://admin.shopify.com/store/tu-tienda), no tu dominio público. Después, el Client ID y el Client secret.
6. Pulsa Probar y guardar. ChatME pide a Shopify un acceso nuevo cada día: no tienes que renovar nada.

• La app tiene que ser de la misma organización de Shopify que la tienda. Créala desde el admin de tu tienda, como en el paso 1; si no, Shopify deniega el acceso (403).
• ¿Tu tienda ya tenía una app creada en el admin antes del 1 de enero de 2026? Sigue funcionando: en ChatME elige Token de app antigua (shpat_) y pega su token de acceso de Admin API (empieza por shpat_). La app necesita el permiso read_orders.
• Pedidos de más de 60 días. Con read_orders, Shopify solo deja ver los pedidos de los últimos 60 días. Para los más antiguos hace falta el permiso read_all_orders, que Shopify tiene que aprobar para tu app. Si la app no lo tiene, al probar la conexión el panel te lo indica bajo Estado de pedidos; si lo consigues, añádelo a la app y pulsa Probar de nuevo.
• El nombre y el email de tus clientes. ChatME los necesita para comprobar quién pregunta por un pedido. Si Shopify no se los deja ver a la app (en las apps antiguas creadas en el admin, las de token shpat_, Shopify solo los da en el plan Grow o superior), ChatME lo detecta al probar la conexión —si tu tienda ya tiene algún pedido—, no la guarda y el panel te explica por qué.

Conectar WooCommerce

Antes de crear la clave, comprueba dos cosas en WordPress:

• Tu tienda se sirve por HTTPS.
• En Ajustes → Enlaces permanentes está elegida cualquier opción menos «Simple». Con «Simple», la API de WooCommerce no responde.

1. En WordPress, ve a WooCommerce → Ajustes → Avanzado → REST API y pulsa Añadir clave.
2. Descripción «ChatME»; como usuario, un administrador o un gestor de la tienda (tiene que poder ver los pedidos); y permisos en Lectura.
3. Pulsa Generar clave API y copia la Clave de cliente (ck_…) y la Clave secreta de cliente (cs_…). WooCommerce solo las muestra una vez.
4. En ChatME, elige WooCommerce y pega la dirección de tu WordPress (Ajustes → Generales → Dirección del sitio (URL), empezando por https://). Después, las dos claves: la Clave de cliente en Consumer Key y la Clave secreta de cliente en Consumer Secret.
5. Pulsa Probar y guardar.

• ¿Tu clave ya existía con otro usuario o permiso? No hace falta crear otra: ábrela en WooCommerce → Ajustes → Avanzado → REST API, cambia el usuario o los permisos y guarda los cambios.
• Error 403: casi siempre es un cortafuegos (Cloudflare, un plugin de seguridad o el de tu hosting) que bloquea las peticiones de servidores a /wp-json/wc/v3/: déjalas pasar. El Bot Fight Mode de Cloudflare no admite excepciones por ruta, así que, si lo usas, puede que tengas que desactivarlo.
• Plugins de caché o página de mantenimiento: deja /wp-json/ fuera de ellos. Y si tu web pide usuario y contraseña para entrar (como un sitio en pruebas), ChatME no puede conectarse.
• Si tu servidor no deja pasar la cabecera de autorización a WordPress (pasa en algunos alojamientos), no tienes que hacer nada: ChatME lo detecta al probar la conexión y envía la clave como indica WooCommerce para ese caso, como parámetros de la dirección y siempre por https. Ten en cuenta que entonces la clave aparece en los registros de acceso de tu propio servidor (y de tu CDN, si usas uno). Cuando tu servidor deje pasar la cabecera, Probar de nuevo vuelve a enviarla en la cabecera.

El número de seguimiento sale de los plugins Shipment Tracking (de WooCommerce) o Advanced Shipment Tracking. Más detalle en Pedidos en el chat.

Conectar PrestaShop

Funciona con PrestaShop 1.7, 8 y 9. Cada cosa que actives necesita sus permisos en la clave del Webservice:

• Estado de pedidos: orders (pedidos), customers (clientes) y order_states (estados de pedido).
• Opcional, para el estado de pedidos: carriers (transportistas: el nombre del transportista y el enlace de seguimiento) y currencies (monedas: la moneda del pedido). Sin ellos, el estado de pedidos funciona igual, pero sin transportista, sin enlace y sin moneda.
• Stock en vivo: products (productos), stock_availables (stock disponible), combinations (combinaciones) y product_option_values (valores de atributos).

Puedes activar las dos cosas o solo una: una clave únicamente con los permisos de stock también sirve.

1. En el back-office de PrestaShop, ve a Parámetros avanzados → Webservice y activa el servicio web (Habilitar el servicio web: Sí).
2. Pulsa Añadir nueva clave de webservice y luego Generar una clave (tiene 32 caracteres).
3. En los permisos de esa clave, marca solo Ver (GET) en los recursos de la lista de arriba que necesites. Guarda.
4. En ChatME, elige PrestaShop y pega la dirección principal de tu tienda (por ejemplo, https://www.mitienda.com: sin el idioma, como /es/, sin /index.php y sin la carpeta del panel de administración) y la clave del Webservice.
5. Pulsa Probar y guardar. ChatME comprueba cada permiso y te muestra qué queda activo; si falta alguno, te dice cuál (también los opcionales).

• Si el panel dice que PrestaShop no recibió la clave, tu alojamiento elimina la cabecera de autorización antes de que llegue a PrestaShop (la clave puede estar bien). En Parámetros avanzados → Webservice, activa «Activar el modo CGI para PHP» y guarda; si sigue igual (o tu servidor usa nginx), pide a tu hosting que deje pasar la cabecera Authorization a PHP (en Apache: CGIPassAuth On). Desde PrestaShop 9.0.3, el .htaccess que genera PrestaShop ya incluye esa regla para Apache.
• Si pegas una dirección con /index.php o la del panel de administración, ChatME quita /index.php (y lo que va detrás) y la carpeta del panel. Con cualquier otra página o con el idioma (/es/), la prueba falla y el panel te pide la dirección principal.
• Error 403: casi siempre es un cortafuegos (Cloudflare, ModSecurity o el de tu hosting): deja pasar las peticiones de servidores a /api/.

Stock en vivo en PrestaShop

Con los permisos de stock, cuando un cliente pregunta por un producto —o antes de recomendarle uno concreto— el asistente consulta tu tienda y responde si ahora mismo figura con stock, si quedan pocas unidades o si está agotado. Si el producto tiene combinaciones (formatos, tallas…), lo dice por combinación, y puede compartir el enlace al producto.

• Qué recomendar, cómo es cada producto y sus precios siguen saliendo de tu web, igual que ahora. La consulta de stock no usa ni muestra precios y no dice cuántas unidades quedan: solo si hay stock, si quedan pocas o si está agotado.
• El asistente habla siempre del momento actual: no reserva unidades, no promete que seguirá habiendo stock más tarde y no da fechas de reposición. Si un producto está agotado pero tu tienda acepta pedidos sin stock, lo dice así, sin prometer cuándo se enviaría.
• Los packs: si un pack está configurado en PrestaShop para descontar los productos del pack (o el pack y sus productos), el asistente calcula su stock con el de esos productos (y, en el segundo caso, también con el del propio pack). Si el pack descuenta solo el pack o sigue la opción por defecto de la tienda, se usa el stock propio del pack. Si en tu tienda la opción por defecto es descontar los productos del pack, elige esa opción de forma explícita en cada pack (en la ficha del producto, en las cantidades del pack): si no, el asistente puede dar por agotado un pack que sí se puede comprar.
• Solo se consideran los productos activos de tu catálogo.
• Necesitas tener activada la gestión de stock en PrestaShop (Parámetros de la tienda → Configuración de productos). Si ningún producto figura con stock, ChatME no activa el stock en vivo y te lo explica en el panel.
• ¿Ya tenías la tienda conectada solo para pedidos? Añade los cuatro permisos de stock a la misma clave y pulsa Probar de nuevo en la sección E-commerce: el stock en vivo se activa sin volver a conectar. Si más adelante la clave pierde esos permisos, el stock en vivo se desactiva solo y el panel te dice qué añadir.

Por ahora el stock en vivo solo está disponible con PrestaShop.

Después de conectar

• Verás el estado Tienda conectada con el nombre de tu tienda y qué tiene activo el asistente (Estado de pedidos y, en PrestaShop, Stock en vivo). Si a la clave le falta un permiso que completaría el estado de pedidos, justo después de la prueba el panel te lo indica debajo: el de envíos en Magento (sin él, no hay números de seguimiento), read_all_orders en Shopify (sin él, solo los últimos 60 días) o carriers y currencies en PrestaShop.
• Desde ahí puedes probar de nuevo la conexión o desconectarla en cualquier momento, también si tu plan deja de incluir E-commerce (lo explicamos más abajo).
• Si tu tienda rechaza la clave —porque la revocaste o le quitaste un permiso—, ChatME desactiva el Estado de pedidos, tanto si lo detecta durante la consulta de un cliente como al pulsar Probar de nuevo (en ese caso, también el stock en vivo). En la sección E-commerce lo verás como No activo; si no queda nada activo, el punto de estado se pone gris y, en Resumen, la fila E-commerce de la tarjeta Conexiones aparece como Desactivada. Mientras tanto, el asistente no consulta pedidos: al cliente que pregunta le sugiere contactar con tu negocio. Arregla la clave en tu tienda y pulsa Probar de nuevo: si la prueba sale bien, vuelve a activarse lo que la clave permita. Si creaste una clave nueva, desconecta la tienda y conéctala de nuevo con ella.
• El asistente empieza a responder sobre pedidos inmediatamente — no hace falta tocar el widget ni reinstalarlo.
• Pruébalo tú mismo: abre el chat de tu web y pregunta «¿dónde está mi pedido?» con los datos de un pedido real. Ten en cuenta que hay un máximo de consultas por hora por persona (en el chat web, por conexión a internet): si pruebas muchas veces seguidas, el asistente acabará sugiriendo contactar con tu negocio.

Si tu plan deja de incluir E-commerce

Si cambias a otro plan o cancelas, el asistente deja de consultar tu tienda. La conexión se queda guardada, cifrada, y vuelve a funcionar tal cual si regresas al plan E-commerce. Si prefieres borrarla, en Resumen abre la fila E-commerce de la tarjeta Conexiones: verás tu tienda guardada y el botón Desconectar, que funciona con cualquier plan. También puedes revocar la clave en tu tienda.

Seguridad de tus credenciales

• La credencial se cifra (AES-256-GCM) antes de guardarse y solo se descifra en memoria, en el momento de consultar tu tienda.
• Nunca se muestra de nuevo en el panel ni se envía al navegador.
• ChatME solo la envía a la dirección de tu tienda, por https: si tu tienda redirige a otra dirección o a http://, no la sigue con tu clave. En Shopify, el Client secret solo se envía a tu dirección tu-tienda.myshopify.com, y el acceso diario que da Shopify se guarda solo en memoria.
• Si la rotas o la revocas en tu plataforma, simplemente desconecta y vuelve a conectar con la nueva.

¿Quieres saber cómo vive tu cliente la consulta de un pedido y qué verificación se aplica? Lee Pedidos en el chat: cómo funciona.