Cargando

Saltar al contenido

Usar UTILIA OS Desarrolladores

Entrar Únete a la lista de espera

Empezar

API

Conectar

Insertar en tu web

Cambios

Cargando la pantalla

¿Aún no usas UTILIA OS?

Únete a la lista de espera

Aviso legal
Privacidad
Cookies

© 2026 UTILIA SERVICIOS IA S. COOP. CAN.

Documentación
Para desarrolladores
SDK

SDK

Los SDK oficiales de JavaScript y Python: una página por tema, con el código de los dos lenguajes en pestañas.

No todo lo de esta sección está en todos los planes: cada artículo indica en cuáles se incluye. Ver precios

Qué conecta el SDK

Recibe de

Iniciar sesión con UTILIA
OAuth le da el token con el que actúa en nombre de una persona.
Avisos a tu servidor
webhooks.verify comprueba la firma de cada aviso y lo devuelve ya tipado.

SDK

La API externa y el carril MCP de UTILIA OS, en JavaScript y en Python.

Envía a

Tickets de soporte
Tus usuarios abren tickets y conversan con el equipo desde tu aplicación.
Finanzas
Emite facturas, cobra, programa cobros y monta suscripciones a nombre de tus usuarios.
CRM
Sincroniza clientes, contactos y leads, y lee la analítica de oportunidades.
Marketing
Comprueba, envía y mide campañas por MCP.
Gestor de archivos
Guarda los adjuntos que suben tus usuarios.

Empieza por aquí

Los SDK de UTILIA OS

Qué cubren los SDK oficiales de JavaScript y Python, con qué credencial se autentica cada parte y por dónde empezar.

General

Instalar el SDKRequisitos, instalación con npm o pip y primera llamada del SDK de UTILIA OS en JavaScript y en Python.
Configurar el clienteOpciones del cliente del SDK en JavaScript y Python, cabeceras automáticas, reintentos con espera creciente, depuración y autenticación con clave u OAuth.
OAuth con el SDKUsa el SDK en nombre de una persona con OAuth 2.1 y PKCE, guarda sus tokens donde quieras y deja que el SDK los renueve.
Versiones y compatibilidadMatriz de versiones de la API externa, los SDK de JavaScript y Python y el widget, con lo que aporta cada versión y sus cambios incompatibles.

Errores y límites

Gestionar erroresQué trae un UtiliaSDKError, cómo se traduce cada respuesta HTTP, qué se reintenta y cómo reaccionar a cada caso en JavaScript y Python.
Errores de planCómo distinguir un 403 por falta de permiso de un bloqueo por plan (MODULE_NOT_ENABLED y CAPABILITY_NOT_ENABLED) y qué hacer con cada uno desde los SDK.
Límites y validacionesQué comprueba el SDK antes de enviar cada petición, qué comprueba solo el servidor y los límites de paginación, archivos y configuración.

Usuarios, soporte e IA

Usuarios externosIdentifica a las personas de tu aplicación en UTILIA OS con identify y lístalas: es el primer paso de tickets, facturas, tarjetas y suscripciones.
Tickets de soporteAbre tickets de soporte en nombre de tus usuarios, añade mensajes con adjuntos, ciérralos o reábrelos y recibe los cambios en tiempo real.
Archivos adjuntosSube archivos para adjuntarlos a tickets y mensajes, obtén enlaces temporales de descarga y consulta la cuota de almacenamiento de tu aplicación.
Notificar errores de tu aplicaciónEnvía a UTILIA OS los errores de tu aplicación, agrupados sin duplicados, y consulta su listado y sus estadísticas con el servicio errors.
Sugerencias con IARellena el formulario de un ticket con IA a partir de texto, audio o imágenes, recibe el resultado por consulta periódica o en tiempo real y registra qué aceptó la persona.
Transcripción de audioConvierte notas de voz en texto con el SDK, en una sola llamada para audios cortos o como tarea en segundo plano con progreso para los largos.

Facturar y cobrar

FacturasEmite facturas con numeración y registro fiscal desde tu aplicación, envíalas, cóbralas, entrega su enlace público, anúlalas, devuelve el dinero y programa cobros.
Métodos de pagoComprueba si la organización puede cobrar con tarjeta y guarda, lista, marca como predeterminada o retira la tarjeta de tus usuarios con Stripe Elements.
CobrosCobra una factura con el usuario delante, con su tarjeta guardada o con una nueva, completa la autenticación del banco y consulta el historial de intentos.
SuscripcionesMonta cuotas que UTILIA OS factura, envía y, si quieres, cobra solas cada periodo; consulta el próximo cobro y pausa, reanuda, da de baja o reactiva.
Autorizaciones de cobroRecoge el consentimiento firmado con el que tu usuario te permite cobrarle sin estar delante, para suscripciones y cobros programados, y consúltalo o retíralo.

CRM y marketing por MCP

OportunidadesLee desde el SDK los contadores, las acciones recomendadas, la salud del pipeline y los motivos de pérdida de las oportunidades del CRM, por MCP.
MarketingLos métodos de sdk.mcp.marketing en JavaScript y Python: comprobación previa al envío, historial por destinatario, consentimiento, rebotes y rutas de envío.

Referencia

Referencia de métodosTodos los servicios y métodos de los SDK de JavaScript y Python, con su nombre en cada lenguaje, la credencial que los alcanza y las diferencias entre ambos.
Tipos y modelosLos tipos de TypeScript y los modelos de Pydantic de los SDK para usuarios, tickets, archivos, errores, IA y paginación, con el nombre de cada campo en los dos lenguajes.