> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diga.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipos de Nodos

> Guía completa de los seis tipos de nodos disponibles en caminos conversacionales y cuándo usar cada uno

## Introducción

Los nodos son los bloques fundamentales de un camino conversacional. Cada tipo de nodo tiene un propósito específico y capacidades únicas. Elegir el tipo correcto de nodo para cada paso de tu flujo es clave para crear agentes efectivos.

<CardGroup cols={2}>
  <Card title="Nodo de Inicio" icon="play" color="#767DA3">
    Comienza la conversación
  </Card>

  <Card title="Nodo de Conversación" icon="message-square">
    Genera diálogo con el usuario
  </Card>

  <Card title="Nodo de Herramienta" icon="wrench" color="#A3A9C2">
    Ejecuta llamadas API
  </Card>

  <Card title="Nodo de Flujo" icon="git-branch" color="#343E96">
    Ejecuta un flujo de trabajo
  </Card>

  <Card title="Nodo de Transferencia" icon="arrow-right-left" color="#f59e0b">
    Transfiere a otro número
  </Card>

  <Card title="Nodo de Terminar" icon="phone-off" color="#ef4444">
    Finaliza la llamada
  </Card>
</CardGroup>

## Nodo de Inicio

### Descripción

El nodo de comienzo es el punto de entrada de todo camino conversacional. Es el primer nodo que se ejecuta cuando comienza la llamada.

<Note>
  **Único y obligatorio**

  Cada camino conversacional debe tener exactamente un nodo de comienzo. No puedes tener varios nodos de inicio ni eliminar el nodo de comienzo.
</Note>

<Frame>
  <img src="https://mintcdn.com/diga/5WJ7DCPPeyMq2XKq/images/nodo-inicio.png?fit=max&auto=format&n=5WJ7DCPPeyMq2XKq&q=85&s=07c961fd3a275d41013ae0849d8e7580" alt="Ejemplo de flujo conversacional con nodo de inicio" width="521" height="286" data-path="images/nodo-inicio.png" />
</Frame>

### Características

* Indica el comportamiento inicial, saludar primero o esperar a que el usuario hable
* Solo puede estar conectado a un único nodo de conversacion
* No genera diálogo por sí mismo, esto lo realiza el nodo siguiente

### Configuración

* **Esperar al usuario**: Si es afirmativo, espera a que el usuario hable primero
* **Tiempo de espera**: Tiempo en milisegundos hasta que el agente hable

## Flujos Pre-llamada

### Descripción

El nodo de **Flujos pre-llamada** se sitúa justo encima del [nodo de inicio](#nodo-de-inicio). No es uno de los bloques que colocas dentro de la conversación — en su lugar, contiene los [flujos pre-llamada](/es/build/flujos/flujos-pre-llamada) que se ejecutan **antes de que empiece el camino**, en el momento en que comienza la llamada. Es el equivalente, para agentes con camino, a asignar flujos pre-llamada en la sección Flujos de un agente de prompt único.

<Frame>
  <img src="https://mintcdn.com/diga/sflY49XvK39cKdZ8/images/nodo-pre-llamada-placeholder.png?fit=max&auto=format&n=sflY49XvK39cKdZ8&q=85&s=45134dcc37335f0275903611d707f11e" alt="Nodo de flujos pre-llamada encima del nodo de inicio" width="782" height="698" data-path="images/nodo-pre-llamada-placeholder.png" />
</Frame>

### Características

* **Siempre presente**: se muestra en todos los caminos y no se puede eliminar (incluso sin flujos añadidos)
* **Se ejecuta antes del camino**: sus flujos se ejecutan antes del nodo de inicio, mientras la llamada se está conectando
* **Múltiples flujos**: puedes añadir más de un flujo pre-llamada
* **Personaliza la llamada**: los flujos pre-llamada pueden añadir texto al prompt del agente y definir variables dinámicas que se usan durante todo el camino

### Configuración

* Haz clic en el nodo (o en su botón **Añadir**) para abrir el selector, que solo lista flujos pre-llamada — flujos que usan el trigger **Pre-llamada**.
* Añade los flujos que quieras ejecutar. Cada uno debe estar **publicado** y **habilitado**.

<Note>
  Los flujos pre-llamada pueden devolver variables dinámicas que luego usas en los prompts de los nodos y en las condiciones de las ramas con la sintaxis `{{variable}}`. Consulta [Flujos Pre-llamada](/es/build/flujos/flujos-pre-llamada) y [Variables Dinámicas](/es/build/agentes/variables-dinamicas).
</Note>

## Nodo de Conversación

### Descripción

Los nodos de conversación son el corazón de la interacción. Generan diálogo, hacen preguntas, y responden a las necesidades del usuario. La mayoría de nodos de un camino conversacional serán de este tipo.

Ten en cuenta que el agente puede mantener una conversación de varios turnos dentro de un solo nodo, por lo que no es necesario crear un nuevo nodo de conversación para cada frase que el agente tenga que decir. Se recomienda dividir el nodo cuando haya una división lógica o la instrucción sea demasiado larga.

<Frame>
  <img src="https://mintcdn.com/diga/5WJ7DCPPeyMq2XKq/images/nodo-conversacion.png?fit=max&auto=format&n=5WJ7DCPPeyMq2XKq&q=85&s=88fdcdcf90ebe7c7008f9c76890316f8" alt="Ejemplo de flujo conversacional con varios nodos de conversación" width="1081" height="1174" data-path="images/nodo-conversacion.png" />
</Frame>

### Instrucciones

Hay dos formas principales de definir el comportamiento de un nodo de conversación:

1. **Prompt**: el campo de texto sirve para dar instrucciones sobre lo que debe hacer el agente en este punto de la conversación. Esta es la forma recomendada de generar respuestas, ya que hace que la conversación sea más humana y natural.
2. **Texto fijo**: en lugar de usar un prompt, puedes definir un texto fijo que el agente dirá exactamente como está escrito. Esto es útil para mensajes estándar o información que no debe cambiar.

### Conocimiento contextual

Permite al agente acceder a información específica en este nodo, mejorando la relevancia de sus respuestas.

### Variables en Prompts

Puedes usar variables dinámicas en tus prompts para personalizar la conversación:

```markdown theme={null}
Prompt:
Hola {{nombre_cliente}}, veo que tu último pedido {{numero_orden}}
fue enviado el {{fecha_envio}} y debería llegar el {{fecha_estimada}}.
¿Hay algo específico sobre este pedido que quieras consultar?
```

## Nodo de Herramienta

### Descripción

Los nodos de herramienta ejecutan llamadas a APIs externas, webhooks, o cualquier integración de sistema externo. Son fundamentales para conectar tu agente con tus servicios.

En este nodo debes elegir la herramienta a usar. La herramienta se elige a partir de las integraciones creadas, pudiendo haber solo una herramienta por nodo.

<Frame>
  <img src="https://mintcdn.com/diga/5WJ7DCPPeyMq2XKq/images/nodo-herramienta.png?fit=max&auto=format&n=5WJ7DCPPeyMq2XKq&q=85&s=0ac2223fce3f5f027009a3e7bf351612" alt="Ejemplo de flujo conversacional con nodo de herramienta para llamar a una API externa" width="1099" height="459" data-path="images/nodo-herramienta.png" />
</Frame>

### Características

* **Ejecución de API**: Llama a endpoints HTTP
* **Sin diálogo directo**: No genera conversación
* **Procesamiento de datos**: Recibe y procesa respuestas de servicios externos
* **Transiciones basadas en resultado**: Las siguientes acciones dependen del resultado de la llamada

## Nodo de Flujo

### Descripción

Los nodos de flujo ejecutan [flujos de trabajo](/es/build/flujos/introduccion) dentro del camino conversacional. A diferencia de los nodos de herramienta, que llaman a un solo endpoint de API, los nodos de flujo ejecutan automatizaciones multi-paso que pueden encadenar múltiples servicios con lógica y condiciones.

<Frame>
  <img src="https://mintcdn.com/diga/af2J6aSSE2_8MdzI/images/nodo-flujo-placeholder.png?fit=max&auto=format&n=af2J6aSSE2_8MdzI&q=85&s=edbeafb94552ecbdc13f2f19196f4f89" alt="Ejemplo de flujo conversacional con nodo de flujo ejecutando un workflow" width="742" height="462" data-path="images/nodo-flujo-placeholder.png" />
</Frame>

Los nodos de flujo se pueden usar de dos formas según su posición en el camino:

* **[Durante la llamada](/es/build/flujos/flujos-durante-llamada)**: cuando se colocan en el flujo regular de la conversación, actúan como nodos de herramienta pero ejecutan un flujo completo en lugar de una sola llamada a la API. El flujo asignado debe usar el trigger **Llamada a función**.
* **[Post-llamada](/es/build/flujos/flujos-post-llamada)**: cuando se conectan después de un nodo de Terminar, se ejecutan automáticamente una vez que la llamada finaliza. El flujo asignado debe usar el trigger **Llamada finalizada**.

### Características

* **Ejecución multi-paso**: ejecuta un flujo completo, no solo una llamada a la API
* **Sin diálogo directo**: no genera conversación (igual que los nodos de herramienta)
* **Durante llamada o post-llamada**: el comportamiento depende de su posición en el camino
* **Un flujo por nodo**: cada nodo de flujo referencia un único flujo de trabajo

### Configuración

* **Flujo de trabajo**: selecciona el flujo a ejecutar de la lista de flujos disponibles en tu proyecto

<Note>
  Los nodos de flujo post-llamada son terminales y no pueden tener ramas de salida. Los nodos de flujo durante llamada admiten transiciones basadas en resultado, igual que los nodos de herramienta.
</Note>

## Nodo de Transferencia

### Descripción

Los nodos de transferencia redirigen la llamada a otro número telefónico o extensión telefónica. Útil para escalar a agentes humanos o departamentos especializados.

<Frame>
  <img src="https://mintcdn.com/diga/5WJ7DCPPeyMq2XKq/images/nodo-transferencia.png?fit=max&auto=format&n=5WJ7DCPPeyMq2XKq&q=85&s=dfae938f0da97f7675943edcf85b333d" alt="Ejemplo de flujo conversacional con nodo de transferencia a agente humano" width="1354" height="1230" data-path="images/nodo-transferencia.png" />
</Frame>

### Características

* **Transferencia en vivo**: Pasa la llamada a otro número
* **Finaliza el flujo**: Una vez transferido, el agente IA ya no participa
* **Manejo en caso de fallo**: Si la transferencia falla, puede haber una transición alternativa a otro nodo

### Configuración

* **Número de destino**: El número al que se transferirá la llamada.
* **Extensión**: Si usas un sistema PBX, puedes definir una extensión interna. En el caso de que no indiques número de destino, la extensión se realizará con ese mismo número.

## Nodo de Terminar

Los nodos de terminar finalizan la llamada de manera controlada. Son los puntos de salida del flujo conversacional. Para que el agente indique un mensaje antes de colgar, se debe añadir un nodo de conversación antes del nodo de terminar.

<Frame>
  <img src="https://mintcdn.com/diga/5WJ7DCPPeyMq2XKq/images/nodo-terminar.png?fit=max&auto=format&n=5WJ7DCPPeyMq2XKq&q=85&s=37bc68405e8645e3b8b9cd98549e41b4" alt="Ejemplo de flujo conversacional con nodo de terminación después de un nodo de conversación" width="843" height="925" data-path="images/nodo-terminar.png" />
</Frame>
