Beviteli tippek hozzáadása üzenetekhez a Bot Connector API-val
Egy üzenet beviteli tippjének megadásával jelezheti, hogy a robot elfogadja, várja vagy figyelmen kívül hagyja-e a felhasználói bemenetet az üzenet ügyfélnek való elküldése után. A mezőt támogató csatornák esetében az ügyfelek ennek megfelelően állíthatják be a felhasználói beviteli vezérlők állapotát. Ha például egy üzenet beviteli tippje azt jelzi, hogy a robot figyelmen kívül hagyja a felhasználói bevitelt, az ügyfél bezárhatja a mikrofont, és letilthatja a beviteli mezőt, hogy megakadályozza a felhasználót a bemenet megadásában.
Bemenet elfogadása
Ha azt szeretné jelezni, hogy a robot passzívan készen áll a bemenetre, de nem vár választ a felhasználótól, állítsa a inputHint tulajdonságot acceptingInput értékre az üzenetét képviselő Tevékenység objektumon belül. Ez számos csatornán az ügyfél beviteli mezőjének engedélyezését és a mikrofon bezárását eredményezi, de továbbra is elérhető lesz a felhasználó számára.
Az alábbi példa egy üzenetet küldő kérést mutat be, és megadja, hogy a robot fogadja-e a bemenetet. Ebben a példában a Direct Line az alap URI-t jelöli; a robot problémáit okozó kérések alap URI-ja eltérő lehet. Az alap URI beállításával kapcsolatos részletekért lásd: API-referencia.
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"
}
Bemenetet vár
Ha azt szeretné jelezni, hogy a robot aktívan várja a felhasználó válaszát, állítsa a inputHint tulajdonságot a expectingInput értékre az üzenetet képviselő Tevékenység objektumon belül. Az azt támogató csatornákon ez az ügyfél beviteli mezőjének engedélyezését és a mikrofon megnyitását eredményezi.
Az alábbi példa egy üzenetet küldő kérést mutat be, és megadja, hogy a robot bemenetet vár. Ebben a példában a Direct Line az alap URI-t jelöli; a robot problémáit okozó kérések alap URI-ja eltérő lehet. Az alap URI beállításával kapcsolatos részletekért lásd: API-referencia.
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"
}
Bemenet figyelmen kívül hagyása
Ha azt szeretné jelezni, hogy a robot nem áll készen arra, hogy bemenetet fogadjon a felhasználótól, állítsa a inputHint tulajdonságot úgy, hogy figyelmen kívül hagyja az Input értéket az üzenetet képviselő Tevékenység objektumon belül. Az azt támogató csatornákon ez az ügyfél beviteli mezőjének letiltását és a mikrofon bezárását eredményezi.
Az alábbi példa egy üzenetet küldő kérést mutat be, és megadja, hogy a robot figyelmen kívül hagyja a bemenetet. Ebben a példában a Direct Line az alap URI-t jelöli; a robot problémáit okozó kérések alap URI-ja eltérő lehet. Az alap URI beállításával kapcsolatos részletekért lásd: API-referencia.
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"
}