Aracılığıyla paylaş

Bot Bağlayıcısı API'siyle iletilere giriş ipuçları ekleme

  • Makale

İleti için bir giriş ipucu belirterek, ileti istemciye teslim edildikten sonra botunuzun kullanıcı girişini kabul ettiğini, beklediğini veya yoksaydığını belirtebilirsiniz. Bu alanı destekleyen kanallar için bu, istemcilerin kullanıcı giriş denetimlerinin durumunu buna göre ayarlamasına olanak tanır. Örneğin, bir iletinin giriş ipucu botunun kullanıcı girişini yoksaydığını gösteriyorsa, istemci kullanıcının giriş sağlamasını önlemek için mikrofonu kapatabilir ve giriş kutusunu devre dışı bırakabilir.

Girişi kabul etme

Botunuzun pasif olarak girişe hazır olduğunu ancak kullanıcıdan yanıt beklemediğini belirtmek için, iletinizi temsil eden Activity nesnesi içinde acceptingInput özelliğini ayarlayıninputHint. Birçok kanalda bu, istemcinin giriş kutusunun etkinleştirilmesine ve mikrofonunun kapatılmasına, ancak kullanıcının erişmesine neden olur.

Aşağıdaki örnekte, ileti gönderen ve botunun girişi kabul ettiğini belirten bir istek gösterilmektedir. Bu örnek istekte Direct Line temel URI'yi temsil eder; bot sorunlarınızın farklı olabileceği istekler için temel URI. 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": "Here's a picture of the house I was telling you about.",
    "inputHint": "acceptingInput",
    "replyToId": "5d5cdc723"
}

Giriş bekleniyor

Botunuzun kullanıcıdan etkin bir şekilde yanıt beklediğini belirtmek için, iletinizi temsil eden Activity nesnesi içinde özelliğini awaitInput olarak ayarlayıninputHint. Bunu destekleyen kanallarda bu, istemcinin giriş kutusunun etkinleştirilmesine ve mikrofonunun açık olmasına neden olur.

Aşağıdaki örnekte, bir ileti gönderen ve botu giriş beklediğini belirten bir istek gösterilmektedir. Bu örnek istekte Direct Line temel URI'yi temsil eder; bot sorunlarınızın farklı olabileceği istekler için temel URI. 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": "What is your favorite color?",
    "inputHint": "expectingInput",
    "replyToId": "5d5cdc723"
}

Girişi yoksayma

Botunuzun kullanıcıdan giriş almaya hazır olmadığını belirtmek için, iletinizi temsil eden Activity nesnesi içinde özelliğini ignoringInput olarak ayarlayıninputHint. Bunu destekleyen kanallarda bu, istemcinin giriş kutusunun devre dışı bırakılmasına ve mikrofonunun kapatılmasına neden olur.

Aşağıdaki örnekte, bir ileti gönderen ve botunun girişi yoksaydığını belirten bir istek gösterilmektedir. Bu örnek istekte Direct Line temel URI'yi temsil eder; bot sorunlarınızın farklı olabileceği istekler için temel URI. 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": "Please hold while I perform the calculation.",
    "inputHint": "ignoringInput",
    "replyToId": "5d5cdc723"
}

Ek kaynaklar