AI Actions

AI Actions

Las AI Actions amplían las capacidades de tu Agente de IA más allá de responder preguntas a partir de la Base de Conocimiento. Te permiten definir comportamientos activados: cosas que la IA debe hacer cuando detecta situaciones específicas en una conversación.

Qué hacen las AI Actions:

• HTTP Request Actions — Llaman a APIs externas cuando se activan. Por ejemplo, comprobar el estado de un pedido en tu backend, crear un ticket de soporte o consultar información de una cuenta, todo durante la conversación.
• Remote MCP Actions — Se conectan a servidores Model Context Protocol para integraciones de herramientas avanzadas (p. ej., búsquedas de productos en Shopify, consultas a bases de datos personalizadas).

Casos de uso típicos:

• Consultar información en tiempo real (estado de pedidos, detalles de cuenta, inventario) desde tus sistemas backend durante las conversaciones
• Crear tickets, actualizar registros de CRM o disparar flujos de trabajo en sistemas externos según el contexto de la conversación
• Ofrecer recomendaciones personalizadas consultando tu catálogo de productos

Cada action tiene un name, una description (que indica a la IA cuándo activarla) y una configuración específica del tipo. Las actions pueden activarse/desactivarse individualmente mediante la API. Las actions se crean y configuran por completo en el Dashboard de Quickchat; la API ofrece operaciones de listar, actualizar (activar/desactivar) y eliminar.

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	Identificador de la AI Action
name string	Nombre visible
description string	Cuándo se activa la action
is_active boolean	Si está activada
type string	"http_request", "remote_mcp", "shopify_remote_mcp" o "knowledge_base"
icon string or null	Identificador del icono
icon_color string or null	Color del icono
is_valid boolean	Si está correctamente configurada

Update AI Action

Scope: write_all

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

Request Body

Parameter	Description
is_active boolean	Activar/desactivar la action
icon string	Identificador del icono (máx. 200 caracteres)
icon_color string	Color del icono (máx. 50 caracteres)

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 — Devuelve el snapshot actualizado de la 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 (cuerpo vacío)

---