1. [Ayuda](https://nuvia.ai/es/docs) 2. [Configuración de la Cuenta](https://nuvia.ai/es/docs/colecoes/19430666-configuracion-de-la-cuenta) # Cómo gestionar API keys en Nuvia Crea, organiza y revoca credenciales de API para conectar sistemas externos a Nuvia, con alcances de permiso granulares y revocación inmediata en cualquier momento. Disponible en Todos los planes. Quién puede hacerlo Administradores de la cuenta Actualizado el 9 de septiembre de 2026 [Configuración de la Cuenta](https://nuvia.ai/es/docs/colecoes/19430666-configuracion-de-la-cuenta) 1. [Cómo activar la verificación en dos pasos (MFA)](https://nuvia.ai/es/docs/artigos/18174510-como-activar-la-verificacion-en-dos-pasos-mfa) 2. [Cómo marcar tu disponibilidad (Ausente o No disponible)](https://nuvia.ai/es/docs/artigos/18174522-como-marcar-tu-disponibilidad-ausente-o-no-disponible) 3. [Cómo gestionar API keys en Nuvia](https://nuvia.ai/es/docs/artigos/15230128-como-gestionar-api-keys-en-nuvia) 4. [Cómo desactivar y reactivar un usuario](https://nuvia.ai/es/docs/artigos/16497565-como-desactivar-y-reactivar-un-usuario) 5. [Seguridad, privacidad y LGPD en Nuvia](https://nuvia.ai/es/docs/artigos/14576039-seguridad-privacidad-y-lgpd-en-nuvia) 6. [Cómo crear y gestionar equipos en Nuvia](https://nuvia.ai/es/docs/artigos/15649230-como-crear-y-gestionar-equipos-en-nuvia) Las API keys son credenciales que permiten que sistemas externos se autentiquen en la API de Nuvia en nombre de tu empresa. Cada clave tiene sus propios alcances de permiso y se puede revocar cuando quieras. **Disponible en:** Todos los planes. **Quién puede hacerlo:** Administradores de la cuenta. ## Antes de empezar - Confirma que tu perfil tiene acceso de administrador. - Ten un lugar seguro para guardar el token, como un gestor de secretos. El token se muestra **una sola vez**, al momento de crearlo; después no hay forma de volver a verlo. ### Acceder a la página de API Keys 1. En el **Menú lateral**, haz clic en los 3 puntos junto al ícono de perfil 2. Haz clic en la opción **Configuración** 3. En el **Menú lateral**, haz clic en **API Keys** La lista muestra todas las API keys de tu empresa, con **nombre**, **alcances**, vista previa del token (los 4 últimos caracteres), **fecha de creación**, **vencimiento**, **último uso** y **estado**. ### Crear una nueva API key 1. En la página de API Keys, haz clic en **Nueva API Key**. 2. Completa el **Nombre**; usa algo descriptivo que identifique la integración (ej.: “CRM Integration”, “Dashboard BI”). 3. Selecciona los **Alcances** a los que podrá acceder esta clave (mira la lista completa en la sección **Alcances de permiso disponibles**, más abajo). 4. (Opcional) Define un **Vencimiento** eligiendo una fecha futura en el calendario. Si lo dejas en blanco, la clave **no vence**. 5. Haz clic en **Crear API Key**. 6. Haz clic en **Copiar token** para copiar el JWT al portapapeles. 7. Guarda el token en un lugar seguro. 8. Haz clic en **Cerrar**. El token se muestra **solo una vez**. Después de cerrar el modal, no se puede volver a ver; la única referencia en la lista es el sufijo de 4 caracteres (columna **Preview**). Si pierdes el token, tendrás que revocar la clave y crear una nueva. **Consejo:** Si intentas cerrar el modal sin copiar el token, Nuvia muestra un aviso de confirmación. Vuelve y cópialo antes de continuar. ### Alcances de permiso disponibles Cada alcance habilita un conjunto de acciones sobre un recurso de la API. Eliges los alcances al momento de crear la clave. RecursosAcciones disponibles **Agentes** Leer, Crear, Actualizar, Eliminar **Contactos** Leer, Crear, Actualizar, Eliminar **Conversaciones** Leer, Crear, Actualizar **Campañas** Leer, Crear, Actualizar, Eliminar **Mensajes** Leer, Enviar **Bandejas de entrada** Leer, Crear, Actualizar, Eliminar **Tablas** Leer, Crear, Actualizar, Eliminar **Tools de agente** Leer, Crear, Actualizar, Eliminar **Seguimientos de agente** Leer, Crear, Actualizar, Eliminar **Notas de contacto** Leer, Crear, Actualizar **Inscripciones de campaña** Leer, Crear **Campos personalizados** Leer, Actualizar valor **Base de conocimiento** Leer, Crear, Actualizar **Webhooks** Leer, Crear, Actualizar, Eliminar **Búsqueda** Consultar, Enriquecer y guardar **Búsqueda LinkedIn** Consultar, Guardar **Enriquecimiento** Consultar, Ejecutar **Triggers de campaña** Disparar Importante los alcances se definen al crear la clave y no se pueden cambiar después. Si necesitas permisos diferentes, crea una nueva clave con los alcances que quieras y revoca la anterior. ### Qué habilitan los alcances de Campos personalizados Los alcances de **Campos personalizados** sirven para que una integración **guarde valores** en campos que ya existen, no para crear o borrar la definición del campo. AlcanceQué puede hacer la clave **Campos custom — Leer** Listar los campos personalizados de la empresa (para descubrir el identificador de cada uno) y listar las opciones activas de un campo de lista desplegable o de opción múltiple **Campos custom — Actualizar valor** Guardar el valor de un campo personalizado en una conversación, en su contacto o en la empresa del contacto Importante crear, editar o eliminar la **definición** de un campo personalizado (y sus opciones) sigue siendo una acción de un usuario conectado a la plataforma, con el permiso de Campos personalizados. Una API key no lo hace, aunque tenga los dos alcances marcados. Por eso se eliminaron los alcances “Campos custom — Crear” y “Campos custom — Eliminar”, que aparecían en la lista sin ninguna operación detrás. Al guardar valores, ten en cuenta: - El campo se identifica por el **slug** (el identificador que aparece en la lista de campos), no por el ID interno. - La **conversación es obligatoria** en la llamada, incluso cuando el campo es de contacto o de empresa: a partir de la conversación Nuvia encuentra el contacto y la empresa. - Los campos de texto, número y fecha reciben el valor directamente. Los campos de lista desplegable y de opción múltiple reciben el **identificador de la opción**, que viene de la lista de opciones del campo. - Un valor fuera de las opciones aceptadas se rechaza, y la respuesta trae la lista de valores válidos. - Un campo o una conversación de otra empresa se rechaza. ### Disparar campañas desde un CRM propio (alcance Triggers de campaña) El alcance **Triggers de campaña — Disparar** habilita el endpoint que permite que un **CRM propio o una automatización** (n8n, Zapier o una llamada directa a la API) **dispare campañas** en Nuvia a partir de eventos de tu CRM: contacto creado o actualizado, negocio (deal) creado o actualizado y lead creado o actualizado. Úsalo cuando tu CRM no es uno de los integrados de forma nativa (HubSpot o RD Station) y quieres que active campañas en Nuvia. La automatización envía el contacto (con teléfono) y los datos del evento, y Nuvia inscribe el contacto en las campañas configuradas. Importante al disparar por este endpoint, el contacto se localiza por el **teléfono** y su vínculo de CRM pasa a apuntar a la integración que hizo el disparo. Si el contacto ya pertenecía a otra integración (por ejemplo, HubSpot), la sincronización anterior deja de aplicar para él. Usa un teléfono en formato internacional (E.164, ej.: +5511999999999). Consejo para evitar disparos duplicados cuando tu automatización repite la llamada, envía un **identificador de idempotencia** — las repeticiones dentro de 24 horas se ignoran. ### Filtrar y buscar API keys Usa los filtros en la esquina superior derecha de la página para alternar entre: - **Activas**: claves que pueden autenticar solicitudes (vista predeterminada). - **Revocadas**: claves desactivadas de forma permanente. - **Todas**: muestra activas y revocadas. También puedes encontrar una clave por **nombre** con el campo de búsqueda. ### Revocar una API key La revocación desactiva la clave de forma permanente. Úsala cuando una integración se discontinúe, cuando vayas a rotar credenciales o cuando sospeches de una filtración. 1. En la lista, ubica la API key que quieres revocar. 2. Haz clic en el menú de acciones (**⋮**) a la derecha de la fila. 3. Haz clic en **Revocar**. 4. En el modal de confirmación, completa la **Justificación** (ej.: “integración discontinuada”, “key filtrada”, “rotación de credenciales”). 5. Haz clic en **Revocar API Key**. 6. La clave deja de autenticar solicitudes de inmediato. Importante la revocación es **permanente y no se puede deshacer**. La clave entra en una lista negra y ningún sistema que la use podrá volver a autenticarse. Actualiza el token en el sistema externo **antes** de revocar la clave anterior. ### Estado de una API key EstadoColor en la interfazQué significa **Activa** Verde La clave funciona y autentica solicitudes normalmente. **Vencida** Rojo La fecha de vencimiento configurada ya pasó; la clave ya no autentica. Crea una nueva para continuar. **Revocada** Gris Un usuario desactivó la clave de forma permanente y ya no autentica. Nota Si la cuenta está en el **período de prueba (trial)** y el trial vence, todas las API keys de la empresa dejan de autenticar — aunque aparezcan como **Activas** en la lista y no tengan fecha de vencimiento configurada. El bloqueo sigue el **estado de la suscripción en tiempo real**, no una fecha guardada en la clave: desaparece automáticamente en cuanto la cuenta vuelve a estar activa (contratación del plan). ## Preguntas frecuentes ## Preguntas frecuentes **¿Cuántas API keys puedo crear por empresa?** No hay límite. Crea todas las que necesites. Lo recomendable es usar **una clave por integración o sistema externo**, lo que facilita la gestión y la trazabilidad. **Perdí el token JWT. ¿Puedo recuperarlo?** No. Por seguridad, Nuvia no almacena el JWT completo. La única opción es revocar la clave actual y crear una nueva. Usa el sufijo de 4 caracteres (columna **Preview**) para identificar qué clave hay que reemplazar. **¿Puedo editar los alcances de una API key existente?** No. Los alcances se definen al momento de la creación y no se pueden cambiar después. Si necesitas alcances diferentes, crea una nueva clave con los permisos que quieras y revoca la anterior. **Los alcances “Campos custom — Crear” y “Campos custom — Eliminar” desaparecieron de la lista. ¿Adónde fueron?** Se eliminaron porque no había ninguna operación de API detrás de ellos: eran alcances que se podían marcar y no habilitaban nada. Crear y eliminar un campo personalizado (y sus opciones) es una acción de usuario en la plataforma, no de API key. Si tenías una clave con esos alcances marcados, nada cambia en la práctica — la integración nunca pudo crear ni eliminar campos con ellos. **Aparecieron nuevos alcances de Base de conocimiento y Webhooks. ¿Son funciones nuevas?** No. Esos endpoints ya aceptaban API key; lo que faltaba era que la lista de alcances de la pantalla lo mostrara, así que nadie sabía que podía pedirlos. Ahora aparecen agrupados en **Base de conocimiento** y **Webhooks** al crear la clave. Lo mismo vale para los alcances de Tools de agente, Seguimientos de agente, Notas de contacto y Bandejas de entrada — Eliminar. **¿Qué pasa con las solicitudes en curso cuando revoco una clave?** La revocación es inmediata: cualquier solicitud que use el token revocado se rechaza a partir de ese momento. Actualiza el token en el sistema externo antes de revocar la clave anterior. **La columna “Último uso” no muestra fecha. ¿Qué significa?** Significa que la clave todavía no se usó en ninguna solicitud desde su creación. La fecha se completa automáticamente después del primer uso. **¿Para qué sirve el alcance “Triggers de campaña”?** Habilita el disparo de campañas desde un CRM propio o una automatización (n8n, Zapier o llamada directa), sin depender de las integraciones nativas. Al recibir un evento (contacto, negocio o lead creado/actualizado), Nuvia localiza el contacto por el teléfono y lo inscribe en las campañas configuradas. Concede este alcance solo a la clave que usa esa automatización. **¿La API key y la conexión por MCP son lo mismo?** No. La **API key** es una credencial (token JWT) para integraciones de sistema a sistema con la API de Nuvia. El **MCP** conecta aplicaciones de IA (como Claude y Cursor) mediante autorización OAuth, con inicio de sesión en la propia pantalla de Nuvia (sin generar una API key). Usa la API key para integrar servidores y sistemas; usa MCP para conectar clientes de IA. **Mi integración dejó de funcionar de repente, pero la clave aparece como Activa. ¿Por qué?** El motivo más común es el fin del período de prueba (trial) de la cuenta: mientras el trial está vencido, ninguna API key de la empresa autentica, sin importar el estado que muestra la lista ni el vencimiento configurado. Contrata un plan para reactivar la cuenta — el acceso de la clave vuelve solo, sin necesidad de recrearla. [AnteriorCómo marcar tu disponibilidad (Ausente o No disponible)](https://nuvia.ai/es/docs/artigos/18174522-como-marcar-tu-disponibilidad-ausente-o-no-disponible) [SiguienteCómo desactivar y reactivar un usuario](https://nuvia.ai/es/docs/artigos/16497565-como-desactivar-y-reactivar-un-usuario) ¿Te ayudó este artículo? ## Artículos relacionados - [Cómo conectar WhatsApp en Nuvia](https://nuvia.ai/es/docs/artigos/14489425-como-conectar-whatsapp-en-nuvia) - [Cómo crear habilidades personalizadas para el agente de IA](https://nuvia.ai/es/docs/artigos/14590394-como-crear-habilidades-personalizadas-para-agente-de-ia) - [Referencia de las herramientas MCP de Nuvia](https://nuvia.ai/es/docs/artigos/16074574-referencia-herramientas-mcp-de-nuvia) - [Qué sincroniza Nuvia con HubSpot y cuándo](https://nuvia.ai/es/docs/artigos/16473526-que-sincroniza-nuvia-con-hubspot-y-cuando) [Configuración de la Cuenta](https://nuvia.ai/es/docs/colecoes/19430666-configuracion-de-la-cuenta) 1. [Cómo activar la verificación en dos pasos (MFA)](https://nuvia.ai/es/docs/artigos/18174510-como-activar-la-verificacion-en-dos-pasos-mfa) 2. [Cómo marcar tu disponibilidad (Ausente o No disponible)](https://nuvia.ai/es/docs/artigos/18174522-como-marcar-tu-disponibilidad-ausente-o-no-disponible) 3. [Cómo gestionar API keys en Nuvia](https://nuvia.ai/es/docs/artigos/15230128-como-gestionar-api-keys-en-nuvia) 4. [Cómo desactivar y reactivar un usuario](https://nuvia.ai/es/docs/artigos/16497565-como-desactivar-y-reactivar-un-usuario) 5. [Seguridad, privacidad y LGPD en Nuvia](https://nuvia.ai/es/docs/artigos/14576039-seguridad-privacidad-y-lgpd-en-nuvia) 6. [Cómo crear y gestionar equipos en Nuvia](https://nuvia.ai/es/docs/artigos/15649230-como-crear-y-gestionar-equipos-en-nuvia) ## ¿Todavía necesitas ayuda? Los clientes hablan con soporte por el chat dentro de la plataforma. ¿Aún no eres cliente? Habla con nuestro equipo. [Hablar con soporte en la plataforma](https://app.nuvia.ai) [Aún no soy cliente](https://nuvia.ai/es/contact) --- Source: https://nuvia.ai/es/docs/artigos/15230128-como-gestionar-api-keys-en-nuvia