Primeros pasos

URL base

Todas las solicitudes a la API de Fonema deben realizarse al endpoint base: https://api.fonema.ai/

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

1. Accede al Dashboard

   • Inicia sesión en tu cuenta de Fonema.ai
   • Navega a la sección de Configuración → Claves API

2. Crear nueva clave

   • Haz clic en el botón "Agregar API Key"

3. 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

Header de Autenticación

Una vez que tengas tu API Key, debes incluirla en todas las solicitudes a la API mediante el header de autorización:

Authorization: Bearer TU_API_KEY_AQUÍ