Utiliza Architect para crear un bot digital para concertar una cita

También puede crear acciones personalizadas en Genesys Cloud para usar con sus integraciones de acciones de datos. Copie una acción existente (estática o personalizada) para usarla como plantilla, o siga estos pasos para crear una acción completamente nueva. Cuando agrega una acción, puede agregar contratos y configuración o importarlos desde otra acción de datos.

En Genesys Cloud, utilice una acción de datos para recuperar los valores durante la conversación del bot. Definir el contrato de entrada y el contrato de salida. El Contrato de salida en la acción de datos debe coincidir con el mensaje de retorno que configure en su ruta a endpoint. 

Para crear una acción de datos en Genesys Cloud, complete estos pasos:

1. En Genesys Cloud, haga clic en Administración.
2. Debajo Integraciones, haga clic en Comportamiento.
3. Crea una acción personalizada para integraciones
4. Agregar contratos. 
5. Agregar configuración. 
6. Prueba la acción.

Para más información, ver Gestionar acciones individuales para integraciones.

Ejemplo: Un punto final API de prueba

Ejemplo: Ficha Contratos de acciones de datos de Genesys Cloud

1. Desde la página de inicio de Architect, haga clic o coloque el cursor sobre el Flujos menú y seleccione Flujos de bots digitales.
2. Hacer clic Agregar. Se abre el cuadro de diálogo Crear flujo de bot.
3. En el Nombre campo, ingrese un nombre único para el flujo. 
4. (Opcional) En el Descripción campo, agregue una oración o frase corta para describir este flujo.
5. Haga clic en el Idioma predeterminado lista y seleccione el idioma admitido predeterminado del flujo.
6. Haga clic en el Divisiones lista y seleccione la división en la que colocar el flujo.
7. Hacer clic Crear flujo. Se abre la página de configuración del flujo.

Para llamar a una acción de datos desde un flujo de bot de Architect, siga estos pasos:

1. Desde la caja de herramientas de Architect, arrastre un Llamar a la acción de datos en el editor de tareas, debajo del elemento Inicio.
2. Bajo Categoría, seleccione la categoría de integraciones adecuada; por ejemplo, acciones de datos de servicios web.
3. En Data Action, seleccione la acción de datos del programador que creó en Genesys Cloud Admin.
4. Para configurar las salidas de éxito, haga lo siguiente:
   • Configure una variable en el campo slots.startTime para almacenar los valores DateTime de inicio recuperados de Call Data Action. Por ejemplo, Flow.availableStartTimes.
   • Configure una variable en el campo slots.duration para almacenar el valor de duración recuperado de Call Data Action. Por ejemplo, Flow.appointmentDurations.
5. Definir salidas de fallo y tiempo de espera.

Ejemplo: Llamada Data Action

Prepare una lista de objetos de franja horaria para utilizar en su flujo convirtiendo los datos de su acción de datos. 

Para leer los datos recuperados, utilice una acción Loop:

1. Desde la caja de herramientas de Architect, arrastre una acción Loop al editor de tareas, debajo de la acción Call Data.
2. Añada un nombre de datos de índice como Flow.loopindex.
3. Establezca el recuento máximo del bucle en la expresión, Count(Flow.availableStartTimes). Puede elegir cualquiera de las variables definidas en la ruta Success de su Call Data Action.
   Siguiendo este método, se ejecuta el bucle una vez por cada elemento devuelto por la acción de datos. Posteriormente, puede crear una lista de objetos de franja horaria y almacenarla en el tipo de datos Colección.
4. Para crear una colección de franjas horarias, 
   1. Desde la caja de herramientas, expanda la categoría Data y arrastre una acción Update Data a la acción Loop.
   2. En el área de trabajo Actualizar datos, haga clic en junto a Actualizar sentencias y seleccione Colecciones.
   3. Con la lista de colecciones abierta, seleccione Timeslot Collection.
   4. En Nombre de variable 1, introduzca un nombre para la lista que debe almacenar la lista completa de franjas horarias. Por ejemplo, Flow.timeslots.
   5. En Valor a asignar 1, añada la expresión, AddItem(Flow.timeslots, MakeTimeslot(ToDateTime(Flow.availableStartTimes[Flow.loopindex]), ToDuration(Flow.appointmentDurations[Flow.loopindex]))).
      La expresión anterior toma el elemento de la lista de Flow.availableStartTimes que coincide con el índice del bucle actual y lo convierte en un objeto DateTime. También toma el elemento correspondiente de la lista de Flow.appointmentDurations y lo convierte en un objeto de duración. Por último, combina los dos en un nuevo objeto de franja horaria y añade ese objeto a la variable Timeslot Collection.

Ejemplo: Acción en bucle

Ejemplo: Acción Actualizar datos

1. En Natural Language Understanding, haga clic en Slots.
2. Haga clic en Slot.
3. Introduzca un nombre significativo para la ranura y haga clic en Guardar.
4. En Natural Language Understanding, haga clic en Slot Types.
5. Haga clic en el nombre del tipo de ranura recién añadido. 
6. En franjas horarias, haga clic en Añadir colección. Aparece la ventana Timeslots.
7. Añada la expresión, Flow.timeslots y haga clic en Cierre.

Ejemplo: Franjas horarias en modo Expresión

1. Desde la caja de herramientas de Architect, arrastre una acción Pedir ranura al editor de tareas, debajo de la acción Bucle.
2. En Franja horaria, seleccione la franja horaria que creó anteriormente y, a continuación, rellene los campos correspondientes.
3. Personalice la imagen, el título, el subtítulo y la dirección del aviso según cómo deba ser presentado por el bot.
4. Publica el flujo.

Ejemplo: Solicitar franja horaria con personalización del selector de tiempo

Caso: Falla la acción de datos

Si la API de terceros encuentra un error, el flujo del bot toma la ruta de fallo de la Call Data Action. Personalice la ruta de fallo en función de su caso de uso. Por ejemplo, puede utilizar una acción Transfer to ACD para enrutar la interacción a un agente disponible. 

Caso: Se agota el tiempo de acción de los datos

Si se agota el tiempo de espera de la solicitud a la API de terceros, el flujo del bot toma la ruta Timeout de la acción Call Data Action. La acción de datos puede tener éxito en un segundo o tercer intento. Para configurar múltiples intentos, puede colocar la acción de datos de llamada dentro de una acción Loop con un recuento máximo de bucles bastante bajo. Asegúrese de colocar también una acción Salir del bucle después de la acción Llamar a datos.

Caso: La API de terceros no devuelve franjas horarias

Incluso si todas las franjas horarias están reservadas, la acción Call Data Action toma la ruta Success porque la solicitud se procesa con éxito. El bot puede encontrar un error ya que no hay valores de franja horaria disponibles para alimentar la ranura. En este caso, se muestra el mensaje Error.Expresson.EmptyCollection. Para evitar este error, puede colocar un bloque Decisión después de la acción Actualizar datos (dentro de la acción existente Bucle ). Puede utilizar el bloque Decision para ejecutar la acción Ask for Slot sólo si hay valores de franja horaria válidos disponibles. Para saber si la lista de franjas horarias está vacía o no, utilice la expresión IsNotSetOrEmpty(Flow.timeslots).

Caso: Todas las franjas horarias están en el pasado

Incluso si todas las franjas horarias están en el pasado, la acción Call Data Action toma la ruta Success porque la solicitud se procesa con éxito. Sin embargo, el bot no puede presentar una franja horaria pasada. Para asegurarse de que todas las franjas horarias presentadas a un usuario son futuras, puede colocar otro bloque Decision antes de la acción Update Data (dentro de la acción Loop ).

La expresión, ToDateTime(Flow.availableStartTimes[Flow.loopIndex]) > GetCurrentDateTimeUtc(), le ayuda a encontrar si una franja horaria está en fecha pasada o futura.