AI Actions

AI Actions

Les AI Actions étendent les capacités de votre AI Agent au-delà des réponses aux questions à partir de la Knowledge Base. Elles vous permettent de définir des comportements déclenchés : des choses que l’IA doit faire lorsqu’elle détecte des situations spécifiques dans une conversation.

Ce que font les AI Actions :

• HTTP Request Actions — Appellent des API externes lorsqu’elles sont déclenchées. Par exemple, vérifier le statut d’une commande dans votre backend, créer un ticket de support ou consulter des informations de compte, le tout pendant la conversation.
• Remote MCP Actions — Se connectent à des serveurs Model Context Protocol pour des intégrations d’outils avancées (p. ex. recherches de produits Shopify, requêtes de base de données personnalisées).

Cas d’usage typiques :

• Consulter des informations en temps réel (statut de commande, détails de compte, inventaire) depuis vos systèmes backend pendant les conversations
• Créer des tickets, mettre à jour des enregistrements CRM ou déclencher des workflows dans des systèmes externes selon le contexte de la conversation
• Fournir des recommandations personnalisées en interrogeant votre catalogue de produits

Chaque action a un name, une description (qui indique à l’IA quand la déclencher) et une configuration propre à son type. Les actions peuvent être activées/désactivées individuellement via l’API. Les actions sont créées et entièrement configurées dans le Dashboard Quickchat — l’API fournit les opérations de liste, de mise à jour (activation/désactivation) et de suppression.

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	Identifiant de l’AI Action
name string	Nom d’affichage
description string	Quand l’action se déclenche
is_active boolean	Si elle est activée
type string	"http_request", "remote_mcp", "shopify_remote_mcp", ou "knowledge_base"
icon string or null	Identifiant de l’icône
icon_color string or null	Couleur de l’icône
is_valid boolean	Si elle est correctement configurée

Update AI Action

Scope: write_all

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

Request Body

Parameter	Description
is_active boolean	Activer/désactiver l’action
icon string	Identifiant de l’icône (max 200 caractères)
icon_color string	Couleur de l’icône (max 50 caractères)

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 — Retourne le snapshot de l’AI Action mise à jour.

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

---