Clientes, equipo y accesos — Manual del operador | AI Agent Builder

Capítulo 8

Clientes, equipo y accesos

Tenants de clientes, límites y funcionalidades por tenant, usuarios y roles, claves de API y aplicaciones conectadas.

6 min de lectura · Actualizado 10 de noviembre de 2026

Este capítulo en video · 2:34 · en inglés, con subtítulos · Todos los videos del manual

Nortelink opera agentes para varios clientes desde una sola instalación. Cada cliente tiene que ver solo lo suyo, la agencia tiene que poder entrar a todos, alguien tiene que pagar el consumo y algunas personas del cliente tienen que poder trabajar sin poder romper nada. Este capítulo explica cómo se resuelve cada una de esas cosas, siguiendo el alta de Clínica del Sol.

Dar de alta un cliente

Lucía, propietaria de Nortelink, crea la cuenta de la clínica desde Administración → Cuentas como hija de Nortelink. En ese momento pasan cuatro cosas:

  1. La clínica queda en el árbol debajo de Nortelink. Su ruta empieza con la de Nortelink (capítulo 1).
  2. Su facturación arranca como ilimitada, lo que en un hijo significa que paga el padre: el consumo de la clínica se descuenta del saldo de Nortelink hasta que alguien cambie el modo.
  3. Lucía pasa a ser propietaria heredada de la clínica. No hace falta asignarla: la propiedad baja por el árbol.
  4. La clínica hereda modelos solo si un super admin activa la herencia de conexiones para ella. Si no, tiene que tener conexiones propias antes de que sus agentes puedan responder.

Para poder crear la cuenta, Nortelink tiene que tener habilitados los tenants hijos y lugar dentro de su límite de hijos.

Detalle de la cuenta de Clínica del Sol: recursos, suscripción y configuración
Detalle de la cuenta de Clínica del Sol: recursos, suscripción y configuración

Quién paga: los modos de facturación

Cada tenant tiene uno de tres modos:

  • Prepago. Tiene saldo propio. Cada ejecución lo descuenta; con saldo en cero, deja de responder (capítulo 7).
  • Pospago. Consume y se factura después.
  • Ilimitado. En un tenant hijo, el consumo lo paga el ancestro. Es el modo con el que nace todo tenant.

Para una agencia, la decisión es si cada cliente paga lo suyo (prepago o pospago, con su propio saldo) o si la agencia absorbe el consumo y lo factura por fuera (ilimitado). Los planes permiten empaquetar esa decisión junto con límites y funcionalidades y aplicarla al asignar el plan; administrarlos es tarea de un super admin.

Límites y funcionalidades

Cada tenant tiene límites de recursos: usuarios, agentes, tenants hijos, profundidad del árbol, almacenamiento y endpoints de webhook. Un límite en 0 significa sin límite. Se controlan al crear: invitar un usuario de más, crear un agente de más o subir un documento que excede el almacenamiento falla con un error de cuota.

Las funcionalidades son interruptores: canales (voz, WhatsApp, Slack, Teams, Instagram), asistentes, editor de workflows, skills, integraciones, plantillas, API, planificador, generación de imágenes y otros. Lo que no está habilitado no aparece en el menú y su API lo rechaza.

¿Puede la agencia encender funcionalidades en sus clientes? Solo si se cumplen tres condiciones:

  1. Un super admin habilitó para la agencia la gestión de funcionalidades de hijos.
  2. La funcionalidad que se quiere encender está habilitada en la propia agencia.
  3. Ningún ancestro la tiene apagada.

La regla es que un tenant nunca puede dar a sus hijos algo que él no tiene. En el ejemplo: si Lucía intenta encender la voz en la clínica sin que Nortelink tenga la gestión de funcionalidades habilitada, la plataforma lo rechaza.

Límites, límites por minuto, planes y suscripciones los administra un super admin.

Límites por minuto

En Configurar → Límites de Tasa, un super admin define cuántos pedidos por minuto acepta cada tenant de chat (30 por defecto), de API (60) y de webhooks (200). Un tenant sin valores propios hereda los del ancestro más cercano que los tenga: la pantalla muestra de quién los hereda, y Volver a Heredado borra los propios. Los cambios tardan hasta un minuto en aplicarse.

La pantalla aparece en el menú para todos, pero solo un super admin la puede abrir. El campo Sesiones Concurrentes se guarda, pero hoy no limita nada.

Límites por minuto de un tenant, heredados de la agencia
Límites por minuto de un tenant, heredados de la agencia

Usuarios e invitaciones

Para sumar a alguien de la clínica, Lucía lo invita con su correo, el rol y el idioma. La invitación se manda por correo y vale 72 horas; se puede reenviar, con un minuto de espera entre reenvíos. Un usuario que no es super admin solo puede invitar a la cuenta que tiene activa.

El rol se elige pensando en qué tiene que poder hacer esa persona (la tabla completa está en el capítulo 1):

  • Lector para quien solo mira: el dueño de la clínica que quiere ver conversaciones y feedback.
  • Administrador para quien trabaja: la persona que mantiene la base de conocimiento y ajusta instrucciones. No puede borrar recursos ni administrar usuarios.
  • Propietario para quien administra la cuenta. Tené en cuenta que también puede borrar.

Para el equipo de la clínica, la recomendación habitual es administradores. Los propietarios conviene que sean de la agencia, y que lo sean por herencia desde Nortelink.

Usuarios de la cuenta con su rol y sus asignaciones
Usuarios de la cuenta con su rol y sus asignaciones

Claves de API

Las claves de API son para sistemas, no para personas: una integración del cliente que llama al agente por REST, una automatización que consulta el historial.

  • Tienen la forma sk_…. La plataforma guarda solo un hash: la clave completa se muestra una sola vez, al crearla, y después solo se ven sus primeros caracteres.
  • Tienen un rol —lector, administrador o propietario— y un conjunto de permisos acotados de una lista fija. Una clave con permisos amplios y rol de lector sigue sin poder escribir.
  • Pueden tener vencimiento, de hasta dos años.

Crear claves requiere que el tenant tenga habilitadas las claves de API. La clave pública del widget es un caso aparte: solo sirve para el chat web (capítulo 6).

Aplicaciones conectadas

Además de las claves, la plataforma es un servidor OAuth: un cliente como Claude Code, Codex o Cursor puede conectarse al admin pidiendo permiso, sin que nadie cree una clave. En la pantalla de consentimiento la persona elige a qué cuentas da acceso (y si incluye las hijas), con qué permisos y con qué rol máximo.

  • El permiso dura 30 días. El token de acceso dura 10 minutos y se renueva solo.
  • Cada persona ve y revoca sus aplicaciones en API Keys y accesos → Aplicaciones conectadas.

La guía Conectá tu asistente de IA recorre ese alta paso a paso.

Dónde termina

  • Límites, planes y límites por minuto son de super admin. Un propietario de agencia no los puede ajustar para sus clientes.
  • La gestión de funcionalidades de hijos está apagada por defecto y la habilita un super admin.
  • En el consentimiento OAuth el rol elegido tiene que coincidir con el que la persona tiene en esa cuenta.
  • No existe un "copiar este agente a todos mis clientes": un agente se lleva a otro tenant exportándolo e importándolo (capítulo 3).

Para revisar

  • Cada cliente cuelga del padre correcto y tiene el modo de facturación que corresponde: un hijo en ilimitado lo está pagando la agencia.
  • Los usuarios del cliente son administradores o lectores; los propietarios son de la agencia.
  • No hay invitaciones vencidas pendientes de reenviar.
  • Cada clave de API tiene vencimiento, el rol mínimo que necesita y una etiqueta que dice para qué es.
  • Las aplicaciones conectadas que nadie usa hace semanas están revocadas.