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
Die eindeutige Kennung des zu aktualisierenden Assistenten
Request Body
Kernfelder
Der Name des Assistenten (max. 255 Zeichen)
Die Stimmen-ID für den Assistenten (muss in verfügbaren Stimmen existieren)
Der Sprachname für den Assistenten (max. 100 Zeichen)
Der Name des zu verwendenden LLM-Modells (max. 100 Zeichen)
Der Anrufrichtungstyp. Optionen: receive, make
Der zu verwendende Engine-Typ. Optionen: pipeline, multimodal
Die Zeitzone für den Assistenten (z.B. “Europe/Berlin”)
Die erste Nachricht, die der Assistent beim Anrufstart sprechen wird
Der System-Prompt, der das Verhalten und die Persönlichkeit des Assistenten definiert
Optionale Konfiguration
Die ID einer Telefonnummer, die dem Assistenten zugewiesen werden soll (auf null setzen zum Entfernen)
Array von Mid-call Action-IDs zur Synchronisierung mit dem Assistenten. Ersetzt alle bestehenden 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.
Sprachaktivitätserkennung-Typ. Optionen: vad, ai
Endpunkt-Sensibilitätslevel (0-5)
Unterbrechungs-Sensibilitätslevel (0-5)
Ambiente-Sound-Lautstärke (0-1)
Ob Post-Call-Evaluation aktiviert werden soll
send_webhook_only_on_completed
Ob Webhooks nur bei abgeschlossenen Anrufen gesendet werden sollen
include_recording_in_webhook
Ob Aufzeichnungs-URL in Webhook-Payload eingeschlossen werden soll
Webhook-Konfiguration
Ob Webhook-Benachrichtigungen aktiviert sind
Die Webhook-URL für Post-Call-Benachrichtigungen (kann auf null gesetzt werden zum Entfernen)
Unterbrechungseinstellungen
Ob die Mindest-Unterbrechungswörter-Einstellung verwendet werden soll
Mindestanzahl von Wörtern vor erlaubter Unterbrechung (0-10)
Variablen und Schema
Schlüssel-Wert-Paare von benutzerdefinierten Variablen für den Assistenten
Schema-Definition für Post-Call-Datenextraktion Show post_call_schema Eigenschaften
Der Name des Schema-Feldes (nur alphanumerisch und Unterstriche)
Der Datentyp. Optionen: string, number, bool
post_call_schema[].description
Beschreibung dessen, was dieses Feld repräsentiert
end_call_tool.description
Beschreibung für die End Call Tool-Funktionalität (max. 500 Zeichen)
Stimme und Sprache
LLM-Temperatur-Einstellung (0-1)
Stimm-Stabilität-Einstellung (0-1)
Stimm-Ähnlichkeit-Einstellung (0-1)
Sprechgeschwindigkeits-Multiplikator (0.7-1.2)
Anrufverhalten
Ob Unterbrechungen durch den Anrufer erlaubt werden sollen
Ob Füller-Audio während der Verarbeitung verwendet werden soll
Re-Engagement-Intervall in Sekunden (7-600)
Maximale Anrufdauer in Sekunden (20-1200)
Maximale Stillstand-Dauer in Sekunden (1-120)
Ob Anruf bei Voicemail-Erkennung beendet werden soll
Ob Geräuschunterdrückung aktiviert werden soll
Ob der Anruf aufgezeichnet werden soll
Wer zuerst im Anruf spricht. Optionen: AI assistant, Customer
Response
Erfolgsmeldung, die die Assistenten-Aktualisierung bestätigt
Daten des aktualisierten Assistenten Die eindeutige Kennung des aktualisierten Assistenten
Der aktuelle Status des Assistenten
Der Typ des Assistenten (inbound oder outbound)
Der Engine-Modus (pipeline oder multimodal)
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?",
"voice_id": 413,
"language": "German",
"llm_model": "GPT-4o",
"system_prompt": "Du bist ein hilfsfreundlicher Assistent...",
"webhook_url": "https://example.com/webhook",
"is_webhook_active": true,
"post_call_evaluation": true,
"variables": {
"company_name": "Famulor",
"service_type": "AI-Telefonie"
}
}'
200 Success
404 Not Found
422 Validation Error
500 Internal Server Error
{
"message" : "Assistant updated successfully" ,
"data" : {
"id" : 123 ,
"name" : "Neuer Assistent Name" ,
"status" : "active" ,
"type" : "outbound" ,
"mode" : "pipeline"
}
}