DocumentaciónReferencia APIActualizar asistente
    PUTDisponible

    Actualizar asistente

    Operación autenticada de la API de BeepCall.

    https://app.beepcall.ai/api/user/assistant/{id}

    Parámetros

    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