Skip to main content

Inicio

Punto de entrada de cualquier flow. Define el saludo y el modo de saludo:
  • agent speaks first: el saludo se dice en cuanto se conecta la llamada (lo habitual en entrantes).
  • user speaks first: el asistente espera a que hable quien llama (lo habitual en salientes: la persona que contesta dice “¿Hola?” primero).

Agente

Un agente conversacional con su propio nombre, sus instrucciones y una voz alternativa opcional. La conversación se queda con este agente hasta que hace un handoff por uno de sus bordes de salida.
  • Cada borde de salida se convierte en una herramienta de handoff; la etiqueta del borde es la descripción que usa el LLM para decidir. Consulta por qué importan las etiquetas de bordes y agentes.
  • Si dejas las instrucciones vacías, se usa el prompt del sistema del asistente (Prompt avanzado) como base: el texto del nodo se añade, no lo sustituye.
  • La voz alternativa permite que cada agente hable con una voz distinta.

Condición

Un punto de decisión forzada. Escribes una descripción de qué se está decidiendo; el LLM tiene que elegir exactamente un borde de salida según las etiquetas de los bordes. Úsala cuando el enrutamiento tenga que resolverse ahora, y no cuando al agente le parezca buen momento para hacer un handoff.

Herramienta

Llama a un endpoint HTTP en mitad de la conversación y devuelve el resultado al LLM.
Para webhooks de ejecución larga (escrituras en el CRM, comprobaciones de disponibilidad), activa async y añade dos o tres frases de relleno. Quien llama mantiene una conversación fluida mientras la solicitud se completa en segundo plano.

Transferencia (ciega)

Transfiere la llamada de inmediato a un número de teléfono o URI SIP (SIP REFER), opcionalmente después de un breve aviso. El asistente sale de la llamada; no hay ningún briefing para quien la recibe.

Transferencia cálida

El traspaso premium: a quien llama se le pone música de espera, el asistente marca al destino (un empleado), lo pone al día con un resumen generado por IA de la conversación hasta ese momento, y solo entonces conecta a ambas partes. El empleado puede aceptar o rechazar la llamada; si hay buzón de voz en el destino, se detecta. Los resultados de la transferencia cálida (started / completed / failed) quedan registrados como eventos de llamada.

Recopilar

Captura de datos estructurados con validación, repetición de preguntas y confirmación integradas: mucho más fiable que confiar en que el LLM transcriba bien una dirección de correo.
  • Tipos: name, email, phone, address, date of birth, dtmf (dígitos por teclado), credit_card (tarjeta de pago).
  • Variable (obligatorio): el resultado se guarda con este nombre y se incluye en el webhook call.completed.
  • Prompt: instrucciones extra opcionales, además del diálogo integrado.
  • Intentos máximos (3 por defecto): tras el fallo final, el flow sigue por el borde etiquetado failed, si existe.
  • Dígitos DTMF: para el tipo dtmf, cuántos dígitos hay que recoger.
  • Tarjeta de pago (credit_card): requiere la herramienta integrada Recopilar tarjeta de pago asignada al asistente (sujeta al plan), con una cuenta de Stripe conectada y seleccionada. Durante la llamada, el agente recoge los datos de la tarjeta de forma segura; la plataforma crea un método de pago de Stripe en esa cuenta. Solo se guardan card_last4 / card_brand / stripe_payment_method_id, nunca el PAN ni el CVV. Conecta Stripe primero en Herramientas → App Store. Usa después el ID del método de pago para cobrar a través de Stripe.

DTMF

Le pide a quien llama que introduzca una cantidad fija de dígitos en el teclado del teléfono (30 s de tiempo de espera). Usa collect con el tipo dtmf cuando quieras validación y reintentos; usa este nodo más simple para menús rápidos de opciones.

Fin

Termina la llamada, diciendo antes una despedida si quieres. Da siempre a tus flows un final explícito: genera estados de llamada limpios y evita que la conversación siga a la deriva una vez terminado su trabajo.

Herramienta en línea vs. herramienta asignada

Los nodos Herramienta, Transferencia, Transferencia cálida, DTMF y Recopilar (tipo dtmf) tienen todos un interruptor de Origen de la herramienta en la parte superior de su panel de configuración:
  • En línea (por defecto): configuras los campos del nodo directamente, tal como se describe arriba. Es el comportamiento original; nada cambia para los flows ya existentes.
  • Herramienta asignada: en vez de los campos en línea, el nodo reutiliza una herramienta reutilizable ya asignada a este asistente (creada en la página de Herramientas y asignada en Configuración → Herramientas). Los campos en línea se mantienen, pero se ignoran mientras este modo está activo.
El selector está filtrado por tipo, así que solo puedes elegir una herramienta que coincida con el nodo:
El origen Herramienta asignada solo aparece en nodos Recopilar de tipo dtmf; los demás tipos de recopilación (name, email, phone, address, date of birth) no tienen un equivalente integrado y se quedan solo en línea. Si cambias un nodo Recopilar para que deje de ser dtmf, se borra automáticamente cualquier herramienta asignada.
Si más adelante una herramienta asignada se desasigna, se elimina, se desactiva o tiene el subtipo equivocado, el nodo recurre a su configuración en línea en el momento de la llamada (y registra un evento de llamada flow_tool_ref_unresolved); una llamada nunca falla por culpa de una referencia de herramienta que falta.
Usa Herramienta asignada cuando el mismo número de transferencia, mensaje de teclado o endpoint de API se repite en muchos flows o asistentes: lo editas una vez en la página de Herramientas y se actualiza en todos los nodos que lo referencian. Usa En línea para un comportamiento puntual, específico de un flow.