Sign inGet Started

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 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 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. 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

ResultadoSignificado y siguiente acción
SuccessEl evento se puso en cola para la automatización. Continúa la llamada.
FailureNo 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 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 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:

Ejemplo de código
{
  "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" }
  }
}
CampoValor
config{}.
input.automation_idObligatorio. ID de una automatización de este espacio de trabajo.
input.eventObligatorio. El nombre del evento de la automatización: de 1 a 128 letras, dígitos, puntos, guiones bajos o guiones.
input.dataOpcional, 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.
Resultadossuccess y failure, cada uno con la salida {}. Si failure no está conectado, la ejecución falla.

Próximos pasos

Continúa con la documentación, guías y ejemplos de este tema.