Trabajar con tarjetas en conversaciones de bots

Cuando configure tarjetas en WhatsApp, tenga en cuenta las siguientes consideraciones:

• WhatsApp admite hasta tres botones con tarjetas. Si configura más de tres botones, se produce un error.
• El soporte de WhatsApp se limita a los botones de retroceso de texto. WhatsApp no admite botones de URL.
• El cliente puede seleccionar cada botón de retroceso de texto una vez y no se limita a una sola opción. El comportamiento de su bot debe tener en cuenta escenarios en los que el usuario puede seleccionar múltiples opciones.
• WhatsApp no admite la defaultAction en la respuesta del bot para las tarjetas.
• Las tarjetas que incluyen una imagen o un vídeo no muestran un título. Cuando usa solo texto, se muestra el título.

Por ejemplo, si configura una tarjeta con un título de "50% de descuento en vuelos a Noruega" e incluye una imagen, el título no aparece:

Si configura la tarjeta con un título y sin imagen, el título aparece en la tarjeta:

1. Instale la integración de Amazon Lex desde Genesys AppFoundry.
2. Configurar la función de IAM con permisos para la aplicación Amazon Lex.
3. Configurar y activar la integración Lex en Genesys Cloud.
4. Para configurar opciones de respuesta rápida en la Consola de AWS Lex, use este JSON personalizado para definir las respuestas para la intención de su bot: 

{
    "genesys_prompt": "String", // optional message text
    "genesys_carousel": [
         {
              "title": "String", // mandatory cards title line
              "description": "String", // optional cards body text explaining its purpose
              "image": "URL", // optional a URL pointing to the image shown in the card
              "defaultAction":  {
                    "type": "String", //Describes the type of action. Valid values Link Postback
                    "text": "String", //The response text from the button click
                    "payload": "String", // Text to be returned as the payload from a ButtonResponse when a button is clicked.
                    "url": "String" //A URL of a web page to direct the user to.
              },
              "actions": [
                    {                                       
                         "type": "String", //Describes the type of action.  Valid values Link Postback
                         "text": "String", //The response text from the button click
                         "payload": "String" // Text to be returned as the payload from a ButtonResponse when a button is clicked.
                    },
                    {
                         "type": "String", //Describes the type of action.  Valid values Link Postback
                         "text": "String", //The response text from the button click
                         "url": "String" //A URL of a web page to direct the user to.
                    }
              ]
         }
    ]
}

Para usar las opciones de la tarjeta para llenar la ranura de su bot, use el editor de tarjetas de la Consola de AWS:

Haga clic en la imagen para ampliarla.

Para usar las opciones de la tarjeta para cambiar entre las intenciones de su bot, en la Consola de AWS Lex, copie el JSON personalizado de la sección anterior en el campo de entrada Respuesta:

Haga clic en la imagen para ampliarla.

Aprende más:

• Acerca de la integración de Amazon Lex
• Usar una tarjeta de respuesta en la AWS Developer Guide
• Tarjetas de respuesta en la página de gestión de mensajes de la Guía para desarrolladores de AWS

1. Instale la integración de Google Dialogflow desde Genesys AppFoundry.
2. Configurar la credencial de la cuenta de servicio de la plataforma Google Dialogflow.
3. Habilite la integración de Google Dialogflow.
4. Para configurar opciones de respuesta rápida en la consola de Dialogflow, use este JSON personalizado para definir opciones para la intención de su bot:

{
    "genesys_prompt": "String", // optional message text
    "genesys_carousel": [
         {
              "title": "String", // mandatory cards title line
              "description": "String", // optional cards body text explaining its purpose
              "image": "URL", // optional a URL pointing to the image shown in the card
              "defaultAction":  {
                    "type": "String", //Describes the type of action. Valid values Link Postback
                    "text": "String", //The response text from the button click
                    "payload": "String", // Text to be returned as the payload from a ButtonResponse when a button is clicked.
                    "url": "String" //A URL of a web page to direct the user to.
              },
              "actions": [
                    {                                       
                         "type": "String", //Describes the type of action.  Valid values Link Postback
                         "text": "String", //The response text from the button click
                         "payload": "String" // Text to be returned as the payload from a ButtonResponse when a button is clicked.
                    },
                    {
                         "type": "String", //Describes the type of action.  Valid values Link Postback
                         "text": "String", //The response text from the button click
                         "url": "String" //A URL of a web page to direct the user to.
                    }
              ]
         }
    ]
}

Para usar las opciones de la tarjeta para cambiar entre las intenciones de su bot, en la consola de Dialogflow, agregue el JSON personalizado de la sección anterior en el campo de entrada Respuesta:

Ejemplo de Google Cloud Dialogflow ES

Haga clic en la imagen para ampliarla.

Ejemplo de Google Cloud Dialogflow CX

Haga clic en la imagen para ampliarla.

Para usar las opciones de la tarjeta para llenar la ranura de su bot, use el JSON personalizado de la sección anterior en un webhook. También puede utilizar AWS Lambda para este propósito. Para más información, consulte Webhook for slot filling en la guía de Google Cloud Dialogflow ES.

Aprende más:

• Acerca de la integración de Google Dialogflow
• Webhook para llenar ranuras en la guía de Google Cloud Dialogflow ES

1. Crear un bot que se adhiera a las especificaciones de Genesys Bot Connector. 
2. Configurar la integración de Genesys Bot Connector.
3. Utilice el objeto de tarjeta PostTextMessage para definir las tarjetas.

Aprende más:

• Acerca de Genesys Bot Connector
• Ejemplo de respuesta a la postre - Tarjetas