Skip to main content
POST
https://app.famulor.de
/
api
/
user
/
assistant
Assistenten erstellen
curl --request POST \
  --url https://app.famulor.de/api/user/assistant \
  --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 created successfully",
  "data": {
    "id": 3579,
    "name": "Mein Verkaufs-Assistent",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}
Dieser Endpunkt ermöglicht es Ihnen, einen neuen KI-Assistenten mit umfassenden Konfigurationsoptionen zu erstellen.

​
Request Body

​
Erforderliche Kernfelder

​
assistant_name
string
required
Der Name des Assistenten (max. 255 Zeichen)
​
voice_id
integer
required
Die Stimmen-ID für den Assistenten (muss in verfügbaren Stimmen existieren)
​
language
string
required
Der Sprachname für den Assistenten (max. 100 Zeichen)
​
llm_model
string
required
Der Name des zu verwendenden LLM-Modells (max. 100 Zeichen)
​
calls_direction
string
required
Der Anrufrichtungstyp. Optionen: receive, make
​
engine_type
string
required
Der zu verwendende Engine-Typ. Optionen: pipeline, multimodal
​
timezone
string
required
Die Zeitzone für den Assistenten (z.B. “Europe/Berlin”)
​
initial_message
string
required
Die erste Nachricht, die der Assistent beim Anrufstart sprechen wird
​
system_prompt
string
required
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 (muss in den Telefonnummern des Benutzers existieren)
​
tool_ids
integer[]
Array von Mid-call Action-IDs, die dem Assistenten zugewiesen werden sollen. Jedes Element muss eine gültige Tool-ID sein, die zu Ihrem Konto gehört.
​
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 (erforderlich wenn is_webhook_active auf true gesetzt ist)

​
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-Erstellung bestätigt
​
data
object
Daten des erstellten Assistenten

​
Hinweise

  • Alle erforderlichen Felder müssen für eine erfolgreiche Assistenten-Erstellung angegeben werden
  • Der Assistent wird mit Standardeinstellungen für alle nicht angegebenen optionalen Felder erstellt
  • Die Telefonnummer-Zuweisung ist optional, aber die Telefonnummer muss dem authentifizierten Benutzer gehören
  • Webhook-URL ist nur erforderlich, wenn is_webhook_active auf true gesetzt ist
  • Stimm- und Sprach-Kennungen müssen verfügbaren Optionen im System entsprechen
curl -X POST "https://app.famulor.de/api/user/assistant" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_name": "Premium Verkaufs-Assistent",
    "voice_id": 413,
    "language": "German",
    "llm_model": "GPT-4o",
    "calls_direction": "make",
    "engine_type": "pipeline",
    "timezone": "Europe/Berlin",
    "initial_message": "Guten Tag! Ich rufe von Famulor an.",
    "system_prompt": "Du bist ein freundlicher Verkaufsassistent...",
    "phone_number_id": 2131,
    "is_webhook_active": true,
    "webhook_url": "https://example.com/webhook",
    "post_call_evaluation": true,
    "variables": {
      "company_name": "Famulor",
      "service_type": "AI-Telefonie"
    },
    "post_call_schema": [
      {
        "name": "customer_interested",
        "type": "bool",
        "description": "Whether the customer showed interest"
      },
      {
        "name": "follow_up_date",
        "type": "string",
        "description": "Preferred follow-up date"
      }
    ],
    "allow_interruptions": true,
    "speech_speed": 1.1,
    "max_call_duration": 600,
    "record_call": true
  }'

{
  "message": "Assistant created successfully",
  "data": {
    "id": 3579,
    "name": "Mein Verkaufs-Assistent",
    "status": "active",
    "type": "outbound",
    "mode": "pipeline"
  }
}