Autenticación
Para utilizar la API de Fonema.ai, necesitas una clave API que autentique tus solicitudes. Sigue estos pasos para generar y administrar tus claves.
Generar una nueva API Key
-
Accede al Dashboard
- Inicia sesión en tu cuenta de Fonema.ai
- Navega a la sección de Configuración → Claves API
-
Crear nueva clave
- Haz clic en el botón "Agregar API Key"
-
Configurar la clave
- Nombre descriptivo: Asigna un nombre que te ayude a identificar el propósito de esta clave (ej: "App de producción", "Testing interno")
- Alcance (scope): Elige el nivel de acceso de esta clave (consulta Alcances de la clave más abajo)
- Haz clic en "Crear API Key" para completar el proceso
Alcances de la clave
Al crear una API Key eliges su alcance (scope), que determina a cuántos de tus agentes puede acceder la clave:
| Alcance | Etiqueta en el dashboard | Acceso |
|---|---|---|
| Todos los agentes | Todos los agentes | Acceso a toda la empresa. La clave puede leer, crear y editar todos los agentes de tu empresa, incluidos los que crees más adelante. Úsala para integraciones de administración o backend. |
| Agentes específicos | Agentes específicos | Acceso restringido. La clave solo puede acceder a los agentes que selecciones explícitamente. Los agentes creados a través de la API con esta clave se agregan automáticamente a su lista de agentes permitidos. |
tip
Usa una clave de Todos los agentes cuando necesites una sola clave para administrar toda tu cuenta de forma programática. Usa una clave de Agentes específicos para limitar una clave a un subconjunto de agentes (recomendado para claves compartidas con terceros).
Uso de la API Key
Una vez que tengas tu API Key, debes incluirla en todas las solicitudes a la API mediante el header de autorización:
Header de Autenticación
Authorization: Bearer TU_API_KEY_AQUÍ