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.

Endpoint

POST /v1/agents

Cuerpo de la solicitud

{
  "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"
    }
  ]
}

Parámetros

Campo	Tipo	Requerido	Descripción
name	string	Sí	Nombre del agente (no puede estar vacío).
greeting	string	No	Mensaje de apertura que dice el agente al iniciar la llamada.
prompt	string	No	Prompt del sistema que define el comportamiento del agente.
farewell	string	No	Mensaje de cierre que se dice al final de la llamada.
voiceId	string	No	Identificador de la voz del agente.
outputVariables	array	No	Variables a capturar durante la llamada. Ver más abajo.

Elementos de outputVariables

Campo	Tipo	Requerido	Descripción
name	string	Sí	Nombre de la variable.
description	string	No	Qué representa la variable.
type	string	No	Tipo de dato de la variable (ej. string).
value	string	No	Valor por defecto.
enum	string[]	No	Valores permitidos, si está restringida a un conjunto.

Ejemplo de solicitud

curl -X POST "https://api.fonema.ai/v1/agents" \
  -H "Authorization: Bearer TU_API_KEY_AQUI" \
  -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": []
  }'

Respuesta

Devuelve 201 Created:

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

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

Errores

Estado	Descripción
400	Cuerpo de solicitud inválido (por ejemplo, falta name).
403	No hay ninguna empresa asociada a la API Key.