Zum Hauptinhalt springen
PUT
https://app.autocalls.ai/api/
/
user
/
assistant
/
{id}
Assistenten aktualisieren
curl --request PUT \
  --url https://app.autocalls.ai/api/user/assistant/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assistant_name": "<string>",
  "voice_id": 123,
  "language": "<string>",
  "llm_model": "<string>",
  "calls_direction": "<string>",
  "engine_type": "<string>",
  "timezone": "<string>",
  "initial_message": "<string>",
  "system_prompt": "<string>",
  "phone_number_id": 123,
  "tool_ids": [
    123
  ],
  "endpoint_type": "<string>",
  "endpoint_sensitivity": 123,
  "interrupt_sensitivity": 123,
  "ambient_sound_volume": 123,
  "post_call_evaluation": true,
  "send_webhook_only_on_completed": true,
  "include_recording_in_webhook": true,
  "is_webhook_active": true,
  "webhook_url": "<string>",
  "use_min_interrupt_words": true,
  "min_interrupt_words": 123,
  "variables": {},
  "post_call_schema": [
    {
      "post_call_schema[].name": "<string>",
      "post_call_schema[].type": "<string>",
      "post_call_schema[].description": "<string>"
    }
  ],
  "end_call_tool.description": "<string>",
  "llm_temperature": 123,
  "voice_stability": 123,
  "voice_similarity": 123,
  "speech_speed": 123,
  "allow_interruptions": true,
  "filler_audios": true,
  "re_engagement_interval": 123,
  "max_call_duration": 123,
  "max_silence_duration": 123,
  "end_call_on_voicemail": true,
  "noise_cancellation": true,
  "record_call": true,
  "who_speaks_first": "<string>"
}
'
{
  "message": "Assistant updated successfully",
  "data": {
    "id": 789,
    "name": "Updated Sales Assistant",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}
Dieser Endpunkt ermöglicht es Ihnen, die Konfiguration eines vorhandenen KI-Assistenten zu aktualisieren. Alle Felder sind optional - geben Sie nur die Felder an, die Sie aktualisieren möchten.

Pfad-Parameter

id
integer
required
Die eindeutige Kennung des zu aktualisierenden Assistenten

Anfragekörper

Hauptfelder

assistant_name
string
Der Name des Assistenten (max. 255 Zeichen)
voice_id
integer
Die Stimmen-ID, die für den Assistenten verwendet werden soll (muss in den verfügbaren Stimmen vorhanden sein)
language
string
Der Sprachname für den Assistenten (max. 100 Zeichen)
llm_model
string
Der zu verwendende LLM-Modellname (max. 100 Zeichen)
calls_direction
string
Der Anrufrichtungstyp. Optionen: receive, make
engine_type
string
Der zu verwendende Engine-Typ. Optionen: pipeline, multimodal
timezone
string
Die Zeitzone für den Assistenten (z. B. “America/New_York”)
initial_message
string
Die erste Nachricht, die der Assistent beim Start des Anrufs sprechen wird
system_prompt
string
Der System-Prompt, der das Verhalten und die Persönlichkeit des Assistenten definiert

Optionale Konfiguration

phone_number_id
integer
Die ID einer Telefonnummer, die dem Assistenten zugewiesen werden soll (auf null setzen, um die Zuweisung aufzuheben)
tool_ids
integer[]
Array von Mid-Call-Tool-IDs, die mit dem Assistenten synchronisiert werden sollen. Ersetzt alle vorhandenen Tool-Zuweisungen. Übergeben Sie ein leeres Array, um alle Tools zu entfernen. Jedes Element muss eine gültige Tool-ID sein, die zu Ihrem Konto gehört.
endpoint_type
string
Sprachaktivitätserkennungstyp. Optionen: vad, ai
endpoint_sensitivity
number
Endpunkt-Empfindlichkeitsstufe (0-5)
interrupt_sensitivity
number
Unterbrechungs-Empfindlichkeitsstufe (0-5)
ambient_sound_volume
number
Umgebungsgeräusch-Lautstärkepegel (0-1)
post_call_evaluation
boolean
Ob die Post-Call-Bewertung aktiviert werden soll
send_webhook_only_on_completed
boolean
Ob Webhooks nur bei abgeschlossenen Anrufen gesendet werden sollen
include_recording_in_webhook
boolean
Ob die Aufzeichnungs-URL in die Webhook-Payload aufgenommen werden soll

Webhook-Konfiguration

is_webhook_active
boolean
Ob Webhook-Benachrichtigungen aktiviert sind
webhook_url
string
Die Webhook-URL für Post-Call-Benachrichtigungen (kann auf null gesetzt werden, um sie zu entfernen)

Unterbrechungseinstellungen

use_min_interrupt_words
boolean
Ob die Einstellung für minimale Unterbrechungswörter verwendet werden soll
min_interrupt_words
integer
Mindestanzahl von Wörtern, bevor eine Unterbrechung erlaubt ist (0-10)

Variablen und Schema

variables
object
Schlüssel-Wert-Paare von benutzerdefinierten Variablen für den Assistenten
post_call_schema
array
Schemadefinition für die Post-Call-Datenextraktion

Anruf-Beenden-Tool

end_call_tool.description
string
Beschreibung für die Anruf-Beenden-Tool-Funktionalität (max. 500 Zeichen)

Stimm- und Spracheinstellungen

llm_temperature
number
LLM-Temperatureinstellung (0-1)
voice_stability
number
Stimmstabilitätseinstellung (0-1)
voice_similarity
number
Stimmähnlichkeitseinstellung (0-1)
speech_speed
number
Sprechgeschwindigkeitsmultiplikator (0.7-1.2)

Anrufverhaltenseinstellungen

allow_interruptions
boolean
Ob Anruferunterbrechungen erlaubt werden sollen
filler_audios
boolean
Ob Fülllaute während der Verarbeitung verwendet werden sollen
re_engagement_interval
integer
Intervall für erneuten Eingriff in Sekunden (7-600)
max_call_duration
integer
Maximale Anrufdauer in Sekunden (20-1200)
max_silence_duration
integer
Maximale Stille-Dauer in Sekunden (1-120)
end_call_on_voicemail
boolean
Ob der Anruf bei Voicemail-Erkennung beendet werden soll
noise_cancellation
boolean
Ob Geräuschunterdrückung aktiviert werden soll
record_call
boolean
Ob der Anruf aufgezeichnet werden soll
who_speaks_first
string
Wer zuerst im Anruf spricht. Optionen: AI assistant, Customer

Antwort

message
string
Erfolgsmeldung, die die Aktualisierung des Assistenten bestätigt
data
object

Fehlerantworten

404 Nicht gefunden
422 Validierungsfehler
500 Interner Serverfehler
{
  "message": "Assistant updated successfully",
  "data": {
    "id": 789,
    "name": "Updated Sales Assistant",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}

Hinweise

  • Nur die Felder, die Sie im Anfragekörper angeben, werden aktualisiert
  • Alle Validierungsregeln gelten genauso wie beim Erstellen eines Assistenten
  • Um eine Telefonnummernzuweisung zu entfernen, setzen Sie phone_number_id auf null
  • Um den Webhook zu deaktivieren, setzen Sie webhook_url auf null oder is_webhook_active auf false
  • Der Assistent muss dem authentifizierten Benutzer gehören, um aktualisiert werden zu können