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

# Actualizar el estado de la campaña

> Inicia o detén una campaña de llamada, WhatsApp o SMS a través de la API. Al iniciar se valida la configuración del canal, la programación y el saldo.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Inicia o detiene una campaña de tu propiedad. Al iniciar se valida la configuración del canal (asistente / plantilla de WhatsApp / número de SMS), la programación y el saldo. Los canales desactivados (por ejemplo SMS cuando no está disponible temporalmente) no se pueden iniciar.

### Cuerpo de la solicitud

<ParamField body="campaign_id" type="integer" required>
  El ID de la campaña a actualizar
</ParamField>

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

### Respuesta

<ResponseField name="message" type="string" default="Campaign started successfully.">
  Resultado legible por humanos
</ResponseField>

<ResponseField name="success" type="boolean" default="true">
  Indica si la operación se realizó correctamente
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="propiedades de data">
    <ResponseField name="campaign_id" type="integer">
      ID de la campaña
    </ResponseField>

    <ResponseField name="status" type="string" default="in-progress">
      Nuevo estado (p. ej. `in-progress`, `paused`)
    </ResponseField>

    <ResponseField name="channel" type="string">
      `call`, `whatsapp` o `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>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>