Plataforma de chat: visión general
Qué puede hacer tu aplicación en el Chat de UTILIA OS (publicar, leer, gobernar canales, recibir avisos y gestionar agentes) y cómo se le da acceso.
Actualizado el . 3 min de lectura
Incluido en todos los planes. Ver precios
La plataforma de chat permite que una aplicación tuya participe en los canales del Chat de UTILIA OS con identidad propia: publica mensajes firmados con su nombre y su logotipo, lee lo que se dice en los canales donde está, recibe avisos de lo que pasa y, si se lo permites, crea canales, gestiona miembros e incluso propone agentes de IA. Todo con la clave de API de una aplicación externa, y nunca haciéndose pasar por una persona del equipo.
Qué puede hacer tu aplicación
| Qué | Cómo | Dónde se explica |
|---|---|---|
| Publicar mensajes en un canal | API con clave de API | Publicar mensajes |
| Leer canales, miembros y mensajes | API con clave de API | Endpoints de lectura |
| Crear, editar y archivar canales, y gestionar sus miembros | API con clave de API | Crear canales y gestionar miembros |
| Recibir avisos de lo que pasa en sus canales | Webhooks | Webhooks de chat |
| Proponer agentes de IA para un canal | API con clave de API | Gestionar agentes de IA |
| Distribuirse para que otras organizaciones la instalen | Catálogo de aplicaciones | Catálogo de aplicaciones de chat |
Todo lo anterior también está en los SDK de JavaScript y Python. Aparte, un asistente de IA puede consultar y gestionar el chat en nombre de una persona por MCP.
Conceptos
- Canal: sala de conversación del Chat. Tu aplicación solo trabaja en canales y grupos; nunca en conversaciones directas entre personas ni en las conversaciones del portal del cliente.
- Mensaje: tiene un único autor, que puede ser una persona, un agente de IA o una aplicación. Lo que publica tu aplicación lleva siempre su autoría.
- Aplicación externa: tu integración registrada en UTILIA OS, con nombre, logotipo, clave de API y scopes propios. Se crea en Ajustes › Integraciones › Aplicaciones externas, necesitas entrar con tu cuenta.
De cero a tu primer mensaje
El acceso se concede canal a canal, no de forma global: la aplicación necesita el scope de la acción y, además, que una persona responsable le abra cada canal.
De cero a tu primer mensaje en el Chat
Aplicaciones externas
Crea la aplicación externa
Con su clave de API, que empieza por utl_.Ficha de la aplicación
Por ejemplo, chat:messages:send para publicar. Con cualquier scope chat:*, queda habilitada en el Chat.Panel del canal › Apps
Pide acceso a un canal
Un responsable del canal pulsa «Dar acceso a una app» y elige qué puede hacer.
Así, una aplicación con una clave válida no puede escribir en cualquier canal: solo en los que alguien le ha abierto expresamente. Lo tienes en detalle en Scopes y acceso por canal.
Tu aplicación nunca ve contenido interno del equipo: ni en la API ni en los webhooks recibe mensajes marcados como internos, mensajes privados ni respuestas privadas de la IA.
Para todo esto, el plan de tu organización debe incluir el Chat; los agentes de IA necesitan además la capacidad «Agentes de canal», y el catálogo, el aplicativo Integraciones.
Siguiente paso
Empieza por la autenticación y publica tu primer mensaje. Si prefieres verlo todo junto, el ejemplo del termómetro recorre el flujo completo: publicar, recibir la respuesta del equipo y contestar.
Ponlo en práctica
Lo encontrarás en Chat. Para abrirlo, entra con tu cuenta de UTILIA OS.