> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whaapy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Activar/Desactivar IA

> Activa o desactiva el agente de IA globalmente para todo el negocio

Activa o desactiva la IA para **todo tu negocio**. Cuando está desactivada, el agente no responderá a ningún mensaje entrante.

<Note>
  Este es un control global. Para controlar la IA en conversaciones individuales, usa [Control por Conversación](/api-reference/conversations/ai-control).
</Note>

## Parámetros

<ParamField body="enabled" type="boolean" required>
  `true` para activar la IA, `false` para desactivarla
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api.whaapy.com/agent/v1/toggle \
    -H "Authorization: Bearer wha_TU_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "enabled": false }'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.whaapy.com/agent/v1/toggle', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer wha_TU_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ enabled: false })
  });

  const data = await response.json();
  console.log(data.enabled); // false
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      'https://api.whaapy.com/agent/v1/toggle',
      headers={
          'Authorization': 'Bearer wha_TU_API_KEY',
          'Content-Type': 'application/json'
      },
      json={'enabled': False}
  )

  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "success": true,
    "enabled": false,
    "message": "Agente IA desactivado"
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "error": "Unauthorized",
    "message": "API Key inválida o expirada"
  }
  ```

  ```json 403 Forbidden theme={null}
  {
    "error": "Forbidden",
    "message": "Missing required scopes: agent:write"
  }
  ```
</ResponseExample>

## Response

| Campo     | Tipo    | Descripción                               |
| --------- | ------- | ----------------------------------------- |
| `success` | boolean | `true` si la operación fue exitosa        |
| `enabled` | boolean | Estado actual de la IA después del cambio |
| `message` | string  | Mensaje descriptivo                       |

## Scope Requerido

Este endpoint requiere el scope `agent:write` en tu API Key.

## Caso de Uso

<Accordion title="Desactivar IA durante mantenimiento">
  Cuando necesitas hacer mantenimiento o todo tu equipo está disponible para atender manualmente:

  ```javascript theme={null}
  // Desactivar IA
  await fetch('https://api.whaapy.com/agent/v1/toggle', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer wha_TU_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ enabled: false })
  });

  // ... realizar mantenimiento ...

  // Reactivar IA
  await fetch('https://api.whaapy.com/agent/v1/toggle', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer wha_TU_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ enabled: true })
  });
  ```
</Accordion>

<Tip>
  Si solo necesitas pausar la IA temporalmente, considera usar [Pausar IA](/api-reference/agent/pause) que se reactiva automáticamente.
</Tip>