# 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.

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](https://os.utilia.ai/docs/developers/chat-platform/post-messages) |
| Leer canales, miembros y mensajes | API con clave de API | [Endpoints de lectura](https://os.utilia.ai/docs/developers/chat-platform/read-endpoints) |
| Crear, editar y archivar canales, y gestionar sus miembros | API con clave de API | [Crear canales y gestionar miembros](https://os.utilia.ai/docs/developers/chat-platform/channel-endpoints) |
| Recibir avisos de lo que pasa en sus canales | Webhooks | [Webhooks de chat](https://os.utilia.ai/docs/developers/chat-platform/webhooks) |
| Proponer agentes de IA para un canal | API con clave de API | [Gestionar agentes de IA](https://os.utilia.ai/docs/developers/chat-platform/managed-agents) |
| Llegar a otras empresas | Con una ficha en el catálogo de aplicaciones, que cada empresa instala, o con OAuth | [Aplicaciones de chat en el catálogo](https://os.utilia.ai/docs/developers/chat-platform/app-catalog) |

Todo lo anterior también está en los [SDK de JavaScript y Python](https://os.utilia.ai/docs/developers/chat-platform/sdk). Aparte, un asistente de IA puede consultar y gestionar el chat en nombre de una persona por [MCP](https://os.utilia.ai/docs/developers/chat-platform/mcp-tools).

## 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 › Creadas por tu empresa**, con el botón **Nueva aplicación**.

## 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**

1. **Crea la aplicación externa** (Integraciones): Con su clave de API, que empieza por utl\_.
2. [**Asígnale los scopes**](https://os.utilia.ai/docs/developers/chat-platform/scopes-and-access) (Ficha de la aplicación): Por ejemplo, chat:messages:send para publicar. Con cualquier scope chat:\*, queda habilitada en el Chat.
3. **Consigue acceso a un canal** (Panel del canal › Apps): No se pide desde la API: una persona que gestiona las apps del canal pulsa «Dar acceso a una app» y elige qué puede hacer.
4. [**Publica tu primer mensaje**](https://os.utilia.ai/docs/developers/chat-platform/post-messages) (API del chat): Aparece en el canal firmado con el nombre de tu aplicación.

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](https://os.utilia.ai/docs/developers/chat-platform/scopes-and-access).

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](https://os.utilia.ai/docs/developers/chat-platform/authentication) y publica tu primer mensaje. Si prefieres verlo todo junto, el [ejemplo del termómetro](https://os.utilia.ai/docs/developers/chat-platform/example-thermometer) recorre el flujo completo: publicar, recibir la respuesta del equipo y contestar.