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

# Desativar IA

> Desativa as respostas da IA para uma conversa específica, permitindo que um agente humano assuma

Desativa as respostas da IA para uma conversa. Uma vez desativada, a assistente parará de gerar respostas — quaisquer novas mensagens na conversa serão armazenadas, mas não respondidas pela IA.

Isso é útil para fluxos de **assunção humana**: configure uma ferramenta de chamada ou automação que chame este endpoint quando um cliente solicitar falar com um agente humano.

### Autenticação

Este endpoint requer sua **chave de API do Automate** como um token Bearer.

### Parâmetros de Caminho

<ParamField path="uuid" type="string" required>
  O identificador UUID único da conversa
</ParamField>

### Campos de Resposta

<ResponseField name="status" type="boolean">
  `true` quando a operação for bem-sucedida
</ResponseField>

<ResponseField name="ai_enabled" type="boolean">
  Sempre será `false` em caso de sucesso
</ResponseField>

### Respostas de Erro

<ResponseField name="status" type="boolean">
  `false` quando ocorre um erro
</ResponseField>

<ResponseField name="error" type="string">
  Mensagem de erro. Valores possíveis:

  * `Conversa não encontrada` — o UUID não existe ou pertence a uma conta diferente
</ResponseField>

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

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

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

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

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

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

  response = requests.post(
      f'https://suasofia.online/api/automate/conversations/{conversation_id}/disable-ai',
      headers={'Authorization': 'Bearer SUA_CHAVE_API'}
  )

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

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

  ```json 404 Not Found theme={null}
  {
    "status": false,
    "error": "Conversa não encontrada"
  }
  ```

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

## Fluxo de Assunção Humana

Um padrão comum é configurar uma ferramenta de chamada que aciona este endpoint quando o cliente pede para falar com um humano:

1. Crie uma ferramenta de chamada (por exemplo, `transfer_to_human`) com um webhook apontando para seu ActivePieces ou fluxo de automação
2. No seu fluxo de automação, chame `POST /automate/conversations/{uuid}/disable-ai` usando sua chave de API
3. Notifique sua equipe de suporte (por exemplo, via Slack, e-mail ou CRM) com o UUID da conversa
4. A IA para de responder — seu agente assume enviando mensagens diretamente

Para reabilitar a IA mais tarde, use o endpoint [Habilitar IA](/api-reference/conversations/enable-ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.