---
title: "Iniciar una Automation desde una secuencia de voz"
description: "Envía un evento de aplicación desde una llamada para iniciar una Automation sin esperar a que termine, y asigna al evento los datos de la persona que llama, de la llamada y del teclado."
canonical: "https://bird.com/es-es/documentacion/guides/voice/sequences/automations"
---

# Iniciar una Automation desde una secuencia de voz

> **Advertencia:** Las secuencias de voz están en versión preliminar. Los pasos, los datos de entrada y el formato de definición de secuencias pueden cambiar de formas que rompan las secuencias existentes y las solicitudes de API.

Usa **Send Automation Event** para iniciar una Automation mientras la llamada continúa. Por ejemplo, cuando la persona que llama pulsa 1 para pedir que la llamen, envía su número a una Automation que programe la devolución de la llamada. La llamada no espera a que se ejecute la Automation.

El paso está en versión preliminar. [Automations](/docs/guides/automations) está en acceso anticipado, y los permisos de tu espacio de trabajo determinan lo que puedes configurar.

## Preparar la automatización

1. Crea una automatización con **Event from your application** como desencadenante.
2. Define **Event name**, por ejemplo `callback_requested`.
3. Define **Event fields** para los valores que enviará la llamada, como campos de texto llamados `caller` y `digits`.
4. Publica la automatización.

En la automatización, `trigger.data` es el sobre del evento y `trigger.data.data` son los datos que asignaste, así que el número de la persona que llama está en `trigger.data.data.caller`. [Conectar tu aplicación a una automatización](/docs/guides/automations/application-events) explica el sobre, los nombres de evento, los campos de evento y las ejecuciones.

## Añadir el paso

1. Añade **Send Automation Event** en la ruta que debe iniciar la automatización, como la opción del teclado para solicitar una devolución de llamada.
2. En **Automation event**, elige la automatización y después su evento. La lista muestra los eventos que puede iniciar la versión publicada de la automatización.
3. En **Data**, rellena los campos del evento. Cada campo puede ser un valor fijo, un valor de datos anteriores de la llamada o, en los campos de texto, un texto que combine ambos. Si el evento no tiene campos de evento, añade tus propios nombres y valores.
4. Conecta los resultados **Success** y **Failure**.

Los datos que asignas son todos los datos del evento. Bird no añade ningún campo, así que asigna todos los valores que lee la automatización. El número de quien llama está en `execution.call.orig.address` y puede faltar, así que [protégelo](/docs/guides/voice/sequences/data). El ID de la llamada está en `execution.call.id` y los dígitos del teclado están en `steps.<gather step>.output.digits`. El ID de la secuencia no está disponible como dato de la llamada; introdúcelo como valor fijo cuando la automatización lo necesite.

Para elegir una automatización necesitas permiso para leer Automations. Sin ese permiso, introduce tú mismo el ID de la automatización, el nombre del evento y los datos.

## Gestiona los resultados

| Resultado | Significado y siguiente acción                                                                                                      |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Success   | El evento se puso en cola para la automatización. Continúa la llamada.                                                              |
| Failure   | No se pudo poner el evento en cola en unos pocos segundos. Continúa la llamada o indica a quien llama que lo intente de otra forma. |

Un resultado de fallo sin conectar termina la ejecución como fallida. Conéctalo, aunque sea al mismo paso que el de éxito, cuando la llamada deba continuar en cualquier caso.

Ningún resultado indica lo que hizo la automatización. Una automatización en pausa, sin publicar o eliminada, un nombre de evento que no usa o unos datos que no coinciden con sus campos de evento siguen dando éxito. Consulta la pestaña **Runs** de la automatización para ver si se inició una ejecución.

## Comprueba antes de publicar

Al publicar la secuencia aparece una advertencia, sin bloquear la publicación, cuando la automatización elegida no existe, está en pausa o no está publicada, o cuando su versión publicada no puede iniciar una ejecución a partir del evento elegido. Una automatización en pausa o un evento que solo usa una regla de espera o de cancelación también recibe la advertencia, aunque el evento pueda continuar o cancelar ejecuciones existentes. Si no puedes leer Automations, la advertencia indica que el paso no se comprobó.

## Entrega

- El paso solo se ejecuta después de que se responda la llamada. Una llamada sin responder o abandonada no envía nada.
- El evento suele llegar a la automatización aproximadamente un segundo después del paso.
- Cada paso de la llamada por este paso envía un evento, y las entregas repetidas de ese evento se descartan. La protección contra duplicados es limitada, así que diseña la automatización para que tolere alguna repetición ocasional.
- Una [Transfer](/docs/guides/voice/sequences/dial-and-transfer) que vuelve al paso envía un evento nuevo.
- Todos los eventos van a la versión publicada de la automatización, también los de las llamadas de prueba. Una llamada de prueba es una llamada real, y la automatización puede realizar acciones reales.
- [Preview](/docs/guides/voice/sequences/preview) no envía ningún evento. Elige una muestra de éxito o de fallo para el paso.

## Usar la definición

En una definición de secuencia, el paso es un nodo `automation.send_event`:

```json
{
  "id": "notify",
  "type": "automation.send_event",
  "type_version": 1,
  "config": {},
  "input": {
    "automation_id": "atm_01jz8x3v4w5y6z7a8b9c0d1e2f",
    "event": "callback_requested",
    "data": {
      "caller": {
        "$expr": "execution.call.orig != null && has(execution.call.orig.address) ? execution.call.orig.address : ''"
      },
      "digits": { "$expr": "steps.menu.output.digits" }
    }
  },
  "connections": {
    "success": { "node_id": "confirm", "port": "input" },
    "failure": { "node_id": "confirm", "port": "input" }
  }
}
```

| Campo                 | Valor                                                                                                                                                                                                                                                                                                |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `config`              | `{}`.                                                                                                                                                                                                                                                                                                |
| `input.automation_id` | Obligatorio. ID de una automatización de este espacio de trabajo.                                                                                                                                                                                                                                    |
| `input.event`         | Obligatorio. El nombre del evento de la automatización: de 1 a 128 letras, dígitos, puntos, guiones bajos o guiones.                                                                                                                                                                                 |
| `input.data`          | Opcional, valor predeterminado `{}`. Un objeto cuyos valores de nivel superior se vinculan cada uno con `$expr` o `$template`, o un único `$expr` para el objeto completo. Los valores anidados a más profundidad se mantienen literales. Ocupa como máximo 16 KiB junto con el resto de la entrada. |
| Resultados            | `success` y `failure`, cada uno con la salida `{}`. Si `failure` no está conectado, la ejecución falla.                                                                                                                                                                                              |

## Próximos pasos

- [Usa los datos de la llamada](/docs/guides/voice/sequences/data) en la asignación.
- [Configura menús de teclado](/docs/guides/voice/sequences/media-and-keypad) para las opciones del teclado.
- [Conecta tu aplicación a una automatización](/docs/guides/automations/application-events).

## Related resources

- [Voice sequences](/docs/guides/voice/sequence-builder) (docs)
