Hoppa till innehåll

Hantera din AI Agents AI Actions via API:et.

AI Actions utökar din AI Agents förmågor utöver att besvara frågor från Knowledge Base. De låter dig definiera utlösta beteenden — saker som AI:n ska göra när den upptäcker specifika situationer i en konversation.

Vad AI Actions gör:

  • HTTP Request Actions — Anropa externa API:er när de utlöses. Till exempel kontrollera orderstatus i din backend, skapa ett supportärende eller slå upp kontoinformation — allt under konversationens gång.
  • Remote MCP Actions — Anslut till Model Context Protocol-servrar för avancerade verktygsintegrationer (t.ex. Shopify-produktuppslagningar, anpassade databasfrågor).

Typiska användningsfall:

  • Slå upp information i realtid (orderstatus, kontouppgifter, lagersaldo) från dina backend-system under konversationer
  • Skapa ärenden, uppdatera CRM-poster eller utlösa workflows i externa system baserat på konversationskontext
  • Ge personliga rekommendationer genom att fråga din produktkatalog

Varje action har ett name, en description (som talar om för AI:n när den ska utlösas) och en typspecifik konfiguration. Actions kan aktiveras/inaktiveras individuellt via API:et. Actions skapas och konfigureras fullständigt i Quickchat Dashboard — API:et tillhandahåller list-, uppdaterings- (aktivera/inaktivera) och borttagningsoperationer.

Scope: read_all

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

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

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
}
]
FieldDescription
id
integer
AI Action-identifierare
name
string
Visningsnamn
description
string
När aktionen utlöses
is_active
boolean
Om den är aktiverad
type
string
"http_request", "remote_mcp", "shopify_remote_mcp" eller "knowledge_base"
icon
string or null
Ikonidentifierare
icon_color
string or null
Ikonfärg
is_valid
boolean
Om den är korrekt konfigurerad
Scope: write_all

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

Request Body

ParameterDescription
is_active
boolean
Aktivera/inaktivera aktionen
icon
string
Ikonidentifierare (max 200 tecken)
icon_color
string
Ikonfärg (max 50 tecken)
Terminal window
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}'

Response 200 OK — Returnerar den uppdaterade AI Action-ögonblicksbilden.

Scope: write_all

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

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

Response 200 OK (tom body)