> ## 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

<Warning>
  **Famulor 1.0 API (Legacy).** Diese Seite gilt nur für Famulor 1.0 (`app.famulor.de`) und bleibt aus Kompatibilitätsgründen erhalten. Für die aktuelle Plattform nutze die [Famulor 2.0 API-Referenz](/de/api-reference/introduction).
</Warning>

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.

### Anfrage-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>

### Anfrage-Beispiele

### Antwort-Felder

<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>

### Antwort-Beispiele

<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>

### Hinweise

* `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-v1/ai-chatbot/send-conversation) fort und hole den Verlauf mit [`Get Conversation`](/de/api-v1/ai-chatbot/get-conversation).