Conecta UTILIA OS con tu software: API, avisos a tu servidor, SDK, MCP e inicio de sesión.
Cómo se conecta tu software con UTILIA OS
Tu servidor → UTILIA OSDe tu servidor a UTILIA OS:
X-Api-Key
Lee y crea usuarios, tickets, facturas o clientes con la clave de tu aplicación.
Tu servidor → UTILIA OSDe tu servidor a UTILIA OS:
@utilia-os/sdk-js · utilia-sdk
Los mismos endpoints, con tipos, validación local y reintentos.
UTILIA OS → tu servidorDe UTILIA OS a tu servidor:
X-Utilia-Signature
UTILIA OS te avisa de cada cambio al momento, firmado con HMAC-SHA256 y con reintentos.
Tu aplicación ↔ UTILIA OSEntre tu aplicación y UTILIA OS, en los dos sentidos:
OAuth 2.1 · OpenID Connect
Las personas entran con su cuenta y tu aplicación trabaja con sus datos, en su nombre.
Tu asistente de IA → UTILIA OSDe tu asistente de IA a UTILIA OS:
/api/mcp/<área>
Claude, ChatGPT o tu agente trabajan con los datos de una persona, sin pasar de sus permisos.
Tu web → UTILIA OSDe tu web a UTILIA OS:
Widget de soporte y Formularios de captación
<utilia-support> · widget.js
Tus clientes abren tickets o te dejan sus datos sin salir de tu web.
Casi siempre se combinan: tu servidor llama a la API y UTILIA OS le avisa de cada cambio.
Elegir credencial
Las seis credenciales de UTILIA OS, qué abre cada una y cuál te toca según quién llama: tu aplicación, un programa, una IA o tu web.
Las peticiones van a esta dirección y llevan una de estas dos claves, según lo que conectes. El contrato de la API externa se descarga sin clave.
https://os.utilia.ai/apiAuthorization: Bearer utk_…Para tus programas y automatizaciones: actúa con los permisos de una persona de tu equipo. Entra y créala en Ajustes › Claves de APIX-Api-KeySu valor es la clave de la aplicación. Entra y da de alta la aplicación en Ajustes › Creadas por tu empresahttps://os.utilia.ai/docs/openapi/external-v1.jsonPara generar un cliente, importarlo en Postman o dárselo a tu asistente de IA.