# Aplicaciones de chat en el catálogo

Cómo llega una aplicación de chat a otras empresas con el catálogo de aplicaciones: los permisos de chat que puede pedir, el acceso canal a canal y sus avisos.

Una aplicación de chat llega a otras empresas igual que cualquier otra: con una ficha en el [catálogo de aplicaciones](https://os.utilia.ai/docs/developers/apps-platform/overview), que revisa UTILIA y que cada empresa instala desde Explorar. Lo que la hace de chat son los permisos `chat:*` que pide su ficha y el acceso que cada empresa le abre, canal a canal.

## Los permisos de chat que puede pedir

Una ficha del catálogo puede pedir ocho de los nueve permisos de chat:

| Permiso | Para qué |
| - | - |
| `chat:messages:send` | Publicar mensajes como la aplicación. |
| `chat:messages:view` | Leer los mensajes de los canales que le abran. |
| `chat:channels:view` | Ver esos canales, su detalle y sus miembros. |
| `chat:channels:create` | Crear canales. |
| `chat:channels:manage` | Editar y archivar canales. |
| `chat:members:manage` | Añadir y retirar miembros. |
| `chat:events:subscribe` | Recibir los avisos del chat. |
| `chat:agents:view` | Ver los agentes de IA que ha creado la propia aplicación. |

`chat:agents:manage:external`, que crea agentes de IA que actúan con los permisos prestados de una persona, no se puede pedir en el catálogo: solo lo concede un Super Administrador, con motivo, a una aplicación de su propia empresa. La lista completa de lo que admite el catálogo está en [Permisos que puede pedir una aplicación](https://os.utilia.ai/docs/developers/apps-platform/permissions).

Los permisos de chat no exigen nada a la persona responsable de la instalación, porque la puerta está después.

## Acceso canal a canal

Al instalarla, la aplicación queda habilitada en el chat de la empresa, pero **no entra en ningún canal**. Una persona de la empresa se lo abre, canal a canal, con su propio permiso, y lo puede cerrar cuando quiera. Mientras tanto, tus llamadas a un canal que no le han abierto responden [`APP_NOT_AUTHORIZED_IN_CHANNEL`](https://os.utilia.ai/docs/developers/getting-started/errors-and-retries#app_not_authorized_in_channel). Lo explica [Scopes y acceso por canal](https://os.utilia.ai/docs/developers/chat-platform/scopes-and-access).

Cada instalación es independiente: los canales que te abre una empresa no tienen nada que ver con los de otra, y cada una se llama con la clave de su instalación.

## Avisos del chat

Con `chat:events:subscribe` concedido y los avisos de chat en la ficha, cada instalación te manda los avisos de sus canales abiertos a la dirección de avisos de la ficha, con `installation` en el sobre y firmados con la clave de esa instalación. Los de agentes exigen además `chat:agents:view`. La forma de cada aviso está en [Webhooks de chat](https://os.utilia.ai/docs/developers/chat-platform/webhooks), y cómo se identifican y se firman por instalación, en [Avisos de cada instalación](https://os.utilia.ai/docs/developers/apps-platform/webhooks).

## Si es solo para una empresa

Si tu aplicación de chat la va a usar una sola empresa, no hace falta el catálogo: esa empresa crea su propia aplicación en Ajustes › Creadas por tu empresa, le concede los permisos de chat y te pasa la clave por un canal seguro. Lo explica [Autenticación de la plataforma de chat](https://os.utilia.ai/docs/developers/chat-platform/authentication).