PUT
/
api
/
user
/
assistant
/
{id}
curl -X PUT "https://app.famulor.de/api/user/assistant/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_name": "Neuer Assistent Name",
    "initial_message": "Hallo! Wie kann ich Ihnen heute helfen?"
  }'

{
  "message": "Assistant updated successfully",
  "data": {
    "id": 123,
    "name": "Neuer Assistent Name",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}
Dieser Endpunkt ermöglicht es Ihnen, die Konfiguration eines bestehenden KI-Assistenten zu aktualisieren. Alle Felder sind optional - geben Sie nur die Felder an, die Sie aktualisieren möchten.

​
Path Parameter

​
id
integer
required
Die eindeutige Kennung des zu aktualisierenden Assistenten

​
Request Body

​
Kernfelder

​
assistant_name
string
Der Name des Assistenten (max. 255 Zeichen)
​
voice_id
integer
Die Stimmen-ID für den Assistenten (muss in verfügbaren Stimmen existieren)
​
language
string
Der Sprachname für den Assistenten (max. 100 Zeichen)
​
llm_model
string
Der Name des zu verwendenden LLM-Modells (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. “Europe/Berlin”)
​
initial_message
string
Die erste Nachricht, die der Assistent beim Anrufstart 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 zum Entfernen)
​
endpoint_type
string
Sprachaktivitätserkennung-Typ. Optionen: vad, ai
​
endpoint_sensitivity
number
Endpunkt-Sensibilitätslevel (0-5)
​
interrupt_sensitivity
number
Unterbrechungs-Sensibilitätslevel (0-5)
​
ambient_sound_volume
number
Ambiente-Sound-Lautstärke (0-1)
​
post_call_evaluation
boolean
Ob Post-Call-Evaluation aktiviert werden soll
​
send_webhook_only_on_completed
boolean
Ob Webhooks nur bei abgeschlossenen Anrufen gesendet werden sollen
​
include_recording_in_webhook
boolean
Ob Aufzeichnungs-URL in Webhook-Payload eingeschlossen 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 zum Entfernen)

​
Unterbrechungseinstellungen

​
use_min_interrupt_words
boolean
Ob die Mindest-Unterbrechungswörter-Einstellung verwendet werden soll
​
min_interrupt_words
integer
Mindestanzahl von Wörtern vor erlaubter Unterbrechung (0-10)

​
Variablen und Schema

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

​
End Call Tool

​
end_call_tool.description
string
Beschreibung für die End Call Tool-Funktionalität (max. 500 Zeichen)

​
Stimme und Sprache

​
llm_temperature
number
LLM-Temperatur-Einstellung (0-1)
​
voice_stability
number
Stimm-Stabilität-Einstellung (0-1)
​
voice_similarity
number
Stimm-Ähnlichkeit-Einstellung (0-1)
​
speech_speed
number
Sprechgeschwindigkeits-Multiplikator (0.7-1.2)

​
Anrufverhalten

​
allow_interruptions
boolean
Ob Unterbrechungen durch den Anrufer erlaubt werden sollen
​
filler_audios
boolean
Ob Füller-Audio während der Verarbeitung verwendet werden soll
​
re_engagement_interval
integer
Re-Engagement-Intervall in Sekunden (7-600)
​
max_call_duration
integer
Maximale Anrufdauer in Sekunden (20-1200)
​
max_silence_duration
integer
Maximale Stillstand-Dauer in Sekunden (1-120)
​
end_call_on_voicemail
boolean
Ob 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

​
Response

​
message
string
Erfolgsmeldung, die die Assistenten-Aktualisierung bestätigt
​
data
object
Daten des aktualisierten Assistenten

​
Hinweise

  • Nur die Felder, die Sie im Request Body angeben, werden aktualisiert
  • Alle Validierungsregeln gelten genauso wie beim Erstellen eines Assistenten
  • Um eine Telefonnummer-Zuweisung zu entfernen, setzen Sie phone_number_id auf null
  • Um 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 zu werden
curl -X PUT "https://app.famulor.de/api/user/assistant/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_name": "Neuer Assistent Name",
    "initial_message": "Hallo! Wie kann ich Ihnen heute helfen?"
  }'

{
  "message": "Assistant updated successfully",
  "data": {
    "id": 123,
    "name": "Neuer Assistent Name",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}