Usuarios de API 🈸

Crea, edita, rota y revoca las claves de tus integraciones. Conoce sus límites y cómo guardar el secreto de forma segura.

Una API Key es una clave secreta que permite a otro sistema conectarse con Desk. Usa un nombre que identifique cada integración y revisa sus límites antes de compartir la clave con quien la implementa.

Necesitas un perfil Administrador. Ingresa a Administrador → Usuarios de API; la pantalla se identifica como Credenciales API.

Encuentra la clave que necesitas

En Credenciales, busca por nombre y utiliza Activas, Revocadas o Todas para revisar su estado. La tabla muestra quién creó cada clave, sus permisos, su nivel de riesgo y su límite de solicitudes.

Revisa el estado y el límite de la clave antes de editarla o abrir sus acciones.
Revisa el estado y el límite de la clave antes de editarla o abrir sus acciones.
  • Owner identifica al responsable asociado a la clave.
  • Legacy · congelado indica que una clave conserva su acceso histórico.
  • Riesgo clasifica el alcance de sus permisos; no indica que se haya detectado un incidente.
  • El identificador que comienza con sha256: ayuda a distinguir claves. No es el secreto que debes usar para conectar tu integración.
Si la pantalla indica que no es posible elegir permisos individuales, las claves nuevas reciben todos los permisos actuales de la API. Revisa con quién compartirás ese acceso antes de crear una.

Entiende los límites

RPM significa solicitudes por minuto: cuántas consultas o acciones puede pedir una integración en ese período.

Límite
Qué significa
Solicitudes por minuto de una clave
El máximo individual configurado para esa integración.
RPM compartido
La clave utiliza el límite compartido de la organización.
Límites de la organización
El máximo por minuto que se aplica sumando todas las claves.
Cuota total del plan
El total de solicitudes permitido durante el período indicado. Si aparece “sin límite”, sigue aplicándose el máximo por minuto.

Un límite individual no aumenta el límite de la organización. Por ejemplo, dos claves con límites de 100 solicitudes por minuto siguen sujetas al máximo conjunto que muestre Desk.

Crea una clave

  1. Selecciona Crear API Key.
  1. Escribe un Nombre reconocible, por ejemplo, “Integración de pedidos”. Admite hasta 100 caracteres, incluidos espacios y acentos. Si lo dejas vacío, se genera un nombre aleatorio.
  1. Completa Solicitudes por minuto (RPM) con un número entero de al menos 1, sin superar el máximo de la organización.
  1. Selecciona Continuar.
Un nombre reconocible facilita identificar qué sistema utiliza la clave.
Un nombre reconocible facilita identificar qué sistema utiliza la clave.

Confirma y guarda el secreto

  1. En Confirmar, revisa el nombre, el límite y el aviso de acceso. Usa Atrás si necesitas corregirlos.
  1. Selecciona Crear API Key para confirmar la creación.
  1. Cuando aparezca Guarda tu nueva API Key, utiliza Copiar clave o Descargar clave y guárdala en el lugar seguro que use tu organización para sus credenciales.
  1. Marca Ya guardé la clave en un lugar seguro y selecciona Terminar.
Confirma el límite y el acceso antes de emitir la clave. Conserva el secreto cuando aparezca: esta interfaz no volverá a mostrarlo después de cerrar.
Confirma el límite y el acceso antes de emitir la clave. Conserva el secreto cuando aparezca: esta interfaz no volverá a mostrarlo después de cerrar.

La nueva credencial aparece en el listado. Entrega el secreto solo a quien configura la integración, por un medio seguro; no lo incluyas en tickets, conversaciones de soporte ni capturas.

Edita el nombre o el límite

  1. Ubica la clave y selecciona Editar.
  1. Ajusta el Nombre y Solicitudes por minuto (RPM). Al editar, el nombre no puede quedar vacío.
  1. Si corresponde que utilice el límite común, activa Usar el RPM compartido del establecimiento.
  1. Selecciona Continuar, revisa el resumen y confirma con Guardar Cambios.
Puedes ajustar el límite individual o utilizar el compartido. Editar estos datos no reemplaza la clave secreta.
Puedes ajustar el límite individual o utilizar el compartido. Editar estos datos no reemplaza la clave secreta.

Después de guardar, comprueba el nombre y el límite en el listado.

Reemplaza o retira el acceso

Abre el menú de tres puntos de la clave para encontrar Rotar clave y Revocar clave. Antes de continuar, identifica todos los sistemas que la utilizan y coordina el cambio con su responsable.

Acción
Cuándo usarla
Consecuencia
Rotar clave
Necesitas reemplazar el secreto y mantener la integración.
El secreto anterior deja de funcionar inmediatamente. Debes guardar el nuevo y actualizar los sistemas que lo usan.
Revocar clave
La integración ya no debe tener acceso.
Retira el acceso inmediatamente y no se puede deshacer.

Para completar cualquiera de estas acciones, escribe el nombre exacto de la credencial en el diálogo y selecciona Confirmar. Cancelar permite salir sin ejecutarla.

Rotar reemplaza el secreto; prepara el cambio en todos los sistemas que dependen de esa clave.
Rotar reemplaza el secreto; prepara el cambio en todos los sistemas que dependen de esa clave.

Al rotar, guarda la nueva clave antes de cerrar y actualiza la integración. Al revocar, comprueba su estado utilizando el filtro Revocadas.

Las credenciales protegidas del sistema pueden tener Editar, Rotar clave o Revocar clave deshabilitados. No intentes reemplazarlas sin revisar su propósito con Soporte.

Resuelve dudas habituales

Cerré la ventana sin guardar el secreto

Esta interfaz no permite volver a mostrarlo. Coordina una rotación con quien mantiene la integración y guarda el nuevo secreto antes de cerrar. La rotación invalida el anterior.

No puedo continuar o guardar

Revisa el mensaje junto al campo. El RPM debe ser un entero positivo y no superar el límite de la organización. Un nombre compuesto solo por espacios no es válido. Si falló la carga de los límites, vuelve a intentarlo antes de decidir el valor.

Actividad API dice que el historial no está habilitado

Puedes seguir administrando claves. Este aviso significa que el historial no está disponible; no demuestra que las claves no se hayan usado ni equivale a cero solicitudes.

La disponibilidad del historial es independiente de la administración de credenciales.
La disponibilidad del historial es independiente de la administración de credenciales.

Probar API no permite enviar una solicitud

Si aparece El destino del tester no está configurado, la herramienta de pruebas necesita configuración adicional. Comparte el aviso con Soporte. No rotes ni revoques una clave para intentar resolver ese mensaje.

La columna MCP dice “Inactivo”

Ese indicador corresponde al acceso mediante MCP, un protocolo para conectar asistentes con herramientas. No es el estado general de la clave: revisa Activas o Revocadas para saber si conserva su acceso a la API.

Guías relacionadas y ayuda

Si necesitas ayuda, contáctanos desde el chat de Desk, por WhatsApp al +56 9 4918 3115 o por soporte@adere.so. Comparte el nombre de la credencial y el mensaje de error, nunca la clave secreta.

Conversemos

¿Tu integración necesita acceso a Desk y no sabes cómo administrarlo? Conversemos sobre qué sistema quieres conectar y cómo gestionar sus usuarios de API sin compartir credenciales personales.

¿Esto respondió tu pregunta?
😞
😐
🤩