Skip to main content
POST
Deaktiviert AI-Antworten für eine Konversation. Nach der Deaktivierung stoppt der Assistent die Antwortgenerierung. Neue Nachrichten werden weiterhin gespeichert, aber nicht mehr von der AI beantwortet. Das ist ideal für Human-Takeover-Workflows, wenn ein Kunde mit einem menschlichen Agenten sprechen möchte.

Authentifizierung

Dieser Endpunkt benötigt deinen Automate API Key als Bearer-Token.

Path-Parameter

string
erforderlich
Die eindeutige UUID der Konversation

Antwort-Felder

boolean
true, wenn die Operation erfolgreich war
boolean
Ist bei Erfolg immer false

Fehlerantworten

boolean
false, wenn ein Fehler auftritt
string
Fehlermeldung. Mögliche Werte:
  • Conversation not found — die UUID existiert nicht oder gehört zu einem anderen Account

Human-Takeover-Flow

Ein häufiger Übergabe-Flow:
  1. Erstelle ein Mid-Call-Tool (z. B. transfer_to_human) mit Webhook zu ActivePieces oder deinem Automations-Flow.
  2. Rufe im Automations-Flow POST /automate/conversations/{uuid}/disable-ai mit deinem API Key auf.
  3. Benachrichtige dein Support-Team (z. B. via Slack, E-Mail oder CRM) mit der Conversation-UUID.
  4. Die AI stoppt Antworten — dein menschlicher Agent übernimmt direkt im Chat.
Zum späteren Reaktivieren nutzt du den Endpunkt AI aktivieren.