AI Actions

AI Actions

AI Actions erweitern die Fähigkeiten Ihres KI-Agenten über das Beantworten von Fragen aus der Wissensdatenbank hinaus. Mit ihnen definieren Sie ausgelöste Verhaltensweisen — Dinge, die die KI tun soll, wenn sie bestimmte Situationen in einer Konversation erkennt.

Was AI Actions tun:

• HTTP Request Actions — Externe APIs aufrufen, wenn ausgelöst. Zum Beispiel den Bestellstatus in Ihrem Backend prüfen, ein Support-Ticket erstellen oder Kontoinformationen nachschlagen — alles während der Konversation.
• Remote MCP Actions — Verbindung zu Model-Context-Protocol-Servern für fortgeschrittene Tool-Integrationen herstellen (z. B. Shopify-Produktsuchen, eigene Datenbankabfragen).

Typische Anwendungsfälle:

• Echtzeitinformationen (Bestellstatus, Kontodetails, Lagerbestand) aus Ihren Backend-Systemen während Konversationen nachschlagen
• Tickets erstellen, CRM-Datensätze aktualisieren oder Workflows in externen Systemen basierend auf dem Konversationskontext auslösen
• Personalisierte Empfehlungen geben, indem Ihr Produktkatalog abgefragt wird

Jede Aktion hat einen name, eine description (die der KI mitteilt, wann sie ausgelöst werden soll) und eine typspezifische Konfiguration. Aktionen können einzeln über die API aktiviert/deaktiviert werden. Aktionen werden im Quickchat Dashboard erstellt und vollständig konfiguriert — die API bietet List-, Update- (Aktivieren/Deaktivieren) und Delete-Operationen.

Alle AI Actions auflisten

Scope: read_all

GET https://app.quickchat.ai/v1/api/ai_actions

Shell

curl https://app.quickchat.ai/v1/api/ai_actions \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/ai_actions",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Antwort 200 OK

[
  {
    "id": 1,
    "name": "Check Order Status",
    "description": "Look up order status when customer asks about their order.",
    "is_active": true,
    "type": "http_request",
    "icon": null,
    "icon_color": null,
    "is_valid": true
  }
]

Field	Description
id integer	Identifier der AI Action
name string	Anzeigename
description string	Wann die Aktion ausgelöst wird
is_active boolean	Ob aktiviert
type string	"http_request", "remote_mcp", "shopify_remote_mcp" oder "knowledge_base"
icon string or null	Icon-Identifier
icon_color string or null	Icon-Farbe
is_valid boolean	Ob ordnungsgemäß konfiguriert

AI Action aktualisieren

Scope: write_all

PATCH https://app.quickchat.ai/v1/api/ai_actions/{action_id}

Request-Body

Parameter	Description
is_active boolean	Die Aktion aktivieren/deaktivieren
icon string	Icon-Identifier (max. 200 Zeichen)
icon_color string	Icon-Farbe (max. 50 Zeichen)

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/ai_actions/1 \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"is_active": false}'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/ai_actions/1",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"is_active": False},
)
data = response.json()

Antwort 200 OK — Gibt den aktualisierten Snapshot der AI Action zurück.

AI Action löschen

Scope: write_all

DELETE https://app.quickchat.ai/v1/api/ai_actions/{action_id}

Shell

curl -X DELETE https://app.quickchat.ai/v1/api/ai_actions/1 \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.delete(
    url="https://app.quickchat.ai/v1/api/ai_actions/1",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)

Antwort 200 OK (leerer Body)

---