AI Actions

AI Actions

AI Actions rozszerzają możliwości Twojego AI Agenta poza odpowiadanie na pytania z Bazy Wiedzy. Pozwalają zdefiniować wyzwalane zachowania — czynności, które AI powinien wykonać, gdy wykryje określone sytuacje w rozmowie.

Co robią AI Actions:

• HTTP Request Actions — Wywołują zewnętrzne API po wyzwoleniu. Na przykład sprawdzają status zamówienia w Twoim backendzie, tworzą zgłoszenie do supportu lub wyszukują informacje o koncie — wszystko w trakcie rozmowy.
• Remote MCP Actions — Łączą się z serwerami Model Context Protocol w celu zaawansowanych integracji narzędziowych (np. wyszukiwanie produktów w Shopify, niestandardowe zapytania do bazy danych).

Typowe zastosowania:

• Wyszukiwanie informacji w czasie rzeczywistym (status zamówienia, szczegóły konta, stan magazynu) z Twoich systemów backendowych podczas rozmów
• Tworzenie zgłoszeń, aktualizowanie rekordów w CRM lub wyzwalanie workflow w systemach zewnętrznych na podstawie kontekstu rozmowy
• Dostarczanie spersonalizowanych rekomendacji poprzez odpytywanie Twojego katalogu produktów

Każda akcja ma name, description (które mówi AI, kiedy ją wyzwolić) oraz konfigurację zależną od typu. Akcje można włączać/wyłączać indywidualnie przez API. Akcje są tworzone i w pełni konfigurowane w Dashboardzie Quickchat — API udostępnia operacje listowania, aktualizacji (włączanie/wyłączanie) i usuwania.

List All AI Actions

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()

Response 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	Identyfikator AI Action
name string	Nazwa wyświetlana
description string	Kiedy akcja się wyzwala
is_active boolean	Czy włączona
type string	"http_request", "remote_mcp", "shopify_remote_mcp" lub "knowledge_base"
icon string or null	Identyfikator ikony
icon_color string or null	Kolor ikony
is_valid boolean	Czy poprawnie skonfigurowana

Update AI Action

Scope: write_all

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

Request Body

Parameter	Description
is_active boolean	Włącz/wyłącz akcję
icon string	Identyfikator ikony (maks. 200 znaków)
icon_color string	Kolor ikony (maks. 50 znaków)

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()

Response 200 OK — Zwraca zaktualizowany snapshot AI Action.

Delete AI Action

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>"},
)

Response 200 OK (puste body)

---