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.
- 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
- Selecciona Crear API Key.
- 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.
- Completa Solicitudes por minuto (RPM) con un número entero de al menos 1, sin superar el máximo de la organización.
- Selecciona Continuar.
Confirma y guarda el secreto
- En Confirmar, revisa el nombre, el límite y el aviso de acceso. Usa Atrás si necesitas corregirlos.
- Selecciona Crear API Key para confirmar la creación.
- 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.
- Marca Ya guardé la clave en un lugar seguro y selecciona Terminar.
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
- Ubica la clave y selecciona Editar.
- Ajusta el Nombre y Solicitudes por minuto (RPM). Al editar, el nombre no puede quedar vacío.
- Si corresponde que utilice el límite común, activa Usar el RPM compartido del establecimiento.
- Selecciona Continuar, revisa el resumen y confirma con Guardar Cambios.
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.
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.
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
- Autenticación [Desarrolladores]: referencia para quien configura la conexión.
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.