Obtener agente
GET /get-agent/{agent_id}
Recupera la configuración completa de un agente de voz: voz, idioma, comportamiento, webhooks, análisis post-llamada, privacidad y más.
Parámetros de ruta
agent_id
string
Sí
ID único del agente. Ejemplo: 16b980523634a6dc504898cda492e939
Parámetros de consulta (query)
version
integer
No
Versión específica del agente. Por defecto devuelve la más reciente.
Respuesta — 200 OK
Devuelve el objeto AgentResponse con la configuración completa del agente.
Identificación
agent_id
string
Identificador único del agente.
agent_name
string
Nombre del agente. Ejemplo: Asistente de Ventas
version
integer
Versión actual del agente.
version_description
string
Descripción de esta versión.
last_modification_timestamp
integer
Última modificación en milisegundos (epoch).
is_published
boolean
Si el agente está publicado.
is_public
boolean
Si el agente tiene enlace de preview público habilitado.
timezone
string
Zona horaria del agente en formato IANA. Ejemplo: America/Mexico_City
Motor de respuesta (response_engine)
anunzi-llm
type: "anunzi-llm", llm_id (string), version (number)
Voz y audio
voice_id
string
ID de la voz asignada al agente.
voice_model
string
Modelo TTS utilizado. Opciones: eleven_turbo_v2, eleven_flash_v2_5, eleven_multilingual_v2, sonic-3, gpt-4o-mini-tts, entre otros.
voice_temperature
number
Control de estabilidad de voz. Rango: 0–2. Predeterminado: 1
voice_speed
number
Velocidad de la voz. Rango: 0.5–2. Predeterminado: 1
volume
number
Volumen. Rango: 0–2. Predeterminado: 1
voice_emotion
string
Emoción de la voz: calm | happy | sad | angry | sympathetic | fearful | surprised
enable_dynamic_voice_speed
boolean
Ajusta la velocidad de voz dinámicamente según el ritmo del usuario.
fallback_voice_ids
array
Voces de respaldo en caso de indisponibilidad del proveedor TTS principal.
ambient_sound
string
Sonido ambiente: coffee-shop | convention-hall | summer-outdoor | mountain-outdoor | static-noise | call-center
ambient_sound_volume
number
Volumen del sonido ambiente. Rango: 0–2.
Comportamiento e interacción
responsiveness
number
Velocidad de respuesta del agente. Rango: 0–1.
interruption_sensitivity
number
Sensibilidad a interrupciones del usuario. Rango: 0–1.
enable_backchannel
boolean
El agente intercala frases breves ("aja", "entiendo") mientras el usuario habla.
backchannel_frequency
number
Frecuencia de backchanneling cuando está habilitado. Rango: 0–1.
reminder_trigger_ms
number
Milisegundos de silencio del usuario tras hablar el agente para enviar recordatorio.
reminder_max_count
integer
Máximo de recordatorios enviados al usuario sin respuesta.
enable_dynamic_responsiveness
boolean
Ajusta la velocidad de respuesta dinámicamente.
Idioma y transcripción
language
string o array
Idioma(s) del agente. Ejemplo: "es-419" (español latinoamericano), o array ["es-419", "en-US"]
boosted_keywords
array
Palabras clave para sesgar el reconocimiento de voz. Ejemplo: ["Anunzi", "CRM"]
stt_mode
string
Modo de transcripción: fast | accurate | custom
vocab_specialization
string
Vocabulario especializado: general | medical
denoising_mode
string
Cancelación de ruido: no-denoise | noise-cancellation | noise-and-background-speech-cancellation
pronunciation_dictionary
array
Diccionario de pronunciación personalizada. Cada entrada: word, alphabet (ipa | cmu), phoneme.
Control de llamada
end_call_after_silence_ms
integer
Finaliza la llamada si el usuario no responde luego de este tiempo (ms).
max_call_duration_ms
integer
Duración máxima de la llamada en milisegundos.
ring_duration_ms
integer
Tiempo máximo de timbre antes de timeout. Rango: 5000–300000 ms.
begin_message_delay_ms
integer
Demora en ms antes de que el agente envíe el primer mensaje.
Webhooks
webhook_url
string
URL que recibe los eventos de la llamada.
webhook_events
array
Eventos a recibir: call_started | call_ended | call_analyzed | transcript_updated | transfer_started | transfer_bridged | transfer_cancelled | transfer_ended
webhook_timeout_ms
integer
Tiempo máximo de espera para la respuesta del webhook (ms).
Buzón de voz e IVR
voicemail_message
string
Mensaje que se reproduce al detectar buzón de voz.
voicemail_detection_timeout_ms
integer
Tiempo máximo para ejecutar la detección de buzón de voz (ms).
voicemail_option
object
Acción al detectar buzón: colgar (hangup), mensaje estático (static_text), o transferir (bridge_transfer).
ivr_option
object
Acción al detectar un IVR.
Análisis post-llamada
post_call_analysis_data
array
Esquema de campos personalizados a extraer del análisis. Tipos: string, enum, boolean, number, system-presets.
post_call_analysis_model
string
Modelo de IA para el análisis. Opciones: gpt-4.1, gpt-4.1-mini, claude-4.6-sonnet, gemini-2.5-flash, entre otros.
analysis_successful_prompt
string
Prompt para determinar si la llamada fue exitosa (máx. 2000 caracteres).
analysis_summary_prompt
string
Prompt para guiar la generación del resumen (máx. 2000 caracteres).
analysis_user_sentiment_prompt
string
Prompt para determinar el sentimiento del usuario.
Privacidad y almacenamiento
data_storage_setting
string
everything | everything_except_pii | basic_attributes_only
data_storage_retention_days
integer
Días antes de eliminar automáticamente los datos. Rango: 1–730.
opt_in_signed_url
boolean
Habilitar URLs firmadas para grabaciones y logs públicos.
signed_url_expiration_ms
integer
Expiración de URLs firmadas en milisegundos.
pii_config
object
Configuración de detección y eliminación de PII. Categorías: nombre, dirección, email, teléfono, número de seguro social, pasaporte, licencia, tarjeta de crédito, cuenta bancaria, contraseña, PIN, ID médico, fecha de nacimiento, número de cuenta.
Ejemplo de solicitud
Con versión específica:
Ejemplo de respuesta (parcial)
Códigos de estado
200
Agente encontrado y devuelto correctamente.
400
Formato de solicitud inválido.
401
API Key ausente o inválida.
422
El agente no existe bajo tu API Key.
500
Error interno del servidor.
Última actualización