Canales de solo texto

Al igual que el canal de Facebook, puede configurar canales de solo texto mediante artefactos generados por la plataforma de mensajería y Digital Assistant. Sin embargo, para los canales solo de texto como Twilio/SMS, también necesita actualizar la definición del flujo de diálogo para permitir que las respuestas del bot se representen adecuadamente cuando no se admita el uso de botones. Hay dos aspectos relevantes:

Mostrar u ocultar contenido para canales de solo texto. Para los componentes de respuesta común, esto significa que debe actualizar la propiedad metadata para incluir (o excluir, si corresponde) Twilio en cualquier elemento de respuesta, tarjeta o acción global:

responseItems:
- type: "text"
  text: "This text text displays on Twilio"
  visible:
    channels:
      include: "twilio"             
- type: "text"
  text: "This text is not shown in Twilio or Facebook!"
  visible:
    channels:
      exclude: "facebook, twilio"
  actions:
  - label: "This action is only shown on web channel."
    type: "postback"
    payload:
      action: "someAction"
    visible:
      channels:
        include: "web"

Configuración de numeración automática.

Twilio/SMS

Para ejecutar el asistente digital en Twilio/SMS, necesitará lo siguiente:

Credenciales de Twilio (se proporcionan en la configuración del canal de Digital Assistant):
- Número de teléfono de Twilio.
- SID de cuenta
- Token de autenticación
De Digital Assistant (y proporcionado aTwilio):
- URL de webhook (generado al crear el canal de Twilio).

Nota

Si crea un canal para un asistente digital en Twilio, recuerde que "exit" (salida), que los usuarios pueden utilizar para salir de las aptitudes en el asistente digital, también es, por defecto, una palabra clave en Twilio. Por lo tanto, si un usuario introduce "exit" en un canal de Twilio, la conversación de Twilio finalizará y el asistente digital no recibirá dicha entrada. Los usuarios que quieran que "exit" funcione con el asistente digital deberán ponerse en contacto con Twilio para eliminar "exit" como palabra clave en su cuenta.

Paso 1: obtención de un número de Twilio activado para SMS

Para generar el número de Twilio, el SID de cuenta y el token de autenticación necesarios para la configuración del canal de Twilio, antes tiene que crear una cuenta de Twilio (si aún no tiene una). Después de verificar su identidad:

Haga clic en All Products and Services () en la barra de navegación izquierda.
Ancle Programable SMS () y Phone Numbers () en el panel de control.

Descripción de la ilustración twilio-products.png
Haga clic en Phone Numbers (anclado en la barra de navegación izquierda) y, a continuación, en Get Started.
Seleccione Get a Number o Buy a Number. En cualquier caso, asegúrese de seleccionar la capacidad SMS. Tenga el número a mano, ya que lo va a utilizar para configurar el canal de Twilio en Digital Assistant.
Haga clic en Console Dashboard () en la barra de navegación izquierda y tome nota del SID de cuenta y el token de autenticación (haga clic en View para acceder a estos datos). Además del número de Twilio, necesitará estas credenciales para configurar el canal de Twilio.

Paso 2: enlace del bot con el número de Twilio

Con las credenciales de Twilio a mano:

Vuelva a Digital Assistant, haga clic en Canales en el menú de la izquierda y, a continuación, seleccione Usuarios.
Haga clic en Agregar canal.
En el cuadro de diálogo Crear canal:
1. Introduzca un nombre y, a continuación, seleccione SMS de Twilio en el menú Tipo de canal.
2. Introduzca el SID de cuenta, el token de autenticación y el número de Twilio.
3. Active Canal activado.
4. Haga clic en y seleccione el asistente digital o la aptitud que desea asociar al canal.
Haga clic en Crear. Anote el URL del webhook. Lo necesitará para la última parada en la consola de Twilio.
En la consola de Twilio, haga clic en Phone Numbers () y, a continuación, haga clic en Active Numbers.
Haga clic en el número de Twilio en la página Números Activos.
En la sección Messaging de la página Configure, pegue el URL del webhook en el campo A Message Comes In.
Haga clic en Guardar.

Sugerencias relativas a las pruebas

Puede probar el canal de Twilio con su propio teléfono enviando mensajes al número de cuenta de Twilio de Digital Assistant.

Capacidades admitidas

Los canales de Twilio en Digital Assistant admiten las siguientes capacidades:

text
imágenes (como URL)
archivos (como URL)
emojis (como URL)
enlaces
devoluciones (como URL)
propiedades personalizadas (parcial)
componentes del carrusel (parcial)
componentes de lista (parcial)

Nota

Si va a dirigir su aptitud a varios canales con diferentes capacidades de formato, puede utilizar el marcado HTML en los mensajes. Para los canales basados en texto, este marcado se eliminará del mensaje cuando el mensaje se transmita al canal. Consulte Formato de texto enriquecido en canales.

Restricciones de mensajes

Los canales de Twilio en Digital Assistant presentan las siguientes restricciones de mensaje:

Mensajes de texto
- Longitud máxima del mensaje de texto: 1600 caracteres. Si la longitud supera los 1600 caracteres, el texto se dividirá en varios mensajes.
- Tipos de acciones de texto permitidas: devolución, llamada, URL. Estos tipos de acción se convierten en texto. Para las acciones de devolución, la etiqueta sirve como una palabra clave que se puede utilizar para disparar la devolución.
Tarjetas horizontales
- ¿Se admite? No, pero se logra una funcionalidad equivalente mediante la conversión de algunos tipos de acciones a texto.
- Tipos de acciones de tarjeta permitidas: devolución, llamada, URL. Estos tipos de acción se convierten en texto. Para las acciones de devolución, la etiqueta sirve como una palabra clave que se puede utilizar para disparar la devolución.
- Tipos de acciones de lista de tarjetas permitidas: devolución, llamada, URL. Estos tipos de acción se convierten en texto. Para las acciones de devolución, la etiqueta sirve como una palabra clave que se puede utilizar para disparar la devolución.
Tarjetas verticales
- Se admite: no, pero se consigue una funcionalidad casi equivalente convirtiendo algunos tipos de acciones a texto.
- Tipos de acciones de tarjeta permitidas: devolución, llamada, URL. Estos tipos de acción se convierten en texto. Para las acciones de devolución, la etiqueta sirve como una palabra clave que se puede utilizar para disparar la devolución.
- Tipos de acciones de lista de tarjetas permitidas: devolución, llamada, URL. Estos tipos de acción se convierten en texto. Para las acciones de devolución, la etiqueta sirve como una palabra clave que se puede utilizar para disparar la devolución.
Mensajes anexos
- ¿Se admite? Sí, si se ha activado MMS.
- Tipos de acciones de anexo permitidas: devolución, llamada, URL. Estos tipos de acción se convierten en texto. Para las acciones de devolución, la etiqueta sirve como una palabra clave que se puede utilizar para disparar la devolución.
Botones de acción
- ¿Se admite? No, pero se logra una funcionalidad casi equivalente convirtiendo algunos tipos de acción en texto.
- Tipos de acciones globales permitidas: devolución, llamada, URL. Estos tipos de acción se convierten en texto. Para las acciones de devolución, la etiqueta sirve como una palabra clave que se puede utilizar para disparar la devolución.

Extensiones de canal de Twilio

Para los canales de Twilio, puede ampliar la funcionalidad de los componentes de respuesta común con capacidades específicas de Twilio.

Para acceder a las extensiones, utilice el elemento channelCustomProperties del componente y defina las propiedades adecuadas. El código tiene el formato siguiente:

...
            channelCustomProperties:
            - channel: "twilio"
              properties:
                PROPERTY_NAME: "PROPERTY_VALUE"
...

Puede aplicar channelCustomProperties en los metadatos del componente en el nivel de globalActions, responseItems y elementos de responseItems, en función de la propiedad especificada.

A continuación, se muestran las propiedades personalizadas disponibles para los canales de Twilio:

Nombre	Valores permitidos	Se aplica a...	Descripción
`mmsEnabled`	`true` `false`	Elementos de respuesta de tipo `cards` o `attachment`.	Se puede utilizar para sustituir la configuración por defecto con MMS activado de la configuración del canal. Si se activa, las imágenes se muestran en su propia burbuja de mensaje con el botón Pulsar para revisar.
`optimizeCardRendering`	`true` `false`	Elementos de respuesta de tipo `cards`.	Defínala en `true` para que la selección de acciones de tarjeta sea un proceso de dos pasos, en el que el usuario seleccione primero una tarjeta y, a continuación, seleccione la acción de tarjeta.
`cardListHeader`	texto libre	Elementos de respuesta de tipo `cards`.	Cabecera que se muestra cuando se presenta la lista de tarjetas. Esta propiedad sustituye la propiedad `headerText` del mensaje de la tarjeta. Solo se aplica cuando `optimizeCardRendering` se ha definido en `true`.
`cardListFooter`	texto libre	Elementos de respuesta de tipo `cards`.	Pie de página que se muestra cuando se presenta la lista de tarjetas. Esta propiedad sustituye a la propiedad `footerText` del mensaje de tarjeta. Solo se aplica cuando `optimizeCardRendering` se ha definido en `true`.
`cardDetailHeader`	texto libre	Cualquiera de los siguientes: Una tarjeta en la que se especifica la propiedad `"url"` Un elemento `action` donde `"type": "url"`	Cabecera que se muestra cuando se presenta el detalle de la tarjeta. Esta propiedad sustituye la propiedad `headerText` del mensaje de la tarjeta. Solo se aplica cuando `optimizeCardRendering` se ha definido en `true`.
`cardDetailFooter`	texto libre	Cualquiera de los siguientes: Una tarjeta en la que se especifica la propiedad `"url"` Un elemento `action` donde `"type": "url"`	Pie de página que se muestra cuando se presenta el detalle de la tarjeta. Esta propiedad sustituye a la propiedad `footerText` del mensaje de tarjeta. Solo se aplica cuando `optimizeCardRendering` se ha definido en `true`.

Para obtener más información sobre el uso de channelCustomProperties, consulte Extensiones específicas del canal.

Documentación de Oracle Cloud Infrastructure