Freigeben über

Hinzufügen vorgeschlagener Aktionen zu Nachrichten mit der Bot Connector-API

  • Artikel

Mit vorgeschlagenen Aktionen können Bots Schaltflächen darstellen, auf die Benutzer zur Eingabe tippen können. Vorgeschlagene Aktionen erscheinen in der Nähe des Benutzers und verbessern die Benutzerfreundlichkeit. Der Benutzer kann Fragen beantworten oder durch einfaches Antippen einer Schaltfläche eine Auswahl treffen, anstatt eine Antwort mit der Tastatur einzugeben. Im Gegensatz zu Schaltflächen in Rich Cards (die für den Benutzer auch nach dem Antippen sichtbar und zugänglich bleiben), verschwinden die im Bereich der vorgeschlagenen Aktionen angezeigten Schaltflächen, nachdem der Benutzer eine Auswahl getroffen hat. Dadurch wird verhindert, dass der Benutzer auf veraltete Schaltflächen innerhalb einer Unterhaltung tippt, und die Botentwicklung wird vereinfacht.

Senden vorgeschlagener Aktionen

Zum Hinzufügen vorgeschlagener Aktionen zu einer Nachricht legen Sie die suggestedActions-Eigenschaft des Aktivität-Objekts auf die Liste der CardAction-Objekte fest, die die Schaltflächen darstellen, die dem Benutzer angezeigt werden.

Die folgende Anforderung sendet eine Nachricht mit drei vorgeschlagenen Aktionen für den Benutzer. In dieser Beispielanforderung stellt https://smba.trafficmanager.net/teams den Basis-URI dar. Der Basis-URI für Anforderungen, die Ihr Bot ausgibt, kann ein anderer sein. Weitere Informationen zum Festlegen des Basis-URI finden Sie in der API-Referenz.

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"
}

Wenn der Benutzer auf eine der vorgeschlagenen Aktionen tippt, empfängt der Bot vom Benutzer eine Nachricht mit dem value der entsprechenden Aktion.

Zusätzliche Ressourcen