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

> Listez toutes les campagnes (appel, WhatsApp, SMS) de votre compte Famulor via l'API. Consultez le canal, les plages horaires, la configuration WhatsApp/SMS et les paramètres de repli optionnels appel→texte.

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

Retourne toutes les campagnes vous appartenant, y compris le canal, les plages horaires, la configuration WhatsApp/SMS et les paramètres de repli optionnels appel→texte.

### Réponse

Retourne un tableau JSON d'objets de campagne.

<ResponseField name="array" type="array">
  Tableau de toutes les campagnes

  <Expandable title="Propriétés de la campagne">
    <ResponseField name="id" type="integer">
      ID de la campagne
    </ResponseField>

    <ResponseField name="name" type="string">
      Nom de la campagne
    </ResponseField>

    <ResponseField name="channel" type="string">
      `call`, `whatsapp` ou `sms`
    </ResponseField>

    <ResponseField name="status" type="string">
      p. ex. `draft`, `scheduled`, `in-progress`, `paused`, `completed`
    </ResponseField>

    <ResponseField name="assistant_id" type="integer">
      ID de l'assistant OUTBOUND (campagnes d'appel). `null` pour les campagnes texte.
    </ResponseField>

    <ResponseField name="timezone" type="string">
      Fuseau horaire IANA pour la fenêtre d'envoi/d'appel
    </ResponseField>

    <ResponseField name="max_calls_in_parallel" type="integer">
      Créneaux d'appel simultanés (campagnes d'appel)
    </ResponseField>

    <ResponseField name="messages_per_minute" type="integer">
      Débit d'envoi de texte par campagne (WhatsApp/SMS). WhatsApp utilise aussi un pool global de 10 envois en cours par utilisateur.
    </ResponseField>

    <ResponseField name="schedule_windows" type="array">
      Plages quotidiennes `[{ "start": "HH:MM", "end": "HH:MM" }]`. Chevauchement de minuit autorisé lorsque `end` \< `start`.
    </ResponseField>

    <ResponseField name="scheduled_start_at" type="string">
      Date-heure ISO pour le démarrage automatique, ou `null`
    </ResponseField>

    <ResponseField name="allowed_hours_start_time" type="string">
      Début de fenêtre hérité (synchronisé avec la première plage horaire)
    </ResponseField>

    <ResponseField name="allowed_hours_end_time" type="string">
      Fin de fenêtre héritée
    </ResponseField>

    <ResponseField name="allowed_days" type="array">
      Jours de la semaine où l'envoi/l'appel est autorisé
    </ResponseField>

    <ResponseField name="max_retries" type="integer">
      Nombre maximal de relances par lead
    </ResponseField>

    <ResponseField name="retry_interval" type="integer">
      Minutes entre les relances
    </ResponseField>

    <ResponseField name="retry_on_voicemail" type="boolean">
      Campagnes d'appel : relancer en cas de messagerie vocale
    </ResponseField>

    <ResponseField name="retry_on_goal_incomplete" type="boolean">
      Campagnes d'appel : relancer jusqu'à ce que la variable d'objectif soit vraie
    </ResponseField>

    <ResponseField name="goal_completion_variable" type="string">
      Nom de la variable booléenne post-appel, ou `null`
    </ResponseField>

    <ResponseField name="mark_complete_when_no_leads" type="boolean">
      Passage automatique à « terminé » lorsqu'il ne reste plus de travail
    </ResponseField>

    <ResponseField name="phone_number_ids" type="array">
      ID des numéros expéditeurs sortants (campagnes d'appel)
    </ResponseField>

    <ResponseField name="whatsapp_sender_id" type="integer">
      ID de l'expéditeur WhatsApp, ou `null`
    </ResponseField>

    <ResponseField name="whatsapp_template_id" type="integer">
      ID du modèle WhatsApp, ou `null`
    </ResponseField>

    <ResponseField name="sms_from_phone_number_id" type="integer">
      ID du numéro expéditeur SMS, ou `null`
    </ResponseField>

    <ResponseField name="sms_body" type="string">
      Corps du SMS, ou `null`
    </ResponseField>

    <ResponseField name="text_variable_mapping" type="object">
      Correspondance entre les placeholders du modèle WhatsApp et les variables du lead, ou `null`
    </ResponseField>

    <ResponseField name="fallback_channel" type="string">
      Canal de repli appel→texte (`whatsapp` / `sms`), ou `null`
    </ResponseField>

    <ResponseField name="fallback_whatsapp_sender_id" type="integer">
      Expéditeur WhatsApp de repli, ou `null`
    </ResponseField>

    <ResponseField name="fallback_whatsapp_template_id" type="integer">
      Modèle WhatsApp de repli, ou `null`
    </ResponseField>

    <ResponseField name="fallback_sms_from_phone_number_id" type="integer">
      Numéro expéditeur SMS de repli, ou `null`
    </ResponseField>

    <ResponseField name="fallback_sms_body" type="string">
      Corps du SMS de repli, ou `null`
    </ResponseField>

    <ResponseField name="fallback_variable_mapping" type="object">
      Correspondance de variables WhatsApp de repli, ou `null`
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Horodatage de création dans le fuseau horaire de votre compte
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Horodatage de mise à jour dans le fuseau horaire de votre compte
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 1,
      "name": "New Customer Acquisition Q1 2026",
      "channel": "call",
      "status": "in-progress",
      "assistant_id": 42,
      "timezone": "Europe/Berlin",
      "max_calls_in_parallel": 5,
      "messages_per_minute": null,
      "schedule_windows": [
        { "start": "09:00", "end": "18:00" }
      ],
      "scheduled_start_at": null,
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "18:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_retries": 3,
      "retry_interval": 60,
      "retry_on_voicemail": true,
      "retry_on_goal_incomplete": false,
      "goal_completion_variable": null,
      "mark_complete_when_no_leads": true,
      "phone_number_ids": [101, 102],
      "whatsapp_sender_id": null,
      "whatsapp_template_id": null,
      "sms_from_phone_number_id": null,
      "sms_body": null,
      "text_variable_mapping": null,
      "fallback_channel": "whatsapp",
      "fallback_whatsapp_sender_id": 7,
      "fallback_whatsapp_template_id": 15,
      "fallback_sms_from_phone_number_id": null,
      "fallback_sms_body": null,
      "fallback_variable_mapping": { "1": "first_name" },
      "created_at": "2026-01-10T08:00:00Z",
      "updated_at": "2026-01-15T14:30:00Z"
    }
  ]
  ```
</ResponseExample>

<Tip>
  Voir aussi : [Introduction](/fr/api-v1/introduction) et [Guide d'authentification](/fr/api-v1/authentication), et [Exemples d'intégration API](/fr/api-v1/introduction).
</Tip>