Zum Hauptinhalt springen
POST
/
api
/
automate
/
conversations
/
{uuid}
/
disable-ai
curl -X POST "https://app.famulor.de/api/automate/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/disable-ai" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "status": true,
  "ai_enabled": false
}

Documentation Index

Fetch the complete documentation index at: https://docs.famulor.io/llms.txt

Use this file to discover all available pages before exploring further.

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 Ihren Automate API Key als Bearer-Token.

Path-Parameter

uuid
string
erforderlich
Die eindeutige UUID der Konversation

Antwort-Felder

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

Fehlerantworten

status
boolean
false, wenn ein Fehler auftritt
error
string
Fehlermeldung. Mögliche Werte:
  • Conversation not found — die UUID existiert nicht oder gehört zu einem anderen Account
curl -X POST "https://app.famulor.de/api/automate/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/disable-ai" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "status": true,
  "ai_enabled": false
}

Human-Takeover-Flow

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