> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversation erstellen

> Neue Chat-Session mit einem KI-Assistenten starten

Erstelle eine neue Conversation mit deinem Famulor KI-Assistenten. Über diesen Endpoint startest du eine Widget- oder Test-Conversation und erhältst den initialen Verlauf.

### Request Body

<ParamField body="assistant_id" type="string" required>
  UUID des Assistenten, der die Conversation übernehmen soll
</ParamField>

<ParamField body="type" type="string" default="widget">
  Conversation-Typ. Optionen: `widget` (kostenpflichtig) oder `test` (kostenlos für Entwicklung)
</ParamField>

<ParamField body="variables" type="object" optional>
  Individuelle Variablen, die in den Assistenten-Kontext injiziert werden (zugreifbar via `{{variable_name}}`)

  <Expandable title="variables examples">
    <ParamField body="customer_name" type="string">
      Name für Begrüßung oder Personalisierung
    </ParamField>

    <ParamField body="company" type="string">
      Firmenname für Antworten
    </ParamField>

    <ParamField body="source" type="string">
      Traffic- oder Seitenquelle (z. B. `pricing_page`)
    </ParamField>
  </Expandable>
</ParamField>

### Request Examples

### Response Fields

<ResponseField name="status" type="boolean" required>
  Zeigt an, ob die Anfrage erfolgreich war
</ResponseField>

<ResponseField name="conversation_id" type="string" required>
  UUID der erstellten Conversation; für weitere Nachrichten nutzen
</ResponseField>

<ResponseField name="history" type="array">
  Initialer Conversation-Verlauf. Leer, falls der Assistent keine Startnachricht hat.

  <Expandable title="history items">
    <ResponseField name="role" type="string">
      Nachrichtenrolle (`assistant` oder `user`)
    </ResponseField>

    <ResponseField name="content" type="string">
      Nachrichtentext
    </ResponseField>
  </Expandable>
</ResponseField>

### Response Examples

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "status": true,
    "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "history": [
      {
        "role": "assistant",
        "content": "Hello John Smith! Welcome to Acme Corp support. How can I help you today?"
      }
    ]
  }
  ```

  ```json 200 Success (no initial message) theme={null}
  {
    "status": true,
    "conversation_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "history": []
  }
  ```

  ```json 404 Assistant Not Found theme={null}
  {
    "status": false,
    "error": "Assistant not found"
  }
  ```

  ```json 400 Insufficient Balance theme={null}
  {
    "status": false,
    "error": "Insufficient balance. Please top up your account."
  }
  ```
</ResponseExample>

### Notes

* `type: "widget"` Conversations sind kostenpflichtig; `type: "test"` ist kostenlos für die Entwicklung.
* Nutze aussagekräftige `variables`, um die erste Antwort des Assistenten zu personalisieren.
* Fahre mit [`Send Message`](/de/api-reference/ai-chatbot/send-conversation) fort und hole den Verlauf mit [`Get Conversation`](/de/api-reference/ai-chatbot/get-conversation).