PUTDisponible
Actualizar asistente
Operación autenticada de la API de BeepCall.
https://app.beepcall.ai/api/user/assistant/{id}
Parámetros
NombreUbicaciónTipoDescripción
Authorization*headerBearer tokenClave de API de BeepCall.
id*pathintegerIdentificador id.
assistant_namebodystringNombre del asistente, máximo 255 caracteres.
voice_idbodyintegerID de la voz.
languagebodystringNombre del idioma, máximo 100 caracteres.
llm_modelbodystringModelo LLM, máximo 100 caracteres.
calls_directionbodystringDirección: receive o make.
engine_typebodystringMotor: pipeline o multimodal.
timezonebodystringZona horaria del asistente.
initial_messagebodystringMensaje inicial.
system_promptbodystringPrompt que define el comportamiento.
phone_number_idbodyintegerID del número de teléfono a asignar al asistente.
tool_idsbodyarrayIDs de herramientas durante llamada que se adjuntarán.
endpoint_typebodystringDetección de actividad de voz: vad o ai.
endpoint_sensitivitybodynumberSensibilidad del endpoint, de 0 a 5.
interrupt_sensitivitybodynumberSensibilidad de interrupción, de 0 a 5.
ambient_sound_volumebodynumberVolumen de sonido ambiental, de 0 a 1.
post_call_evaluationbodybooleanActiva la evaluación posterior a la llamada.
send_webhook_only_on_completedbodybooleanEnvía webhooks solo en llamadas completadas.
include_recording_in_webhookbodybooleanIncluye la grabación en el webhook.
is_webhook_activebodybooleanIndica si el webhook está activo.
webhook_urlbodystringURL del webhook; requerida cuando se activa.
llm_temperaturebodynumberTemperatura del LLM, de 0 a 1.
voice_stabilitybodynumberEstabilidad de voz, de 0 a 1.
voice_similaritybodynumberSimilitud de voz, de 0 a 1.
speech_speedbodynumberVelocidad de habla, de 0,7 a 1,2.
allow_interruptionsbodybooleanPermite interrupciones del usuario.
filler_audiosbodybooleanActiva audios de relleno.
re_engagement_intervalbodyintegerIntervalo de reenganche en segundos, de 7 a 600.
max_call_durationbodyintegerDuración máxima en segundos, de 20 a 1200.
max_silence_durationbodyintegerSilencio máximo en segundos, de 1 a 120.
end_call_on_voicemailbodybooleanFinaliza al detectar buzón de voz.
noise_cancellationbodybooleanActiva la cancelación de ruido.
record_callbodybooleanGraba la llamada.
who_speaks_firstbodystringQuién habla primero: AI assistant o Customer.
use_min_interrupt_wordsbodybooleanUsa un mínimo de palabras para interrumpir.
min_interrupt_wordsbodyintegerMínimo de palabras para interrumpir, de 0 a 10.
variablesbodyobjectVariables personalizadas del asistente.
post_call_schemabodyarrayEsquema de extracción posterior a la llamada.
end_call_tool.descriptionbodystringDescripción de la herramienta de finalización.
* Obligatorio
Ejemplo de solicitud
curl -X PUT "https://app.beepcall.ai/api/user/assistant/1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"assistant_name": "Asistente Actualizado",
"initial_message": "Mensaje actualizado"
}'Respuesta
json
{
"message": "Assistant updated successfully",
"data": {
"id": 789,
"name": "Updated Sales Assistant",
"status": "active",
"type": "outbound",
"mode": "pipeline"
}
}Errores habituales
404422