🏛️ Rexmi ← Volver al portal

Cómo conectar tu agente

Guía sencilla, sin tecnicismos. Elige dónde quieres poner tu asistente.

📋 Antes de empezar: copia tu "Agent ID"

Es el identificador de tu agente. Lo necesitas en todos los casos.

Dónde: entra en tu portal → Mis agentes → pulsa Conectar en tu agente. Verás un código que empieza por ag_ — ese es tu Agent ID. Cópialo.

🛍️ Conectar en Shopify

Es la forma más fácil: no necesitas programar ni instalar nada.

  1. Copia el código de Shopify. En el portal → tu agente → Conectar → pestaña Shopify → botón Copiar.
  2. Entra en el editor de tu tienda. En Shopify: menú Tienda online (Online Store) → Temas (Themes).
  3. Abre el código del tema. En tu tema actual, pulsa los tres puntos (···)Editar código (Edit code).
  4. Busca el archivo theme.liquid en la lista de la izquierda (carpeta "Layout") y ábrelo.
  5. Pega el código justo antes de </body> (está casi al final del archivo). Pégalo en la línea de arriba de </body>.
  6. Guarda (botón Guardar arriba a la derecha). ¡Ya está! El chat aparecerá en tu tienda.
  7. Autoriza tu dominio. Vuelve al portal → Conectar → Shopify → en Dominios permitidos escribe la dirección de tu tienda (ej: mitienda.com) y pulsa Guardar dominios.
⚠️ El paso 7 es importante: si no pones tu dominio, por seguridad el chat podría no responder. Escribe la web donde lo has puesto.
💡 ¿Quieres verlo antes de tocar Shopify? Usa el botón 👁 Vista previa del portal: te muestra el chat funcionando en una página de ejemplo.

🔌 Conectar en WordPress

Con nuestro plugin gratuito. Necesitarás tu token (te lo dimos al crear tu cuenta) y tu Agent ID.

  1. Instala el plugin "Rexmi Chat". En tu WordPress: Plugins → Añadir nuevo → Subir plugin, y sube el archivo del plugin (te lo facilitamos). Luego pulsa Activar.
  2. Abre los ajustes. Menú Ajustes → Rexmi Chat.
  3. Pega tu token (el código que empieza por rxmi_) en el campo "Token".
  4. Pega tu Agent ID (el que empieza por ag_) en el campo correspondiente.
  5. Marca "Activar chat" y pulsa Guardar.
  6. Comprueba. Usa el botón "Probar conexión" del plugin. Si sale ✅, ya está funcionando en tu web.
💡 Con WordPress, tu token va protegido en tu servidor y el agente puede usar herramientas que consultan tus datos (pedidos, citas, etc.).

💻 Conectar en tu propia web

Para webs hechas a medida. Esta parte la suele hacer la persona que te lleva la web.

Opción A — Rápida (sin servidor)

Igual que Shopify: copia el código de la pestaña Shopify/Código público y pégalo antes de </body> en tu web. Añade tu dominio en "Dominios permitidos".

<script src="https://agent.rexmi.io/widget/v1/widget.js" data-public-agent="TU_AGENT_ID" data-color="#9ea0ff"></script>

Opción B — Con servidor (más potente)

Si tu agente usa herramientas que consultan tus datos (pedidos, stock…), necesitas un pequeño "proxy" en tu servidor que añade tu token de forma segura. Pásale esto a tu desarrollador:

  1. Copia el código de la pestaña Código del portal (usa data-proxy-url).
  2. Crea un endpoint en tu backend (ej. /api/rexmi-proxy) que reenvíe la petición a https://agent.rexmi.io/api/v1/widget/chat añadiendo la cabecera Authorization: Bearer TU_TOKEN.
  3. Si la respuesta trae pending_tool_calls, ejecútalas en tu servidor y reenvía el resultado a /api/v1/widget/chat/continue.
💡 Tienes ejemplos listos (Next.js, NestJS) en la documentación. Pídenoslos si los necesitas.

¿Algo no funciona?

No aparece el botón de chat

Comprueba que pegaste el código antes de </body> y que guardaste los cambios. Recarga la página con Ctrl+F5. En Shopify, asegúrate de editar el tema activo.

El chat aparece pero no responde / da error

Casi siempre es el dominio: ve al portal → Conectar → añade la dirección de tu web en "Dominios permitidos" y guarda. Si pruebas en tu ordenador (localhost), deja los dominios vacíos o añade localhost.

¿Dónde está mi token y mi Agent ID?

El token (rxmi_...) está en tu panel y te llegó por email al crear la cuenta. El Agent ID (ag_...) está en el portal → Mis agentes → Conectar.

Quiero cambiar el color o el saludo del chat

Edita tu agente en el portal (botón Editar) y cambia el color y el saludo. El widget se actualiza solo; si no, recarga tu web.

¿Sigues atascado? Escríbenos a hola@rexmi.io y te ayudamos.