Los Tokens de Acceso y las Claves de Aplicación son las credenciales que permiten que otras herramientas —incluidos Asistentes de IA e integraciones personalizadas— se conecten a tus datos de CompanyCam. Este artículo explica los dos tipos de credenciales, sus niveles de permiso, y cómo crearlas, verlas y revocarlas.
Importante: Esta función está disponible en planes selectos y solo en la aplicación web.
Token de Acceso Personal vs. Clave de Aplicación
Hay dos tipos de credenciales:
Token de Acceso Personal: vinculado a ti como Usuario individual. Actúa como tú y solo puede hacer lo que tu cuenta puede hacer. Úsalo para conectar una herramienta de IA a través de un MCP Server, o para cualquier otra conexión rápida y personal en la que la integración deba actuar como tú.
Clave de Aplicación: vinculada a una Aplicación registrada, no a una persona. Úsala para integraciones de socios y para integraciones personalizadas a nivel empresarial que deban identificarse como una app en lugar de como una persona.
Elige un Token de Acceso Personal cuando una sola persona quiera conectar una herramienta a su propia cuenta. Elige una Clave de Aplicación cuando la conexión deba identificarse como una app en lugar de como una persona.
Nota: Si estás conectando una herramienta de IA a través de un MCP Server, usa un Token de Acceso Personal. Los Tokens de Acceso Personal nuevos son de Solo lectura de forma predeterminada, así que cambia el tuyo a Lectura y escritura, o la herramienta de IA no podrá hacer cambios.
Niveles de permiso
Cada token o clave se crea con uno de estos niveles:
Solo lectura — puede ver, pero no cambiar nada
Lectura y escritura — lectura, más creación y actualización
Acceso completo — lectura, escritura y eliminación
Personalizado — elige permisos específicos por recurso
Un token o clave nunca puede hacer más de lo que puede hacer la cuenta que lo creó, sin importar el nivel de permiso que elijas.
Creando un Token de Acceso Personal
Nota: Solo los Admins y Managers pueden crear un token o una clave.
Haz clic en Integraciones en el menú de la izquierda y luego haz clic en Tokens de Acceso.
Haz clic en Nuevo Token de Acceso Personal.
Asígnale un nombre, agrega una descripción opcional, elige un nivel de permiso y establece un vencimiento.
Haz clic en Crear token y luego copia el token.
Creando una Clave de Aplicación
Nota: Solo los Admins y Managers pueden crear un token o una clave.
Las Claves de Aplicación están vinculadas a una Aplicación registrada. Si aún no has registrado una, hazlo primero. Consulta Registrando una Aplicación.
Haz clic en Integraciones en el menú de la izquierda y luego haz clic en Tokens de Acceso.
Haz clic en Nueva Clave de Aplicación.
Selecciona la Aplicación a la que pertenece.
Asígnale un nombre, agrega una descripción opcional, elige un nivel de permiso y establece un vencimiento.
Haz clic en Crear token y luego copia la clave.
Estableciendo un vencimiento
Los tokens y claves se pueden configurar para vencer en 7, 30, 60 o 90 días, o Sin expiración. Los nuevos vencen en 30 días de forma predeterminada.
Revocando un token o clave
Importante: Una Clave de Aplicación actúa como el Usuario que la creó. Si esa persona es desactivada, la clave deja de funcionar. Antes de desactivar a alguien vinculado a una integración activa, reasigna o vuelve a crear la clave primero.
Revoca un token o una clave en cualquier momento desde la página de Tokens de Acceso. Trátalo como una contraseña: si alguna vez se expone, revócalo y crea uno nuevo.
Nota: Es posible que todavía veas una página de Tokens de Acceso anterior debajo de tu Ícono de Usuario que muestra los tokens personales y de aplicación juntos. Esa página se está retirando a medida que los clientes pasan a la nueva.
Preguntas frecuentes
¿Cuál es la diferencia entre los dos tipos de credenciales?
¿Cuál es la diferencia entre los dos tipos de credenciales?
Un Token de Acceso Personal actúa como tú y está vinculado a tu cuenta de Usuario. Una Clave de Aplicación actúa como una Aplicación registrada en lugar de actuar como una persona.
¿Las Claves de Aplicación requieren una Aplicación registrada?
¿Las Claves de Aplicación requieren una Aplicación registrada?
Sí, las Claves de Aplicación requieren una Aplicación registrada. Consulta Registrando una Aplicación para instrucciones paso a paso.
¿Qué pasa cuando un token o una clave vence?
¿Qué pasa cuando un token o una clave vence?
El token o la clave deja de funcionar en cuanto vence. Crea uno nuevo, o establece el vencimiento en Sin expiración si la integración necesita seguir funcionando de forma indefinida.
¿Puede un token hacer más de lo que puede hacer mi cuenta?
¿Puede un token hacer más de lo que puede hacer mi cuenta?
Un token no puede hacer más de lo que puede hacer la cuenta que lo creó, sin importar el nivel de permiso seleccionado.
¿Por qué mi herramienta de IA no puede hacer cambios después de conectarse?
¿Por qué mi herramienta de IA no puede hacer cambios después de conectarse?
Los Tokens de Acceso Personal son de Solo lectura de forma predeterminada. Cambia el token a Lectura y escritura si necesitas que la herramienta de IA cree o actualice datos.
¿Quién puede crear o revocar un token?
¿Quién puede crear o revocar un token?
Los Admins y Managers pueden crear y revocar tokens y claves. Los Usuarios Standard no pueden crear tokens.
¿Qué pasa con los tokens de la página anterior de Tokens de Acceso?
¿Qué pasa con los tokens de la página anterior de Tokens de Acceso?
Los tokens existentes de la página anterior de Tokens de Acceso siguen funcionando. Los tokens y claves nuevos deben crearse desde la nueva página de Tokens de Acceso en adelante.
¿Qué recursos hay disponibles si estoy creando una integración personalizada?
¿Qué recursos hay disponibles si estoy creando una integración personalizada?
Si estás creando una integración personalizada desde cero, consulta Creando Integraciones Personalizadas con la API de CompanyCam para más información.
💡 ¿Necesitas más ayuda?
Contacta a nuestro Equipo de Soporte — estamos disponibles de lunes a viernes.
La Comunidad de CompanyCam ofrece ejemplos reales de obras, plantillas y consejos de equipos que utilizan la herramienta a diario. Únete para hacer una pregunta o simplemente para explorar.