Acciones

Define lo que tu Agente de IA puede hacer durante la conversación: desde responder con datos de API en tiempo real y recopilar leads hasta ejecutar tareas personalizadas.

Transferencia a humano (Human Handoff)

La función Human Handoff garantiza que las conversaciones que requieren atención humana se transfieran sin fricción a un Agente humano.

Es especialmente útil para preguntas fuera de la Base de Conocimiento o cuando el usuario pide hablar con una persona. Durante la transferencia, el Asistente de IA se pausa y el Agente humano toma el control desde la Bandeja de entrada (Inbox).

Así se ve para el usuario:

1. El usuario interactúa con el Asistente de IA.
2. Si la petición supera la capacidad de la IA o se solicita explícitamente un humano, la IA notifica la transferencia.
3. La conversación se desasigna de la IA y pasa a un Agente humano.
4. El humano resuelve la consulta o reasigna a la IA para continuar.

Así se ve en la interfaz de Quickchat AI:

1. La conversación no asignada aparece en la Inbox.
2. Tu compañero revisa el Resumen de IA.
3. Toma el control y gestiona la petición.
4. Marca como resuelta o reasigna.

Activar Human Handoff

Ve a Capabilities > Human Handoff y actívalo.

Puedes configurar:

Disponibilidad del Agente humano

Define la disponibilidad para iniciar transferencias solo en horario laboral.

• Horario de trabajo: inicio/fin y días activos
• Zona horaria
• Mensaje fuera de horario

Pregunta

Define la pregunta que la IA hará antes de transferir.

Ejemplo: ¿Quieres que te ponga en contacto con nuestro equipo de Soporte?

Confirmación

Especifica el mensaje de confirmación cuando se inicia la transferencia.

Ejemplo: De acuerdo. Te transfiero con nuestro equipo de Soporte. Un momento, por favor.

Resumen de IA

Activa los resúmenes automáticos para generar una breve síntesis de la conversación y dar contexto al Agente humano.

(Opcional) Palabras clave de disparo

Puedes introducir palabras que siempre activen la transferencia.

Precaución

Es opcional, ya que Human Handoff detecta la intención automáticamente y transfiere si es necesario.

Ejemplo: para el Asistente “Helpful Macintosh” de MacShop, palabras como “factura”, “recibo” y “estado de entrega”.

Notificaciones por correo

Configura correos para recibir avisos cuando una conversación requiera transferencia humana.

---

Recopilación inteligente de datos / Generación de leads

La Recopilación inteligente de datos permite a tu Agente pedir información (nombre, correo, teléfono, etc.) de forma natural. Los datos pueden enviarse a tu CRM u otros sistemas.

Cómo funciona

Se integra en el flujo de la conversación.

1. La IA detecta oportunidades de recopilación.
2. Formula preguntas específicas, por ejemplo:
   • “¿Cuál es tu nombre para poder ayudarte mejor?”
   • “¿Cuál es el mejor correo para contactarte?”
3. Guarda las respuestas para revisión o integración.

Configuración

Activar Recopilación de Datos

• Ve a Actions & MCPs
• Busca Smart Data Gathering
• Actívalo

Datos a recopilar

• Correo electrónico
• Nombre
• Teléfono

Cuándo pedirlos

• Tras varios mensajes
• Justo después de mostrar interés

Cómo pedirlos

• Sutil: integrado en la conversación
• Directo: solicitud explícita

Exportar los datos recopilados

1. Ve a la Inbox
2. Haz clic en export
3. Elige Export Gathered Data
4. Define rango de fechas
5. Selecciona formato (CSV, XLSX)
6. Download

---

Acciones personalizadas

Permiten que tu IA llame APIs externas durante el chat. Úsalas para buscar en herramientas internas, crear tickets, disparar alertas o traer datos actualizados fuera de la Base de Conocimiento. Están en Actions & MCPs → Custom Actions.

Cómo funcionan

1. Defines una Acción de API con nombre, descripción, método HTTP, URL, cabeceras y parámetros.
2. En el chat, la IA decide cuándo ejecutarla según tu descripción y pistas de parámetros.
3. Quickchat envía la petición y devuelve el JSON a la IA, que responde al usuario en lenguaje natural.
4. Puedes probar la petición desde el editor antes de usarla en conversaciones.

Consejo

Escribe la descripción como una instrucción para la IA: cuándo usarla, qué devuelve y límites.

Crear una Acción de API

1. Abre Actions & MCPs.
2. Haz clic en + en Custom Actions y elige API Action.
3. Completa Details:
   • Name: claro y descriptivo
   • Description: cuándo usarla y qué incluir en parámetros
4. Configura Connection:
   • Action Type: GET o POST
   • Action endpoint URL: URL completa
   • Headers: cabeceras necesarias (Authorization, content-type: application/json, etc.)
5. Define Parameters: para cada parámetro, name, location (query, body o header) y description guiando a la IA sobre cómo componer el valor. Los valores de ruta (path) no son una location de parámetro; insértalos directamente en la URL del endpoint mediante plantillas {{placeholder}}.
6. Test request, verifica y Done.

Más allá de la petición en sí, una API Action tiene tres ajustes opcionales que conviene conocer: Save to memory, Run only when y Response filter.

Save to memory

Captura un valor de la respuesta de la API y guárdalo en la memoria de la conversación bajo una clave que tú elijas. Acciones posteriores pueden reutilizarlo como {{metadata_<key>}}, y aparece en los detalles de la conversación (Inbox, la API y las exportaciones).

Recurre a esto cuando una Action produce algo que una Action posterior necesita. Una Action de búsqueda puede guardar un customer_id de su respuesta; una Action de seguimiento envía después {{metadata_customer_id}} sin que la IA tenga que copiar el valor de una a otra.

En la sección Save to memory del editor de la API Action, asigna a la valor capturado una memory key y apúntala a la parte de la respuesta que quieras conservar. A partir de ahí es una variable de metadatos como cualquier otra.

Consejo

Usa claves en snake_case (letras, dígitos, guiones bajos). Una clave como customer_id se puede referenciar como {{metadata_customer_id}}; las claves con espacios u otra puntuación no pueden usarse en marcadores. Consulta Metadatos de conversación para saber cómo funcionan las variables de metadatos.

Run only when

Restringe una Action para que se ejecute solo cuando se cumplen condiciones sobre los metadatos de la conversación. Las condiciones se comprueban de nuestro lado, en el momento de la llamada, después de que la IA haya decidido llamar a la Action pero antes de enviar ninguna petición, de modo que no se pueden sortear desde el chat.

Esta es la herramienta adecuada para Actions privilegiadas o irreversibles (banear a un miembro, emitir un reembolso, eliminar un registro). Una línea en tu prompt que diga “solo los administradores pueden hacer esto” es una instrucción útil, pero no es una barrera de seguridad: un usuario decidido puede discutir con el modelo o intentar una inyección de prompt. Una condición de ejecución es determinista y vive fuera del prompt, así que se mantiene independientemente de lo que diga la conversación.

• La condición de ejecución es la barrera. Se evalúa del lado del servidor y no forma parte del prompt que lee el modelo. Esto es lo que realmente impide que la Action se ejecute.
• La regla del prompt es la experiencia de usuario. Mantén también una línea en tu prompt, para que la IA rechace con educación y explique por qué en lugar de quedarse en silencio.

Añade condiciones en la sección Run only when del editor de la Action. Haz clic en Add condition, elige una clave de metadatos (por ejemplo telegram_sender_is_admin) y elige cómo compararla:

Condición	Pasa cuando el valor del metadato…
is true	es truthy
is false	es falsy
exists	está presente en la conversación
does not exist	está ausente
equals	coincide con un valor que especifiques
does not equal	difiere de un valor que especifiques

La Action se ejecuta solo cuando todas las condiciones se cumplen. Una condición sobre una clave que no está establecida en la conversación no pasa.

Cuando una condición falla, no se envía ninguna petición y la IA le dice al usuario que no puede hacer eso. Abajo, la misma petición de baneo se bloquea para un no-administrador y se permite para un administrador, sin cambiar nada salvo quién lo pide:

Precaución

Aplica condiciones solo sobre metadatos que Quickchat establece (como un flag telegram_sender_is_admin verificado por el canal), no sobre valores que el visitante pueda influir. Consulta Metadatos de conversación para saber de dónde viene cada clave.

Response filter

Por defecto, la IA ve la respuesta completa de la API. Añade expresiones JSONPath en la sección Response filter para limitar la IA a partes específicas de ella.

Dos motivos habituales para filtrar:

• Ocultar campos sensibles. Mantén los correos de los clientes, los datos de pago o los ids internos fuera del contexto del modelo cuando el endpoint devuelve más de lo que la IA necesita.
• Reducir el prompt. Las APIs muy verbosas pueden devolver payloads grandes; filtrar a los pocos campos que importan mantiene la respuesta pequeña y la IA enfocada.

Añade una o más expresiones JSONPath y la IA recibirá solo las partes que coincidan. Por ejemplo, $.data.items[*].name conserva solo los nombres de los elementos de una respuesta más grande.

Consejo

Usa el panel Test Response para ver exactamente qué recibirá la IA tras el filtrado antes de confiar en él. Consulta Probar tu Action.

Precaución

Un JSONPath que no coincide con nada deja a la IA con una respuesta vacía. Empieza sin filtro, confirma que la llamada funciona y luego ajústalo.

Buenas prácticas

• Sé explícito: cuándo usar y cómo completar parámetros.
• Alcance mínimo: solo cabeceras y tokens necesarios.
• Prueba antes del despliegue: revisa códigos y payloads.

Tutoriales

• Buscar tickets de Jira en una conversación de IA
• Enviar una notificación de Slack con una Acción de IA