Dela via

Lägga till föreslagna åtgärder i meddelanden med Bot Connector-API:et

  • Artikel

Föreslagna åtgärder gör att roboten kan visa knappar som användaren kan trycka på för att ange indata. Föreslagna åtgärder visas nära kompositören och förbättrar användarupplevelsen genom att göra det möjligt för användaren att besvara en fråga eller göra ett val med ett enkelt knapptryck i stället för att behöva skriva ett svar med ett tangentbord. Till skillnad från knappar som visas i omfattande kort (som förblir synliga och tillgängliga för användaren även efter att ha knackats), försvinner knappar som visas i åtgärdsfönstret som föreslås när användaren har gjort ett val. Detta förhindrar att användaren trycker på inaktuella knappar i en konversation och förenklar robotutvecklingen.

Skicka föreslagna åtgärder

Om du vill lägga till föreslagna åtgärder i ett meddelande anger du suggestedActions egenskapen för aktivitetsobjektet för att ange listan över CardAction-objekt som representerar knapparna som ska visas för användaren.

Följande begäran skickar ett meddelande som presenterar tre föreslagna åtgärder för användaren. I den här exempelbegäran https://smba.trafficmanager.net/teams representerar du bas-URI:n. Bas-URI:n för begäranden om att dina robotproblem kan vara annorlunda. Mer information om hur du anger bas-URI finns i API-referens.

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

När användaren trycker på någon av de föreslagna åtgärderna får roboten ett meddelande från användaren som innehåller value motsvarande åtgärd.

Ytterligare resurser