Megosztás a következőn keresztül:

Javasolt műveletek hozzáadása üzenetekhez a Bot Connector API-val

  • Cikk

A javasolt műveletek lehetővé teszik, hogy a robot megjelenítse azokat a gombokat, amelyekre a felhasználó koppinthat a bemenet megadásához. A javasolt műveletek a szerzőhöz közel jelennek meg, és javítják a felhasználói élményt azáltal, hogy lehetővé teszik a felhasználónak, hogy válaszoljon egy kérdésre, vagy egy gomb egyszerű koppintásával válasszon, ahelyett, hogy billentyűzettel kellene beírnia a választ. Ellentétben a gazdag kártyákon megjelenő gombokkal (amelyek a leképezettség után is láthatóak és elérhetők maradnak a felhasználó számára), a javasolt műveletek panelen megjelenő gombok eltűnnek, miután a felhasználó kiválasztotta őket. Ez megakadályozza, hogy a felhasználó a beszélgetésben elavult gombokra koppintjon, és leegyszerűsítse a robotok fejlesztését.

Javasolt műveletek küldése

Ha javasolt műveleteket szeretne hozzáadni egy üzenethez, a Tevékenység objektum tulajdonságának beállításával suggestedActions adja meg a felhasználónak megjeleníteni kívánt gombokat megjelenítő CardAction-objektumok listáját.

A következő kérés egy üzenetet küld, amely három javasolt műveletet mutat be a felhasználónak. Ebben a példakérésben https://smba.trafficmanager.net/teams az alap URI-t jelöli, a robottal kapcsolatos problémákat okozó kérések alap URI-ja pedig eltérő lehet. Az alap URI beállításával kapcsolatos részletekért lásd: API-referencia.

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

Amikor a felhasználó az egyik javasolt műveletre koppint, a robot egy üzenetet kap a felhasználótól, amely tartalmazza a value megfelelő műveletet.

További források