Consultar agente

Obtiene la configuración completa de un agente a partir de su slug.

Endpoint

GET /v1/agents/:slug

Parámetros de ruta

Parámetro	Tipo	Descripción
slug	string	Slug único del agente. Obtenlo desde Listar agentes o desde tu dashboard de Fonema.

Ejemplo de solicitud

curl -X GET "https://api.fonema.ai/v1/agents/agente-de-ventas-ab12cd34" \
  -H "Authorization: Bearer TU_API_KEY_AQUI"

Respuesta

{
  "name": "Agente de Ventas",
  "slug": "agente-de-ventas-ab12cd34",
  "greeting": "¡Hola, gracias por llamar!",
  "prompt": "Eres un asistente de ventas servicial.",
  "textPrompt": "...",
  "voiceId": "TU_VOICE_ID",
  "sipDialTarget": null,
  "numberOfAttempt": 3,
  "allowReturnCall": true,
  "recallLogic": { "totalCalls": 3 },
  "workingHours": {},
  "localizations": {},
  "dtmf": false,
  "transferCallDestinations": [],
  "knowledgeBaseFiles": [],
  "tools": [
    {
      "id": 12,
      "name": "lookup_order",
      "type": "API_CALL",
      "description": "Busca un pedido por su ID",
      "variables": [
        { "orderId": { "type": "string", "description": "El ID del pedido" } }
      ],
      "content": {
        "functionName": "lookup_order",
        "url": "https://example.com/api/orders"
      }
    }
  ],
  "config": {
    "transcriberLanguage": "es-419",
    "silenceTimeoutSeconds": 30,
    "maxDurationSeconds": 600,
    "endOfCallWebhook": "https://example.com/webhooks/end-of-call"
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
name	string	Nombre del agente.
slug	string	Identificador único del agente.
greeting	string	Mensaje de apertura que dice el agente al iniciar la llamada.
prompt	string	Prompt del sistema que define el comportamiento del agente.
textPrompt	string	Prompt usado para conversaciones de texto/chat.
voiceId	string	Identificador de la voz que usa el agente.
sipDialTarget	string | null	Destino SIP, si está configurado.
numberOfAttempt	integer	Número de intentos de llamada configurados (proviene de recallLogic).
allowReturnCall	boolean	Si el agente permite llamadas de retorno.
recallLogic	object	Configuración de reintentos/rellamadas.
workingHours	object	Configuración de horario de atención.
localizations	object	Configuración de localización.
dtmf	boolean	Si está habilitada la entrada por DTMF (teclado).
transferCallDestinations	array	Destinos de transferencia de llamada configurados.
knowledgeBaseFiles	array	IDs de los archivos de base de conocimiento adjuntos.
tools	array	Herramientas/skills disponibles para el agente.
config	object	Configuración adicional del agente (idioma del transcriptor, tiempos de espera, webhooks, etc.).

nota

Las credenciales sensibles de las herramientas (apiKey, token, credentialId) nunca se incluyen en la respuesta de tools.

Errores

Estado	Descripción
404	El agente no existe o no es accesible con esta API Key.