Crear agente

Crea un nuevo agente en tu empresa. Cuando usas una clave de Agentes específicos, el nuevo agente se agrega automáticamente a la lista de agentes permitidos de esa clave, para que puedas administrarlo de inmediato.

Autenticación

AuthorizationBearer

Autentica las solicitudes desde tu servidor con una API Key de Fonema. Créala en la sección de API Keys del Dashboard y envíala en el encabezado Authorization como Bearer <token>. No pongas tus claves en código del navegador ni en repositorios públicos.

Cuerpo

namestringObligatorio

Nombre del agente (no puede estar vacío).

greetingstringOpcional

Mensaje de apertura que dice el agente al iniciar la llamada.

promptstringOpcional

Prompt del sistema que define el comportamiento del agente.

farewellstringOpcional

Mensaje de cierre que se dice al final de la llamada.

voiceIdstringOpcional

Identificador de la voz del agente. Consulta los valores disponibles en Listar voces.

outputVariablesarrayOpcional

Variables a capturar durante la llamada. Ver más abajo.

outputVariables[].namestringObligatorio

Nombre de la variable.

outputVariables[].descriptionstringOpcional

Qué representa la variable.

outputVariables[].typestringOpcional

Tipo de dato de la variable (ej. string).

outputVariables[].valuestringOpcional

Valor por defecto.

outputVariables[].enumstring[]Opcional

Valores permitidos, si está restringida a un conjunto.

outputVariables[].idstringOpcional

Identificador opcional de la variable.

Respuesta

Devuelve 201 Created.

Usa el slug devuelto para seguir configurando el agente con Editar agente.

Errores

400

Cuerpo de solicitud inválido (por ejemplo, falta name).

403

No hay ninguna empresa asociada a la API Key.

POST/v1/agents

$curl -X POST "https://api.fonema.ai/v1/agents" \
>     -H "Authorization: Bearer TU_API_KEY" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "name": "Agente de Prueba API",
>  "greeting": "¡Hola!",
>  "prompt": "Eres un asistente servicial.",
>  "farewell": "¡Adiós!",
>  "voiceId": "TU_VOICE_ID",
>  "outputVariables": [
>    {
>      "name": "customerName",
>      "description": "El nombre completo de quien llama",
>      "type": "string"
>    }
>  ]
>}'

201Created

1{
2  "name": "Agente de Prueba API",
3  "slug": "agente-de-prueba-api-x1y2z3w4",
4  "message": "Agent created successfully"
5}