Conversation Metadata

Conversation Metadata te permite adjuntar datos clave-valor personalizados a las conversaciones, creando un potente puente entre tus sistemas y tu Agente de IA. Los metadatos fluyen por todo tu flujo de trabajo de Quickchat:

• Alimentar vía API — Usa estos endpoints para adjuntar metadatos de forma programática a cualquier conversación (p. ej., desde tu CRM, helpdesk o backend)
• Alimentar vía widget/embed — Pasa metadatos como parámetros de inicialización al cargar el widget, o inyéctalos dinámicamente durante una conversación activa usando el SDK de JavaScript
• Visibles en el Dashboard — Los metadatos aparecen en la vista de detalle de la conversación en la Inbox, de modo que tu equipo siempre tenga contexto
• Incluidos en las exportaciones — Los metadatos se incluyen cuando exportas conversaciones desde el Dashboard, lo que los hace disponibles para análisis sin conexión
• Usados en AI Actions — Los valores de metadatos pueden inyectarse directamente como marcadores {{metadata_<key>}} en las AI Actions. Consulta AI Action Variables para la referencia completa de marcadores disponibles
• Disponibles para el Agente de IA — Tu Agente de IA conoce los valores de metadatos y puede referenciarlos durante las conversaciones. Por ejemplo, pasa el nombre de un cliente o su nivel de plan, y la IA personalizará sus respuestas en consecuencia

Los metadatos son la forma de dirigir y personalizar dinámicamente cada conversación. Pasa IDs de cliente, niveles de cuenta, fuentes de referencia, variantes de tests A/B o cualquier contexto que tu Agente de IA necesite. Esta capacidad se ampliará significativamente en futuras versiones.

Los metadatos se validan contra un esquema JSON si hay uno configurado en el Dashboard.

Get Metadata

Scope: read_all

GET https://app.quickchat.ai/v1/api_core/conversations/{conv_id}/metadata

Shell

curl https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Response 200 OK

{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}

Set Metadata

Crea o actualiza los metadatos de una conversación.

Scope: write_all

POST https://app.quickchat.ai/v1/api_core/conversations/{conv_id}/metadata

Request Body

Parameter	Description
metadata object, required	Metadatos clave-valor que almacenar

Shell

curl -X POST https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "metadata": {"ticket_id": "T-1234", "priority": "high"}
    },
)
data = response.json()

Response 200 OK

{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}

---