Sdílet prostřednictvím

Přidání navrhovaných akcí do zpráv pomocí rozhraní API konektoru robota

  • Článek

Navrhované akce umožňují robotovi prezentovat tlačítka, na která může uživatel klepnout a zadat vstup. Navrhované akce se zobrazují blízko autora a zlepšují uživatelské prostředí tím, že uživateli umožňují odpovědět na otázku nebo vybrat jednoduchým klepnutím na tlačítko a nemusíte psát odpověď pomocí klávesnice. Na rozdíl od tlačítek, která se zobrazují ve formátovaných kartách (která zůstávají viditelná a přístupná uživateli i po klepnutí), tlačítka, která se zobrazí v podokně navrhovaných akcí, zmizí, jakmile uživatel provede výběr. Zabráníte tak uživateli v klepnutí na zastaralá tlačítka v konverzaci a zjednodušíte vývoj robotů.

Odeslání navrhovaných akcí

Pokud chcete do zprávy přidat navrhované akce, nastavte suggestedActions vlastnost objektu Activity tak, aby určila seznam objektů CardAction , které představují tlačítka, která se mají uživateli zobrazit.

Následující požadavek odešle zprávu, která uživateli představí tři navrhované akce. V tomto příkladu požadavku představuje základní identifikátor URI; https://smba.trafficmanager.net/teams základní identifikátor URI pro požadavky, které se můžou lišit problémy s robotem. Podrobnosti o nastavení základního identifikátoru URI najdete v referenčních informacích k rozhraní 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"
}

Když uživatel klepne na jednu z navrhovaných akcí, robot obdrží od uživatele zprávu, která obsahuje value odpovídající akci.

Další materiály