Skip to main content
POST
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

string
required
O identificador UUID único da conversa

Campos de Resposta

boolean
true quando a operação for bem-sucedida
boolean
Sempre será false em caso de sucesso

Respostas de Erro

boolean
false quando ocorre um erro
string
Mensagem de erro. Valores possíveis:
  • Conversa não encontrada — o UUID não existe ou pertence a uma conta diferente

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.