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

# Desactivar IA

> Desactiva las respuestas de IA para una conversación específica y transfiérela a un humano

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

Desactiva las respuestas de IA para una conversación. Una vez desactivada, el asistente dejará de generar respuestas: los mensajes nuevos de la conversación se siguen almacenando, pero la IA no los responde.

Esto resulta útil para flujos de **transferencia a un humano**: activa este endpoint cuando un cliente pida hablar con un agente humano.

### Autenticación

Este endpoint requiere tu **clave de API de Automate** como token Bearer.

### Parámetros de ruta

<ParamField path="uuid" type="string" required>
  El identificador UUID único de la conversación
</ParamField>

### Campos de respuesta

<ResponseField name="status" type="boolean">
  `true` cuando la operación se realizó correctamente
</ResponseField>

<ResponseField name="ai_enabled" type="boolean">
  Siempre `false` si la operación es correcta
</ResponseField>

### Respuestas de error

<ResponseField name="status" type="boolean">
  `false` cuando ocurre un error
</ResponseField>

<ResponseField name="error" type="string">
  Mensaje de error. Valores posibles:

  * `Conversation not found` — el UUID no existe o pertenece a otra cuenta
</ResponseField>

<RequestExample>
  ```bash cURL theme={null} theme={null}
  curl -X POST "https://app.famulor.de/api/automate/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/disable-ai" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null} theme={null}
  const conversationId = '7c9e6679-7425-40de-944b-e07fc1f90ae7';

  const response = await fetch(
    `https://app.famulor.de/api/automate/conversations/${conversationId}/disable-ai`,
    {
      method: 'POST',
      headers: {
        Authorization: 'Bearer YOUR_API_KEY',
      },
    }
  );

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

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

  conversation_id = '7c9e6679-7425-40de-944b-e07fc1f90ae7'

  response = requests.post(
      f'https://app.famulor.de/api/automate/conversations/{conversation_id}/disable-ai',
      headers={'Authorization': 'Bearer YOUR_API_KEY'}
  )

  data = response.json()
  print(data['ai_enabled'])  # False
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null} theme={null}
  {
    "status": true,
    "ai_enabled": false
  }
  ```

  ```json 404 Not Found theme={null} theme={null}
  {
    "status": false,
    "error": "Conversation not found"
  }
  ```

  ```json 401 Unauthorized theme={null} theme={null}
  {
    "error": "Unauthorized"
  }
  ```
</ResponseExample>

## Flujo de transferencia a un humano

Un patrón de transferencia habitual:

1. Crea una herramienta mid-call (por ejemplo `transfer_to_human`) con un webhook hacia ActivePieces o tu flujo de automatización.
2. En el flujo de automatización, llama a `POST /automate/conversations/{uuid}/disable-ai` con tu clave de API.
3. Notifica a tu equipo de soporte (por ejemplo por Slack, correo electrónico o CRM) incluyendo el UUID de la conversación.
4. La IA deja de responder — tu agente humano toma el control enviando mensajes directamente.

Para reactivar la IA más tarde, usa el endpoint [Activar IA](/es/api-v1/conversations/enable-ai).