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, header, path) y description guiando a la IA sobre cómo componer el valor.
6. Test request, verifica y Done.

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