Udostępnij za pośrednictwem

Dodawanie sugerowanych akcji do komunikatów za pomocą interfejsu API łącznika botów

  • Artykuł

Sugerowane akcje umożliwiają botowi prezentowanie przycisków, które użytkownik może nacisnąć, aby podać dane wejściowe. Sugerowane akcje pojawiają się blisko kompozytora i usprawniają środowisko użytkownika, umożliwiając użytkownikowi udzielenie odpowiedzi na pytanie lub wybranie za pomocą prostego naciśnięcia przycisku, a nie konieczności wpisywania odpowiedzi za pomocą klawiatury. W przeciwieństwie do przycisków wyświetlanych na kartach rozbudowanych (które pozostają widoczne i dostępne dla użytkownika nawet po naciśnięciu), przyciski wyświetlane w okienku sugerowanych akcji znikną po wybraniu przez użytkownika. Uniemożliwia to użytkownikowi naciśnięcie nieaktualnych przycisków w konwersacji i upraszcza tworzenie botów.

Wysyłanie sugerowanych akcji

Aby dodać sugerowane akcje do komunikatu, ustaw suggestedActions właściwość obiektu Activity , aby określić listę obiektów CardAction reprezentujących przyciski, które mają być prezentowane użytkownikowi.

Następujące żądanie wysyła komunikat, który przedstawia użytkownikowi trzy sugerowane akcje. W tym przykładowym żądaniu https://smba.trafficmanager.net/teams reprezentuje podstawowy identyfikator URI. Podstawowy identyfikator URI żądań, które mogą być inne. Aby uzyskać szczegółowe informacje na temat ustawiania podstawowego identyfikatora URI, zobacz Dokumentacja interfejsu 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"
}

Gdy użytkownik naciągnie jedną z sugerowanych akcji, bot otrzyma od użytkownika komunikat zawierający value odpowiednią akcję.

Dodatkowe zasoby