# Ejecutar un workflow

} from '../../../../components/docs';

Un workflow es un grafo: un **trigger**, luego nodos. Construirlo bajo **Work Flows** no es suficiente. Un trigger de teléfono no hace nada hasta que el workflow esté **activado** para ese agent bajo **Skills - Tools & Workflows**. Un lienzo no guardado no se ejecuta.

El catálogo de nodos (API, email, SMS, HubSpot, ramas) está en [Workflow Nodes](https://docs.voicelogica.ai/es/workflow-nodes/). Esta sección trata *cuándo* comienza el grafo.

## Por qué importa la configuración

Tres cosas deben ser verdaderas o el grafo es decoración:

1. Un **trigger** está en el lienzo.
2. Hizo clic en **Save & go live** (o guardó una versión).
3. Para un trigger de teléfono - el interruptor del workflow está **activado** para *este* agent bajo **Business Workflows**.

**Run test** en el constructor prueba el grafo. No prueba que una persona que llama en vivo lo alcanzará.

## Abrir Work Flows

Barra lateral - **Work Flows**. Línea de página: *Automatizaciones que conectan sistemas, obtienen datos en vivo, envían mensajes y ejecutan lógica - activadas por llamadas, horarios o eventos.*

Estado vacío: **Build your first workflow**. Botón: **+ Workflow**.

  <ShotPlaceholder
    src="/assets/workflows/list.png"
    name="wf-list"
    alt="Estado vacío de Work Flows Build your first workflow"
    capture="Barra lateral Work Flows."
  />

**+ Workflow** abre **Create new workflow** (*Nómbrelo ahora - configure capacidades en el constructor.*). Nota beta: limitado a **5 workflows durante la beta**. Ingrese **Workflow name**, luego **+ Create workflow** (o Cancel).

  <ShotPlaceholder
    src="/assets/workflows/create-workflow.png"
    name="wf-create"
    alt="Diálogo Create new workflow con límite beta"
    capture="Create new workflow."
  />

También puede **+ Add workflow** desde **Skills - Tools & Workflows** del agent - eso crea *y* lo lista bajo **Business Workflows**.

## Qué trigger elegir

En el constructor, **+ Add Trigger** abre **Phone Triggers** (y más a medida que se desplaza):

- **Saber quién llama antes de que hable la IA** — turn on **Call Start Trigger** (needs Iniciar el workflow cuando se recibe una llamada. [On Call Start](../on-call-start/).)
- **Actuar solo después de que alguien realmente conteste** — turn on **When Call Connects** (needs Iniciar cuando una llamada se conecta. [When Call Connects](../when-call-connects/).)
- **La persona que llama pidió algo que debe buscar en vivo** — turn on **During Call Trigger** (needs El modelo decide cuándo. Agrega latencia. [During Call](../during-call/).)
- **Dijeron una frase (emergencia, cancelar)** — turn on **Keyword Detected** (needs Iniciar cuando la persona que llama dice palabras específicas. [Keyword Detected](../keyword-detected/).)
- **Escribieron dígitos (# / tiempo de espera)** — turn on **On Key Pressed** (needs Iniciar cuando la persona que llama presiona una tecla. Necesita configuración de teclado en el agent. [On Key Pressed](../keyword-pressed/).)
- **Después de colgar: CRM, email, webhook** — turn on **Call Ends Trigger** (needs Iniciar cuando termina una llamada. [On Call End](../on-call-end/).)
- **Nadie contestó** — turn on **Missed Call Trigger** (needs Iniciar cuando se pierde una llamada. [Missed Call](../missed-call/).)
- **Mi sistema inicia el grafo** — turn on **On API Call** (needs [On API Call](../on-api-call/). No necesita adjuntar un agent.)

  <ShotPlaceholder
    src="/assets/workflows/add-trigger.png"
    name="wf-triggers"
    alt="Catálogo Add a Trigger Phone Triggers"
    capture="Workflow Add Trigger."
  />

- **Call Start** — antes de contestar
- **When Call Connects** — después de contestar
- **During Call** — el modelo lo invoca
- **Call Ends** — después de colgar
- **Keyword Detected** — frase hablada
- **On Key Pressed** — DTMF
- **Missed Call** — entrante sin contestar
- **On API Call** — POST run-workflow

Los triggers de evento de HubSpot creado / propiedad-cambiada, WooCommerce y similares aparecen en el mismo catálogo cuando esas [integraciones](https://docs.voicelogica.ai/es/integrations/) están conectadas.

**AI Response to Caller** solo existe bajo un trigger de audio en vivo (Start, Connect, During, Keyword, Key Pressed) - no End o Missed. **Transfer Call** solo bajo Start, Connect o During.

## Primera configuración - un Call Start, adjuntar, probarlo

1. **Barra lateral - Work Flows - + Workflow**

   Nómbrelo según el trabajo (por ejemplo Caller lookup). **+ Create workflow**.

2. **+ Add Trigger - Call Start Trigger**

   Phone Triggers. Déjelo vacío - este trigger no tiene campos requeridos.

3. **Save & go live** (arriba a la derecha)

   Use **Save as version** cuando desee un punto de control nombrado. Ejecute una prueba del constructor si está disponible - dry-run evita que Email / SMS se envíen.

4. **My Agents - este agent - Skills - Tools & Workflows**

   Bajo **Business Workflows** (`N/M active`), active la fila **on**. O use **+ Add workflow** si lo creó desde aquí.

     <ShotPlaceholder
       src="/assets/workflows/index-attach.png"
       name="index-attach"
       alt="Business Workflows con interruptor de workflow apagado"
       capture="Agent Tools and Workflows Business Workflows."
     />

5. **Una llamada entrante real** (o **Try this agent**)

   Abra **Calls**. Si nada se ejecutó, el interruptor está apagado, probó un agent diferente o nunca guardó.

Los workspaces están en un límite beta de workflows (**Limited to 5 workflows during beta**). Si **Create workflow** está bloqueado, elimine un grafo no utilizado o espere a que se levante el límite.

## Solución de problemas

**El workflow nunca se ejecuta en una llamada en vivo**

1. **Save & go live** en el constructor.
2. El workflow está **activado** para *este* agent (**Business Workflows**).
3. El trigger coincide con el evento (Start vs End vs During).
4. Llamó al agent que tiene el interruptor, no a un segundo.

**La prueba del constructor funciona, las personas que llaman no**

Las pruebas del constructor omiten la adjunción del agent. Active el interruptor, luego realice una llamada real.

## Próximos pasos

[On Call Start](../on-call-start/) - primer grafo útil (búsqueda antes de contestar).  
[During Call](../during-call/) - solo cuando la solicitud no se conoce de antemano.  
[Workflow Nodes](https://docs.voicelogica.ai/es/workflow-nodes/) - API, email, SMS, ramas.  
[Tools & Workflows](https://docs.voicelogica.ai/es/agent-configuration/built-in-tools/) - adjuntar + herramientas integradas.