Condividi tramite

Aggiungere azioni suggerite ai messaggi con l'API Bot Connector

  • Articolo

Le azioni consigliate consentono al bot di presentare i pulsanti che l'utente può toccare per fornire l'input. Le azioni consigliate vengono visualizzate vicino al compositore e migliorano l'esperienza utente per consentirgli di rispondere a una domanda o di effettuare una selezione con il semplice tocco di un pulsante, anziché dover digitare una risposta con una tastiera. A differenza dei pulsanti presenti all'interno di schede avanzate (che restano visibili e accessibili all'utente anche dopo averli toccati), i pulsanti visualizzati all'interno del riquadro azioni consigliate non verranno più visualizzati dopo che l'utente effettua una selezione. Ciò impedisce all'utente di toccare pulsanti non aggiornati all'interno di una conversazione e semplifica lo sviluppo di bot.

Inviare azioni suggerite

Per aggiungere le azioni suggerite a un messaggio, impostare la proprietà suggestedActions dell'oggetto Attività per specificare l'elenco degli oggetti CardAction che rappresentano i pulsanti da presentare all'utente.

La richiesta seguente mostra come inviare un messaggio che presenta tre azioni consigliate all'utente. In questa richiesta di esempio https://smba.trafficmanager.net/teams rappresenta l'URI di base. L'URI di base per le richieste inviate dal bot può essere diverso. Per informazioni dettagliate sull'impostazione dell'URI di base, vedere Informazioni di riferimento sulle API.

POST https://smba.trafficmanager.net/teams/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"
}

Quando l'utente tocca una delle azioni suggerite, il bot riceve un messaggio dall'utente con il value dell'azione corrispondente.

Risorse aggiuntive