Incorporación de acciones sugeridas a los mensajes con la API del conector de botAdd suggested actions to messages with the Bot Connector API

Las acciones sugeridas permiten que el bot presente los botones en los que el usuario puede pulsar para proporcionar una entrada.Suggested actions enable your bot to present buttons that the user can tap to provide input. Las acciones sugeridas aparecen cerca del compositor y mejoran la experiencia del usuario al permitir que este responda una pregunta o haga una selección simplemente pulsando un botón, en lugar de tener que escribir una respuesta con un teclado.Suggested actions appear close to the composer and enhance user experience by enabling the user to answer a question or make a selection with a simple tap of a button, rather than having to type a response with a keyboard. A diferencia de los botones que aparecen en las tarjetas enriquecidas (que permanecen visibles y accesibles para el usuario incluso después de que se pulsen), los botones que aparecen en el panel de acciones sugeridas desaparecerán una vez que el usuario haya hecho una selección.Unlike buttons that appear within rich cards (which remain visible and accessible to the user even after being tapped), buttons that appear within the suggested actions pane will disappear after the user makes a selection. Esto evita que el usuario pulse botones obsoletos dentro de una conversación y simplifica el desarrollo de bots (ya que no necesitará tener en cuenta ese escenario).This prevents the user from tapping stale buttons within a conversation and simplifies bot development (since you will not need to account for that scenario).

Envío de acciones sugeridasSend suggested actions

Para agregar acciones sugeridas a un mensaje, establezca la propiedad suggestedActions del objeto Actividad para especificar la lista de objetos CardAction que representan los botones que se presentarán al usuario.To add suggested actions to a message, set the suggestedActions property of the Activity object to specify the list of CardAction objects that represent the buttons to be presented to the user.

La siguiente solicitud envía un mensaje que presenta tres acciones sugeridas al usuario.The following request sends a message that presents three suggested actions to the user. En la solicitud del ejemplo, https://smba.trafficmanager.net/apis representa el URI base; el URI base para solicitudes que su bot emita puede ser distinto.In this example request, https://smba.trafficmanager.net/apis represents the base URI; the base URI for requests that your bot issues may be different. Para obtener más información sobre cómo establecer el URI base, consulte API Reference (Referencia de la API).For details about setting the base URI, see API Reference.

POST https://smba.trafficmanager.net/apis/v3/conversations/abcd1234/activities/5d5cdc723
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json
{
    "type": "message",
    "from": {
        "id": "12345678",
        "name": "sender's name"
    },
    "conversation": {
        "id": "abcd1234",
        "name": "conversation's name"
   },
   "recipient": {
        "id": "1234abcd",
        "name": "recipient's name"
    },
    "text": "I have colors in mind, but need your help to choose the best one.",
    "inputHint": "expectingInput",
    "suggestedActions": {
        "actions": [
            {
                "type": "imBack",
                "title": "Blue",
                "value": "Blue"
            },
            {
                "type": "imBack",
                "title": "Red",
                "value": "Red"
            },
            {
                "type": "imBack",
                "title": "Green",
                "value": "Green"
            }
        ]
    },
    "replyToId": "5d5cdc723"
}

Cuando el usuario pulsa en una de las acciones sugeridas, el bot recibirá un mensaje del usuario que contiene el elemento value de la acción correspondiente.When the user taps one of the suggested actions, the bot will receive a message from the user that contains the value of the corresponding action.

Recursos adicionalesAdditional resources