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

# Créer une conversation

> Démarrez une nouvelle session de conversation avec un chatbot IA Famulor via l’API. Initialisez le contexte, les métadonnées utilisateur et le canal pour WhatsApp, le chat web ou le chat vocal.

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Créez une nouvelle conversation avec votre assistant IA Famulor. Utilisez ce point de terminaison pour démarrer une conversation widget ou test et recevoir l’historique initial.

### Corps de la requête

<ParamField body="assistant_id" type="string" required>
  UUID de l’assistant qui doit gérer la conversation
</ParamField>

<ParamField body="type" type="string" default="widget">
  Type de conversation. Options : `widget` (payant) ou `test` (gratuit pour le développement)
</ParamField>

<ParamField body="variables" type="object" optional>
  Variables personnalisées injectées dans le contexte de l’assistant (accessibles via `{{variable_name}}`)

  <Expandable title="exemples de variables">
    <ParamField body="customer_name" type="string">
      Nom pour la salutation ou la personnalisation
    </ParamField>

    <ParamField body="company" type="string">
      Nom de l’entreprise à mentionner dans les réponses
    </ParamField>

    <ParamField body="source" type="string">
      Source du trafic ou de la page (par ex. `pricing_page`)
    </ParamField>
  </Expandable>
</ParamField>

### Exemples de requête

### Champs de réponse

<ResponseField name="status" type="boolean" required>
  Indique si la requête a réussi
</ResponseField>

<ResponseField name="conversation_id" type="string" required>
  UUID de la conversation créée ; à utiliser pour les messages suivants
</ResponseField>

<ResponseField name="history" type="array">
  Historique initial de la conversation. Vide si l’assistant n’a pas de message initial.

  <Expandable title="éléments de l’historique">
    <ResponseField name="role" type="string">
      Rôle du message (`assistant` ou `user`)
    </ResponseField>

    <ResponseField name="content" type="string">
      Contenu textuel du message
    </ResponseField>
  </Expandable>
</ResponseField>

### Exemples de réponse

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

### Remarques

* Les conversations `type: "widget"` sont facturées ; `type: "test"` est gratuit pour le développement.
* Fournissez des `variables` pertinentes pour personnaliser le premier message de l’assistant.
* Poursuivez la conversation avec [`Envoyer un message`](/fr/api-v1/ai-chatbot/send-conversation) et récupérez l’historique avec [`Récupérer une conversation`](/fr/api-v1/ai-chatbot/get-conversation).