Skip to main content

¿Qué es la Pieza de Diga?

La pieza de Diga es el componente que conecta tus flujos con las llamadas de tus agentes. Proporciona triggers para reaccionar a eventos de llamadas y acciones para interactuar con el sistema de telefonía de Diga.

Triggers

Inician un flujo cuando ocurre un evento en una llamada

Acciones

Ejecutan operaciones dentro de un flujo en ejecución

Triggers

Pre-llamada

Se activa cuando una llamada empieza, antes de que el agente salude. Es el trigger para los flujos pre-llamada. El agente espera la salida del flujo y la usa para personalizar la conversación antes de decir su primera palabra.
Un flujo pre-llamada debe terminar con la acción Devolver datos de llamada para que el agente reciba el texto adicional del prompt y las variables dinámicas. La pieza genérica Respond no funcionará — su respuesta nunca llega al agente.

Configuración

Datos que recibe

Cuando se dispara este trigger, el flujo recibe los datos de la llamada que está empezando, que puedes usar para buscar el registro correcto:
Consulta Flujos Pre-llamada para la guía completa, incluido cómo crear, asignar y controlar llamadas con estos flujos.

Llamada Finalizada

Se activa automáticamente cuando una llamada termina. Es el trigger principal para flujos post-llamada.

Datos que recibe

Cuando se dispara este trigger, el flujo recibe toda la información de la llamada: Cada mensaje en el array messages incluye:
  • role — Quién habló (user o assistant)
  • content — El texto del mensaje
  • created_date — Cuándo se envió
Puedes usar cualquiera de estos campos en las acciones de tu flujo. Por ejemplo, insertar la transcripción completa en un email o enviar la duración a una hoja de cálculo.

Configuración

Este trigger no requiere configuración adicional. Solo necesitas asignar el flujo al agente para que se active.
Consulta Flujos Post-llamada para la guía completa sobre cómo crear y asignar estos flujos.

Llamada a Función

Se activa durante una llamada cuando el agente decide ejecutar una función. Es el trigger para flujos durante llamada. El agente lo usa como una herramienta más, de forma similar a las integraciones.
Consulta Flujos Durante Llamada para la guía completa sobre cómo crear y asignar estos flujos.

Configuración

Parámetros

Los parámetros definen qué información extrae el agente de la conversación para enviarla al flujo. Por ejemplo, para un flujo de “Consultar disponibilidad”: El agente extrae estos valores automáticamente del contexto de la conversación y los envía al flujo. Los tipos de dato de los parámetros incluyen Texto, Número, Booleano y Array.
Origen del valor
Cada parámetro tiene un Origen del valor que decide de dónde sale su valor:
  • Extraído por la IA (por defecto): el agente extrae el valor de la conversación, usando la descripción del parámetro para saber qué buscar.
  • Variable dinámica: el valor se toma directamente de una variable dinámica en lugar de extraerse. Al elegir esta opción, indica el Nombre de la variable dinámica (sin llaves, p. ej. id_cliente). No se le pide este parámetro al agente — Diga lo rellena automáticamente con las variables de la llamada.
Usa Variable dinámica para datos que ya tienes (definidos por la API o por un flujo pre-llamada), para que el agente no tenga que volver a pedirlos durante la conversación. Para un paso a paso y un ejemplo, consulta Rellenar parámetros desde variables dinámicas.

Datos que recibe

Cómo espera el agente

El agente espera a que el flujo termine y recibe la respuesta, y la usa para continuar la conversación. Ejemplo: Consultar disponibilidad de citas. El agente pregunta la fecha, ejecuta el flujo, espera la respuesta y le dice al usuario los horarios disponibles. Importante: El flujo debe incluir la acción Devolver respuesta como último paso para enviar datos de vuelta al agente. El tiempo máximo de espera es de 60 segundos.
Si el flujo tarda más de 60 segundos o no incluye la acción Devolver respuesta, el agente recibirá un error y continuará la conversación sin los datos.

Confirmación de usuario

Cuando activas la confirmación de usuario, el agente le explica al usuario qué acción va a realizar y le pide confirmación antes de ejecutar el flujo. Esto es útil para acciones sensibles como procesar pagos o hacer reservas. Ejemplo de conversación:

Acciones

Hacer Llamada

Inicia una llamada saliente desde un flujo. Esta acción convierte cualquier flujo en un disparador de llamadas, permitiéndote crear campañas automatizadas o llamadas reactivas a eventos externos. Los flujos construidos en torno a esta acción se conocen como flujos lanzadores de llamadas.

Configuración

Casos de uso

Conecta un trigger de tu CRM (nuevo lead creado) con la acción de hacer llamada para contactar automáticamente a nuevos leads.
Usa un trigger de programación para llamar a clientes y recordarles sus citas.
Conecta un webhook con la acción de hacer llamada para contactar a usuarios que completan un formulario web.

Devolver Respuesta

Devuelve datos al agente durante una llamada. Esta acción es obligatoria en flujos durante llamada. Es el último paso del flujo y contiene la información que el agente necesita para continuar la conversación.

Configuración

Ejemplo

Un flujo que consulta disponibilidad de citas:
El agente recibe estos datos y le dice al usuario: “Tengo disponibilidad a las 10:00, 11:30 y 15:00 para una consulta general. ¿Cuál prefieres?”

Devolver Datos de Llamada

Devuelve datos al agente antes de que empiece la llamada. Esta acción es obligatoria como último paso de un flujo pre-llamada — es lo que envía el prompt y las variables de vuelta al agente para que pueda comenzar la conversación.
No la confundas con Devolver respuesta. Devolver datos de llamada se ejecuta al inicio de una llamada (flujos pre-llamada); Devolver respuesta se ejecuta durante una llamada (flujos durante llamada).

Configuración

Ejemplo

Un flujo pre-llamada que personaliza al agente a partir de una búsqueda en el CRM:
El agente empieza la llamada conociendo ya el nombre y el plan del contacto, y puede usar {{nombre_cliente}} y {{plan}} en cualquier parte de su prompt, saludo o camino.

Referenciar Datos entre Pasos

En cualquier acción, puedes usar datos de pasos anteriores. Haz clic en un campo de entrada para ver los datos disponibles de todos los pasos previos. Ejemplos de referencia:
  • Datos del trigger: transcripción, duración, parámetros de la función
  • Datos de acciones anteriores: respuesta de una API, resultado de una consulta
Esto te permite construir flujos donde la información fluye naturalmente de un paso al siguiente.

Siguientes Pasos

Crear flujos

Pon en práctica estos triggers y acciones creando tu primer flujo.

Asignar a agentes

Conecta tus flujos con agentes para activarlos.

Plantillas

Usa plantillas que ya incluyen la pieza de Diga configurada.

Integraciones

Compara flujos con integraciones directas en el agente.