Bagikan melalui

Menambahkan tindakan yang disarankan ke pesan dengan Bot Connector API

Tindakan yang disarankan memungkinkan bot Anda menyajikan tombol yang dapat diketuk pengguna untuk memberikan input. Tindakan yang disarankan muncul dekat dengan komposer dan meningkatkan pengalaman pengguna dengan memungkinkan pengguna menjawab pertanyaan atau membuat pilihan dengan ketukan sederhana tombol, daripada harus mengetik respons dengan keyboard. Tidak seperti tombol yang muncul dalam kartu kaya (yang tetap terlihat dan dapat diakses oleh pengguna bahkan setelah diketuk), tombol yang muncul dalam panel tindakan yang disarankan akan hilang setelah pengguna membuat pilihan. Ini mencegah pengguna mengetuk tombol basi dalam percakapan dan menyederhanakan pengembangan bot.

Mengirim tindakan yang disarankan

Untuk menambahkan tindakan yang disarankan ke pesan, atur suggestedActions properti objek Aktivitas untuk menentukan daftar objek CardAction yang mewakili tombol yang akan disajikan kepada pengguna.

Permintaan berikut mengirimkan pesan yang menyajikan tiga tindakan yang disarankan kepada pengguna. Dalam contoh permintaan ini, https://smba.trafficmanager.net/teams mewakili URI dasar; URI dasar untuk permintaan bahwa masalah bot Anda mungkin berbeda. Untuk detail tentang mengatur URI dasar, lihat Referensi 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"
}

Saat pengguna mengetuk salah satu tindakan yang disarankan, bot akan menerima pesan dari pengguna yang berisi value tindakan yang sesuai.

Sumber Daya Tambahan: