Aracılığıyla paylaş

Bot Bağlayıcısı API'siyle iletilere önerilen eylemleri ekleme

  • Makale

Önerilen eylemler, botunuzun kullanıcının giriş sağlamak için dokunabileceği düğmeler sunmasını sağlar. Önerilen eylemler oluşturucuya yakın görünür ve kullanıcının klavyeyle yanıt yazmak yerine basit bir düğmeye dokunarak bir soruyu yanıtlamasını veya seçim yapmasını sağlayarak kullanıcı deneyimini geliştirir. Zengin kartlarda görünen düğmelerin aksine (dokunulduğunda bile görünür ve kullanıcı tarafından erişilebilir durumda kalır), kullanıcı seçim yaptıktan sonra önerilen eylemler bölmesinde görünen düğmeler kaybolur. Bu, kullanıcının konuşmadaki eski düğmelere dokunmasını önler ve bot geliştirmeyi basitleştirir.

Önerilen eylemleri gönderme

İletiye önerilen eylemleri eklemek için Activity nesnesinin özelliğini, kullanıcıya sunulacak düğmeleri temsil eden CardAction nesnelerinin listesini belirtecek şekilde ayarlayınsuggestedActions.

Aşağıdaki istek, kullanıcıya üç önerilen eylem sunan bir ileti gönderir. Bu örnek istekte temel https://smba.trafficmanager.net/teams URI'yi temsil eder; bot sorunlarınızın farklı olabileceği isteklerin temel URI'sini temsil eder. Temel URI'yi ayarlama hakkında ayrıntılı bilgi için bkz. API Başvurusu.

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

Kullanıcı önerilen eylemlerden birine dokunduğunda, bot kullanıcıdan ilgili eylemi içeren value bir ileti alır.

Ek kaynaklar