Requisitos previos
- Tus agentes ya existen en Zelto. Consulta el Inicio rápido si todavía no conectaste un proveedor.
- Un propietario o administrador de la organización habilitó Empresas en Configuración → Organización. Si eres miembro y no aparece en la barra lateral, pide a un propietario o administrador que la habilite.
- Sabes si tu integración puede enviar un identificador estable de cliente o marca en cada conversación. Usa siempre esa señal cuando un agente atienda a varias empresas.
1. Crea cada empresa
Abre Empresas en la barra lateral y selecciona Nueva empresa. Escribe el nombre del cliente o de la marca y créala. Los nombres de empresa deben ser únicos dentro de tu organización. También puedes usar el + junto a Empresas en la barra lateral o crear una empresa desde el campo Empresas de la configuración de un agente.2. Asocia los agentes que trabajan para ella
Abre la empresa, cambia a la pestaña Agentes, selecciona Añadir agentes y elige todos los agentes que trabajan para ese cliente. Un agente puede pertenecer a varias empresas. También puedes realizar la misma asignación desde Agentes → [agente] → Configuración → Empresas. Quitar una asociación no elimina el agente ni sus conversaciones.3. Elige un valor predeterminado cuando necesites una alternativa
En la pestaña Agentes, selecciona la estrella junto a un agente asociado para establecer esta como su empresa predeterminada. Cada agente puede tener como máximo una empresa predeterminada. Usa un valor predeterminado cuando todas o la mayoría de las conversaciones del agente pertenezcan a una empresa y el proveedor no envíe un identificador de empresa. No dependas del valor predeterminado para separar entre clientes las conversaciones de un agente compartido; envía un identificador con cada conversación.4. Envía un identificador de empresa con las conversaciones de agentes compartidos
Si cargas conversaciones en/webhooks/calls, añade companyExternalId en el nivel
superior del cuerpo de cada conversación:
companyExternalId o
una clave de metadatos de nivel superior compatible, como company_id,
cliente_id, empresa_id o project_id. También admiten
metadata.contexto.company_id como cadena o entero JSON seguro, por ejemplo
42. Los números se convierten en cadenas decimales; se ignoran fracciones y
enteros fuera del rango seguro. Un companyExternalId canónico válido tiene
prioridad sobre los IDs de metadatos de nivel superior, y estos sobre el campo
anidado. Las cadenas distinguen mayúsculas y conservan los ceros iniciales.
5. Verifica el resultado
Realiza o carga una conversación nueva y después:- Abre Empresas y confirma que aumentó el contador Conversaciones (7 d) de la empresa.
- Selecciona la empresa en la barra lateral.
- Abre Conversaciones y confirma que aparece la conversación.
- Vuelve a Todos los agentes para borrar el alcance de empresa.
Solución de problemas
Empresas no aparece
La función no está habilitada para tu organización. Un propietario o administrador puede habilitarla en Configuración → Organización.Una conversación no está atribuida
Comprueba que la carga contenga uncompanyExternalId estable y no vacío. Si no
lo contiene, confirma que el agente de la conversación tenga una empresa
predeterminada. La pertenencia a una empresa sin que sea la predeterminada no
basta para atribuir la conversación.
Todas las conversaciones de un agente compartido van a una sola empresa
Probablemente el proveedor no está enviando un identificador de empresa con cada conversación, por lo que todas usan el valor predeterminado del agente. EnvíacompanyExternalId en cada conversación.
Las conversaciones existentes no aparecen en la empresa
La empresa se asigna durante la ingestión. Crear una empresa, asociar un agente o elegir un valor predeterminado no modifica las conversaciones anteriores. Consulta a tu contacto de Zelto sobre una migración de la atribución histórica.Otras páginas incluyen actividad de otra empresa
Conversaciones filtra por la empresa guardada en cada conversación. Otras páginas con alcance de empresa pueden filtrar por agentes asociados, así que un agente compartido puede incluir actividad de otra empresa. Usa Conversaciones cuando necesites una separación exacta por conversación.Relacionado
- Empresas — el modelo completo y las reglas de atribución.
- Agentes — cómo identifica y administra agentes Zelto.
- Conversaciones — filtra las conversaciones exactas atribuidas a una empresa.
- Proveedores personalizados y otros — ejemplos completos de carga de conversaciones y reglas de validación.

