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

# Mettre à jour le statut d'une campagne

> Démarrez ou arrêtez une campagne d'appel, WhatsApp ou SMS via l'API. Le démarrage valide la configuration du canal, la planification et le solde.

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

Démarre ou arrête une campagne vous appartenant. Le démarrage valide la configuration du canal (assistant / modèle WhatsApp / numéro SMS), la planification et le solde. Les canaux désactivés (par exemple le SMS lorsqu'il est temporairement indisponible) ne peuvent pas être démarrés.

### Corps de la requête

<ParamField body="campaign_id" type="integer" required>
  L'ID de la campagne à mettre à jour
</ParamField>

<ParamField body="action" type="string" required>
  `start` ou `stop`
</ParamField>

### Réponse

<ResponseField name="message" type="string" default="Campaign started successfully.">
  Résultat lisible par un humain
</ResponseField>

<ResponseField name="success" type="boolean" default="true">
  Indique si l'opération a réussi
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="propriétés de data">
    <ResponseField name="campaign_id" type="integer">
      ID de la campagne
    </ResponseField>

    <ResponseField name="status" type="string" default="in-progress">
      Nouveau statut (p. ex. `in-progress`, `paused`)
    </ResponseField>

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

<ResponseExample>
  ```json 200 Campaign started theme={null}
  {
    "message": "Campaign started successfully.",
    "success": true,
    "data": {
      "campaign_id": 2324,
      "status": "in-progress",
      "channel": "call"
    }
  }
  ```

  ```json 200 Campaign stopped theme={null}
  {
    "message": "Campaign stopped successfully.",
    "success": true,
    "data": {
      "campaign_id": 2324,
      "status": "paused",
      "channel": "whatsapp"
    }
  }
  ```

  ```json 400 Invalid action theme={null}
  {
    "message": "Invalid action. Must be either 'start' or 'stop'.",
    "success": false
  }
  ```

  ```json 404 Campaign not found theme={null}
  {
    "message": "Campaign not found.",
    "success": false
  }
  ```

  ```json 400 Insufficient balance theme={null}
  {
    "message": "Insufficient balance to start the campaign. Please top up your account.",
    "success": false,
    "data": {
      "campaign_id": 2324,
      "status": "draft",
      "channel": "call"
    }
  }
  ```
</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>