Conecta tu propio sistema

Resumen

Canales e integraciones → Propio sistema (/es/integrations/own-system) es para tiendas que mantienen cuentas de clientes en su propio sistema (por ejemplo, un portal de logística) y no quieren copiar esos datos en OrderInChat.

• Integras el widget de OrderInChat en tus páginas de inicio de sesión.
• Tu servidor firma un token de corta duración para el usuario registrado y se lo proporciona al widget.
• Cuando ese cliente pregunta sobre su propia cuenta (por ejemplo, "¿Dónde está mi envío?"), la IA llama a tus propias herramientas MCP de solo lectura con el token de ese usuario, en el chat de texto y en las llamadas de voz iniciadas desde el widget.
• OrderInChat solo verifica tu firma. Nunca crea identidades, nunca lee tu base de datos y no almacena lo que tus herramientas devuelven.

Disponible en planes de pago (Starter, Pro, Ultra). Los visitantes sin un token válido son anónimos: la IA responde desde tu base de conocimientos y les pide que inicien sesión para preguntas sobre la cuenta.

Deja que la IA de tu desarrollador lo construya

En Para la IA de tu desarrollador, haz clic en Copiar instrucciones y pega el texto tal cual en el asistente de IA de tus desarrolladores (Claude Code, Cursor, ChatGPT…). Está en inglés y describe exactamente qué construir — el endpoint de token, el servidor MCP firmado y el código del widget — con el ID de tu tienda y tus direcciones ya incluidos. Pide a la IA que termine con una lista de los valores que hay que introducir en esta página. Nunca incluye secretos: crea los secretos de firma en esta página y guárdalos tú mismo en tu servidor.

1. Token de inicio de sesión del usuario

Tu servidor firma un JWT para el usuario registrado:

Elige cómo OrderInChat lo verifica:

• URL de JWKS (ES256 o RS256) — la dirección HTTPS de tus claves públicas.
• Clave pública (ES256 o RS256) — pega la clave pública PEM.
• Secreto compartido (HS256) — al menos 32 caracteres, almacenado encriptado.

Pega un token de muestra bajo Probar un token para verificarlo antes de que vayas en vivo. Un token inválido o caducado nunca falla el chat: el visitante simplemente es tratado como anónimo.

2. Tu servidor MCP

Ingresa la dirección de tu servidor MCP (Streamable HTTP, tools/list y tools/call). Prueba y En vivo cada uno tiene su propia dirección y secreto de firma; Modo activo elige cuál usa la IA.

Haz clic en Crear para obtener un secreto de firma. Se muestra una vez — guárdalo en tu servidor. Revocar lo elimina de inmediato (las llamadas en ese modo se detienen hasta que crees uno nuevo).

Cada solicitud que OrderInChat envía a tu servidor lleva:

• X-OIC-Timestamp — segundos Unix
• X-OIC-Signature — v1= + hex HMAC-SHA256 de timestamp.body con tu secreto de firma
• X-OIC-User-Token — el token del usuario, sin cambios (verifícalo tú mismo y devuelve solo los datos de ese usuario)
• X-OIC-Mode — test o live

Rechaza solicitudes cuya firma no coincida o cuyo timestamp sea más antiguo que 5 minutos. OrderInChat no tiene una dirección IP fija, así que usa la firma en lugar de una lista de permitidos por IP.

3. Herramientas

Haz clic en Descubrir herramientas para leer las herramientas que tu servidor lista, luego activa las que la IA puede usar. Permite solo herramientas de solo lectura. Las herramientas que aparecen más tarde comienzan desactivadas hasta que las actives.

• Chat de texto: una llamada a la herramienta puede tardar hasta 8 segundos.
• Llamadas de voz: hasta 3 segundos; el asistente dice un breve "déjame verificar" primero. Si tu servidor es lento, dice que no pudo verificar en este momento.
• Lo que tus herramientas devuelven se trata solo como datos, nunca como instrucciones, y no se guarda en el historial del chat.

4. Integrar el widget

<script>
  window.OrderInChatSettings = {
    userToken: "",
    getUserToken: async () => (await fetch("/your/oic-token")).text(),
  };
</script>
<script src="https://app.orderinchat.com/widget/oic-widget.js" data-tenant-id="YOUR-STORE-ID"></script>

getUserToken se llama cuando el token está a punto de expirar. Después de que se carga el script, también puedes usar OrderInChat.setUserToken(token), OrderInChat.clearUserToken() (al cerrar sesión) y OrderInChat.onTokenRefresh(fn).

Con un token válido y el asistente de voz activado, el encabezado del widget muestra un botón de teléfono. La llamada se realiza en el widget y se cobra de los créditos de IA como cualquier llamada de sitio web (las llamadas a herramientas están incluidas en la llamada). El audio de la llamada web no se graba.

Personalizar abre la configuración del widget en una pestaña nueva. En cada carga de página, el código lee el aspecto del widget desde OrderInChat (con data-tenant-id), así que los cambios que guardes allí se aplican al momento, sin volver a pegar el código. Se usa el perfil de widget elegido para tu tienda (si no, el activo o el primero); no se crea ningún perfil nuevo.

5. Probar la conexión

Debajo de Herramientas, Probar la conexión ejecuta comprobaciones fijas contra tu dirección MCP de Prueba con el secreto de firma de prueba. No interviene ninguna IA y no se guarda nada. Comprueba que:

• la dirección es https pública (no localhost ni una dirección de red privada);
• un tools/list firmado correctamente funciona;
• una solicitud con firma incorrecta se rechaza;
• una firma correcta con una marca de tiempo de más de 5 minutos se rechaza;
• tools/call en una herramienta activada sin token de usuario devuelve un error y ningún dato;
• con un token de ejemplo pegado en Probar un token, tools/call funciona — y con qué rapidez (más de 2 segundos es demasiado lento para llamadas de voz; estas se rinden a los 3 segundos).

Solo se llaman herramientas que hayas descubierto y activado, con argumentos vacíos; el token de ejemplo se usa solo para esa prueba y nunca se guarda. Cada punto fallido indica cómo corregirlo. Copiar resultados para tu desarrollador copia un informe en inglés que puedes pegar a tu desarrollador o a su IA; repite la prueba hasta que no falle nada.

Lo que ve tu equipo

• Bandeja de entrada → Web: el nombre y el correo electrónico del cliente del token, o Usuario #ID cuando no envías ninguno. Cada respuesta de la IA muestra cuál de tus herramientas utilizó y si funcionó — nunca los datos.
• Bandeja de entrada → Llamadas: las llamadas del widget aparecen bajo Sitio web de la tienda y en En vivo mientras se ejecutan; la transcripción muestra cada paso de la herramienta (nombre y resultado solamente).
• Clientes: se crea o reutiliza una tarjeta de cliente para cada ID de usuario (ID de usuario de la tienda), por lo que los chats y llamadas de la misma persona están vinculados.