> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Empresas

> Representa los clientes o marcas para los que trabajan tus agentes y atribuye cada llamada a la empresa correcta.

Una **empresa** es un cliente o una marca para la que trabajan tus agentes
dentro de tu organización de Zelto. Usa Empresas cuando un equipo opera agentes
para varios clientes y necesita separar sus llamadas y actividad.

<Note>
  Empresas es una función opcional. Si **Empresas** no aparece en la barra
  lateral, un propietario o administrador de la organización puede habilitarla
  en **Configuración → Organización**.
</Note>

## ¿Organización, empresa o grupo?

Estos tres conceptos resuelven necesidades diferentes:

| Concepto | Qué representa | Qué controla |
| - | - | - |
| **Organización** | Tu espacio de trabajo y límite de cuenta en Zelto. | Miembros, roles, integraciones, claves de API, facturación y todos los datos del espacio de trabajo. |
| **Empresa** | Un cliente o una marca a la que atiende tu organización. | Qué agentes trabajan para ese cliente y qué llamadas individuales le pertenecen. |
| **Grupo de agentes** | Una colección flexible, como un equipo, área, idioma o campaña. | Agrupación y filtrado a nivel de agente; no atribuye llamadas individuales a un cliente. |

Las empresas no son espacios de trabajo ni límites de acceso independientes.
Todas permanecen dentro de la misma organización y usan sus miembros,
integraciones, claves de API y facturación. Seleccionar una empresa filtra lo
que estás viendo; no concede ni restringe el acceso de un miembro a sus datos.

## Cómo se relacionan las empresas, los agentes y las llamadas

```text theme={null}
Organización
├── Empresa A ─┬── Agente 1 ── llamadas atribuidas a la Empresa A
│              └── Agente 2
└── Empresa B ─┬── Agente 2 ── llamadas atribuidas a la Empresa B
               └── Agente 3
```

Un agente puede trabajar para más de una empresa. Esta pertenencia hace que el
agente aparezca en la página de cada empresa y permite que las vistas basadas en
agentes encuentren los agentes correctos dentro del alcance de la empresa.

Sin embargo, cada conversación se atribuye como máximo a **una** empresa. Esto
permite que Zelto separe las llamadas cuando un agente compartido trabaja para
varios clientes.

## Cómo obtiene una llamada su empresa

Zelto decide la empresa al ingerir la llamada, en este orden:

1. **Identificador de empresa de la llamada.** Si el proveedor o la carga envía
   un identificador de cliente o marca, Zelto asocia ese identificador externo
   con una empresa. La primera vez que recibe uno nuevo, crea una empresa con el
   identificador como nombre; puedes cambiarlo en el panel.
2. **Empresa predeterminada del agente.** Si la llamada no tiene un
   identificador de empresa, Zelto usa la única empresa marcada como
   predeterminada para ese agente.
3. **Sin atribuir.** Si ninguna señal está disponible, la llamada permanece en
   la organización sin una empresa.

El identificador de la llamada siempre tiene prioridad sobre el valor
predeterminado. Para un agente compartido, una llamada puede pertenecer a la
Empresa A y la siguiente a la Empresa B sin cambiar la configuración del agente.

Para cargas directas, envía el identificador como `companyExternalId`:

```json theme={null}
{
  "agent": {
    "externalId": "collections-agent",
    "name": "Agente de cobros"
  },
  "companyExternalId": "acme-bank",
  "call": {
    "externalId": "call-001"
  }
}
```

El valor es tu identificador estable del cliente o la marca y puede tener hasta
255 caracteres. Envía el mismo valor en las llamadas posteriores de la misma
empresa. Consulta [Proveedores personalizados y otros](/es/docs/integrations/api-call-upload#atribuir-cada-llamada-a-una-empresa)
para ver el contrato de carga completo.

<Warning>
  Establecer una empresa predeterminada o asociar un agente afecta la ingestión
  nueva. No modifica automáticamente las llamadas históricas. Consulta a tu
  contacto de Zelto si necesitas migrar la atribución de llamadas existentes.
</Warning>

## Alcance de empresa en el panel

Selecciona una empresa en **Empresas**, en la barra lateral, para mantenerla en
el alcance mientras recorres el panel. La tarjeta de empresa en la parte
superior de la barra lateral permite cambiar de empresa, abrir su página o
volver a **Todos los agentes**.

Conversaciones, tasas/tendencias/resultados de monitores, hallazgos y sus
llamadas, trazas e informes operativos usan la empresa guardada en cada llamada.
Los agentes compartidos no incorporan llamadas de otras empresas. Se excluyen
llamadas sin atribución. Las trazas requieren un vínculo explícito o una referencia
de sesión única; se excluyen referencias ambiguas y trazas de varias empresas.

Los informes escritos son instantáneas de toda la organización y se ocultan al
seleccionar una empresa. Las comparaciones de modelos guardadas también abarcan
toda la organización; quita el filtro de empresa para verlas o ejecutarlas.
La configuración de agentes y vistas de herramientas
siguen describiendo agentes. Consulta los
[flujos operativos](/es/docs/guides/customer-evaluation-workflows).

El directorio Empresas muestra cada empresa, su cantidad de agentes asociados y
el número de llamadas atribuidas recibidas en los últimos siete días.

## Administrar empresas

Abre una empresa para alternar entre **Conversaciones** y **Agentes**. La pestaña
Conversaciones se abre de forma predeterminada y muestra las llamadas atribuidas
a esa empresa, de más reciente a más antigua, con el agente, motivo de fin,
duración y hora. Usa la paginación para ver llamadas anteriores, abre un ID de
referencia para ver los detalles o elige **Ver todas las conversaciones** para
abrir la lista completa filtrada por empresa. Las llamadas aparecen aunque su
agente no esté vinculado a la empresa.

Desde **Empresas**, puedes crear o cambiar el nombre de una empresa, asociar o
quitar agentes y elegir la empresa predeterminada de cada agente. También puedes
administrar las pertenencias de un agente desde su configuración.

Eliminar una empresa quita sus asociaciones con agentes y borra esa empresa de
sus llamadas. Los agentes y las llamadas permanecen en Zelto.

Para ver el procedimiento completo, consulta
[Configurar empresas](/es/docs/guides/set-up-companies).

### Logo de la empresa

Cada empresa tiene una marca junto a su nombre en la barra lateral, las listas y
los selectores. Hasta que agregues un logo, la marca muestra las iniciales de la
empresa sobre un color que se mantiene aunque cambies el nombre de la empresa.

Para cambiarla, abre la empresa y selecciona la marca junto al nombre:

* **Subir imagen**: un archivo PNG, JPEG o WebP de hasta 2 MB. Las imágenes
  cuadradas se ven mejor.
* **Usar URL de imagen**: un enlace `https` público a un logo que ya alojas, por
  ejemplo en tu sitio o CDN. Los logos SVG funcionan de esta forma.
* **Restablecer predeterminado**: elimina el logo y vuelve a las iniciales.

Si una imagen enlazada deja de cargar, Zelto muestra las iniciales.

También puedes administrar los logos con la API REST usando una
[clave de API](/es/docs/settings#claves-de-api) de la organización:

```bash theme={null}
# Subir un archivo de imagen
curl -X PUT "https://api.zelto.ai/v1/companies/$COMPANY_ID/logo" \
  -H "Authorization: Bearer $ZELTO_API_KEY" \
  -H "Content-Type: image/png" \
  --data-binary @logo.png

# Usar una imagen que alojas (envía null para quitarla)
curl -X PATCH "https://api.zelto.ai/v1/companies/$COMPANY_ID" \
  -H "Authorization: Bearer $ZELTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"logoUrl": "https://example.com/acme-logo.png"}'

# Quitar el logo
curl -X DELETE "https://api.zelto.ai/v1/companies/$COMPANY_ID/logo" \
  -H "Authorization: Bearer $ZELTO_API_KEY"
```

`GET /v1/companies` lista tus empresas con sus ids y el `logoUrl` actual. Las
subidas también aceptan `multipart/form-data` con la imagen en un campo `file`.

## Relacionado

* [Agentes](/es/docs/agents) — los agentes que pueden trabajar para una o varias
  empresas.
* [Conversaciones](/es/docs/conversations) — la vista exacta de empresa por
  llamada.
* [Proveedores personalizados y otros](/es/docs/integrations/api-call-upload) —
  envía un identificador de empresa con cada llamada cargada.
* [Configuración](/es/docs/settings) — el límite de cuenta a nivel de
  organización que contiene todas las empresas.
