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

# Lister les assistants

> Lister tous les assistants de l’utilisateur authentifié avec pagination

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

Ce point de terminaison vous permet de récupérer tous les assistants IA appartenant à l’utilisateur authentifié.

### Paramètres de requête

<ParamField query="per_page" type="integer">
  Nombre d’assistants par page (1 à 100, par défaut : 10)
</ParamField>

<ParamField query="page" type="integer">
  Numéro de page (par défaut : 1)
</ParamField>

### Champs de réponse

<ResponseField name="data" type="array">
  Tableau d’assistants

  <Expandable title="Propriétés de l’assistant">
    <ResponseField name="id" type="integer">
      L’identifiant unique de l’assistant
    </ResponseField>

    <ResponseField name="user_id" type="integer">
      L’ID de l’utilisateur propriétaire de cet assistant
    </ResponseField>

    <ResponseField name="phone_number_id" type="integer">
      L’ID du numéro de téléphone attribué à l’assistant
    </ResponseField>

    <ResponseField name="engine_id" type="integer">
      ID du moteur
    </ResponseField>

    <ResponseField name="synthesizer_id" type="integer">
      ID du synthétiseur
    </ResponseField>

    <ResponseField name="transcriber_id" type="integer">
      ID du transcripteur
    </ResponseField>

    <ResponseField name="voice_id" type="integer">
      L’ID de la voix utilisée par l’assistant
    </ResponseField>

    <ResponseField name="instance_id" type="integer">
      L’ID d’instance de l’assistant
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom de l’assistant
    </ResponseField>

    <ResponseField name="variables" type="object">
      Variables personnalisées de l’assistant
    </ResponseField>

    <ResponseField name="post_call_evaluation" type="boolean">
      Indique si l’évaluation post-appel est activée
    </ResponseField>

    <ResponseField name="fillers" type="integer">
      Indique si l’audio de remplissage est activé (1 = activé, 0 = désactivé)
    </ResponseField>

    <ResponseField name="post_call_schema" type="array">
      Définition du schéma pour l’extraction des données post-appel
    </ResponseField>

    <ResponseField name="tools" type="array">
      Tableau des outils intégrés configurés sur l’assistant. Chaque élément comporte `type` (identifiant de l’outil) et `data` (paramètres spécifiques à l’outil). Cette forme de réponse diffère de l’objet à plat utilisé dans les requêtes [Create](/fr/api-v1/assistants/create) et [Update](/fr/api-v1/assistants/update).

      <Expandable title="Forme d’un élément de la réponse">
        * `type` — par ex. `end_call`, `call_transfer`, `warm_call_transfer`, `dtmf_input`, `collect_keypad`, `calendar_integration`, `assistant_transfer`
        * `data` — objet contenant les champs de configuration de l’outil (mêmes noms que dans le corps de la requête, mais imbriqués sous `data` plutôt qu’au premier niveau)
      </Expandable>
    </ResponseField>

    <ResponseField name="is_webhook_active" type="boolean">
      Indique si les notifications webhook sont activées
    </ResponseField>

    <ResponseField name="webhook_url" type="string">
      L’URL du webhook pour les notifications post-appel
    </ResponseField>

    <ResponseField name="inbound_webhook_url" type="string">
      L’URL du webhook pour les notifications d’appels entrants
    </ResponseField>

    <ResponseField name="language" type="string">
      Langue
    </ResponseField>

    <ResponseField name="type" type="string">
      Le type d’assistant (entrant ou sortant)
    </ResponseField>

    <ResponseField name="status" type="string">
      Le statut actuel de l’assistant (actif ou inactif)
    </ResponseField>

    <ResponseField name="max_duration" type="integer">
      Durée maximale de l’appel en secondes
    </ResponseField>

    <ResponseField name="record" type="boolean">
      Indique si les appels doivent être enregistrés
    </ResponseField>

    <ResponseField name="initial_message" type="string">
      Le premier message que l’assistant prononcera
    </ResponseField>

    <ResponseField name="system_prompt" type="string">
      Le prompt système qui définit le comportement de l’assistant
    </ResponseField>

    <ResponseField name="flows_platform_id" type="integer">
      ID pour l’intégration avec la plateforme Flows
    </ResponseField>

    <ResponseField name="timezone" type="string">
      Le fuseau horaire configuré pour l’assistant
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Date et heure de création de l’assistant
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Date et heure de la dernière mise à jour de l’assistant
    </ResponseField>

    <ResponseField name="max_silence_duration" type="integer">
      Durée maximale de silence en secondes avant relance
    </ResponseField>

    <ResponseField name="reengagement_interval" type="integer">
      Intervalle de relance en secondes
    </ResponseField>

    <ResponseField name="deleted_at" type="string">
      Horodatage de suppression douce (null si non supprimé)
    </ResponseField>

    <ResponseField name="end_call_on_voicemail" type="integer">
      Indique si l’appel doit se terminer lors de la détection d’une messagerie vocale (1 = oui, 0 = non)
    </ResponseField>

    <ResponseField name="llm_temperature" type="string">
      Paramètre de température du LLM sous forme de chaîne
    </ResponseField>

    <ResponseField name="voice_stability" type="string">
      Paramètre de stabilité de la voix sous forme de chaîne
    </ResponseField>

    <ResponseField name="voice_similarity" type="string">
      Paramètre de similarité de la voix sous forme de chaîne
    </ResponseField>

    <ResponseField name="allow_interruptions" type="boolean">
      Indique si les interruptions par l’appelant sont autorisées
    </ResponseField>

    <ResponseField name="enable_noise_cancellation" type="boolean">
      Indique si la suppression du bruit est activée
    </ResponseField>

    <ResponseField name="endpoint_sensitivity" type="number">
      Niveau de sensibilité de fin de parole
    </ResponseField>

    <ResponseField name="speech_speed" type="string">
      Multiplicateur de vitesse de parole sous forme de chaîne
    </ResponseField>

    <ResponseField name="endpoint_type" type="string">
      Type de détection d’activité vocale (vad ou ai)
    </ResponseField>

    <ResponseField name="wait_for_customer" type="boolean">
      Indique s’il faut attendre la première prise de parole du client
    </ResponseField>

    <ResponseField name="mode" type="string">
      Le mode du moteur (pipeline ou multimodal)
    </ResponseField>

    <ResponseField name="language_id" type="integer">
      L’ID de la langue utilisée par l’assistant
    </ResponseField>

    <ResponseField name="transcriber_provider_id" type="integer">
      ID du fournisseur de transcription
    </ResponseField>

    <ResponseField name="synthesizer_provider_id" type="integer">
      ID du fournisseur de synthèse vocale
    </ResponseField>

    <ResponseField name="llm_model_id" type="integer">
      ID du modèle LLM utilisé
    </ResponseField>

    <ResponseField name="multimodal_model_id" type="integer">
      ID du modèle multimodal utilisé
    </ResponseField>

    <ResponseField name="ambient_sound" type="string">
      Paramètre de son d’ambiance
    </ResponseField>

    <ResponseField name="uuid" type="string">
      UUID unique de l’assistant
    </ResponseField>

    <ResponseField name="send_webhook_only_on_completed" type="boolean">
      Indique si les webhooks sont envoyés uniquement pour les appels terminés
    </ResponseField>

    <ResponseField name="include_recording_in_webhook" type="boolean">
      Indique si l’URL de l’enregistrement doit être incluse dans la charge utile du webhook
    </ResponseField>

    <ResponseField name="interrupt_sensitivity" type="number">
      Niveau de sensibilité aux interruptions
    </ResponseField>

    <ResponseField name="filler_config" type="object">
      Configuration des réponses audio de remplissage
    </ResponseField>

    <ResponseField name="knowledgebase_id" type="integer">
      ID de la base de connaissances associée
    </ResponseField>

    <ResponseField name="knowledgebase_mode" type="string">
      Paramètre de mode de la base de connaissances
    </ResponseField>

    <ResponseField name="min_interrupt_words" type="integer">
      Nombre minimum de mots avant que l’interruption soit autorisée
    </ResponseField>

    <ResponseField name="ambient_sound_volume" type="string">
      Volume du son d’ambiance sous forme de chaîne
    </ResponseField>

    <ResponseField name="widget_settings" type="object">
      Paramètres pour l’intégration du widget web
    </ResponseField>

    <ResponseField name="ringing_time" type="integer">
      Durée de sonnerie en secondes avant la fin de l’appel
    </ResponseField>

    <ResponseField name="max_initial_silence_duration" type="integer">
      Durée maximale de silence initial en secondes
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="current_page" type="integer">
  Le numéro de page actuel
</ResponseField>

<ResponseField name="per_page" type="integer">
  Nombre d’éléments par page
</ResponseField>

<ResponseField name="total" type="integer">
  Nombre total d’assistants
</ResponseField>

<ResponseField name="last_page" type="integer">
  Le numéro de la dernière page
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "data": [
      {
        "id": 123,
        "user_id": 456,
        "phone_number_id": 789,
        "engine_id": 1,
        "synthesizer_id": 2,
        "transcriber_id": 3,
        "voice_id": 4,
        "instance_id": 5,
        "name": "Sales Assistant",
        "variables": {
          "company_name": "Famulor",
          "product_focus": "AI Telephony"
        },
        "post_call_evaluation": true,
        "fillers": 1,
        "post_call_schema": [
          {
            "name": "customer_interested",
            "type": "boolean",
            "description": "Is the customer interested?"
          }
        ],
        "tools": [
          {
            "type": "end_call",
            "data": {
              "description": "End call when done"
            }
          },
          {
            "type": "assistant_transfer",
            "data": {
              "description": "Transfer to the Support Assistant when the customer needs technical help.",
              "assistant_id": 13766,
              "message_before_transfer": "Sure — let me transfer you to our support specialist.",
              "speak_transfer_greeting": true
            }
          },
          {
            "type": "warm_call_transfer",
            "data": {
              "supervisor_phone": "+14155552001",
              "outbound_phone_id": "7",
              "description": "Transfer the call to a human supervisor when the customer requests to speak with a real person.",
              "custom_sip": false,
              "caller_id_mode": "outbound_number",
              "hold_music": "hold_music",
              "hold_music_volume": 80,
              "hold_message": "Please hold while I connect you with a supervisor.",
              "summary_instructions": "Introduce the conversation from your perspective:\n- WHO is calling (name, company if mentioned)\n- WHY they called (their goal or problem)\n- WHY a human is needed at this point\n\nKeep it brief (2-3 sentences).",
              "briefing_initial_message": "Hello! I have a caller on the line who needs your assistance. May I brief you on the situation?",
              "connected_message": "You are now connected with a supervisor. I'll leave you to it."
            }
          }
        ],
        "is_webhook_active": true,
        "webhook_url": "https://example.com/webhook",
        "inbound_webhook_url": "https://example.com/inbound-webhook",
        "language": "de",
        "type": "outbound",
        "status": "active",
        "max_duration": 1800,
        "record": true,
        "initial_message": "Good day! I'm calling from Famulor...",
        "system_prompt": "You are a friendly sales assistant...",
        "flows_platform_id": null,
        "timezone": "Europe/Berlin",
        "created_at": "2024-01-15T10:30:00Z",
        "updated_at": "2024-01-15T10:30:00Z",
        "max_silence_duration": 3,
        "reengagement_interval": 5,
        "deleted_at": null,
        "end_call_on_voicemail": 1,
        "llm_temperature": "0.7",
        "voice_stability": "0.8",
        "voice_similarity": "0.9",
        "allow_interruptions": true,
        "enable_noise_cancellation": true,
        "endpoint_sensitivity": 0.5,
        "speech_speed": "1.0",
        "endpoint_type": "vad",
        "wait_for_customer": false,
        "mode": "pipeline",
        "language_id": 1,
        "transcriber_provider_id": 1,
        "synthesizer_provider_id": 1,
        "llm_model_id": 1,
        "multimodal_model_id": null,
        "ambient_sound": "office",
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "send_webhook_only_on_completed": true,
        "include_recording_in_webhook": false,
        "interrupt_sensitivity": 0.3,
        "filler_config": {
          "enabled": true,
          "phrases": ["Hmm...", "I understand..."]
        },
        "knowledgebase_id": 100,
        "knowledgebase_mode": "semantic",
        "min_interrupt_words": 2,
        "ambient_sound_volume": "0.3",
        "widget_settings": {
          "enabled": false
        }
      }
    ],
    "current_page": 1,
    "per_page": 10,
    "total": 1,
    "last_page": 1
  }
  ```
</ResponseExample>

<Tip>
  Pages associées : [Introduction](/fr/api-v1/introduction) et [Guide d’authentification](/fr/api-v1/authentication), et [Exemples d’intégration API](/fr/api-v1/introduction).
</Tip>
