Přidání vstupních tipů ke zprávám pomocí rozhraní API konektoru robota
Zadáním nápovědy pro zadání zprávy můžete označit, jestli robot přijímá, očekává nebo ignoruje vstup uživatele po doručení zprávy klientovi. U kanálů, které podporují toto pole, to klientům umožňuje odpovídajícím způsobem nastavit stav ovládacích prvků uživatelských vstupů. Pokud například vstupní nápověda zprávy značí, že robot ignoruje vstup uživatele, klient může zavřít mikrofon a zakázat vstupní pole, aby uživatel nemohl zadat vstup.
Příjem vstupu
Pokud chcete označit, že je robot pasivně připravený na vstup, ale nečeká na odpověď od uživatele, nastavte inputHint vlastnost na acceptingInput v objektu Activity , který představuje vaši zprávu. V mnoha kanálech to způsobí povolení vstupního pole klienta a zavření mikrofonu, ale stále přístupné pro uživatele.
Následující příklad ukazuje požadavek, který odešle zprávu a určuje, že robot přijímá vstup. V tomto příkladu požadavku Direct Line představuje základní identifikátor URI; základní identifikátor URI pro požadavky, které se můžou lišit problémy s robotem. Podrobnosti o nastavení základního identifikátoru URI najdete v referenčních informacích k rozhraní 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": "Here's a picture of the house I was telling you about.",
"inputHint": "acceptingInput",
"replyToId": "5d5cdc723"
}
Očekávání vstupu
Pokud chcete označit, že robot aktivně čeká na odpověď od uživatele, nastavte inputHint vlastnost na expectingInput v objektu Activity , který představuje vaši zprávu. U kanálů, které ho podporují, to způsobí, že se povolí vstupní pole klienta a otevře se mikrofon.
Následující příklad ukazuje požadavek, který odešle zprávu a určuje, že robot očekává vstup. V tomto příkladu požadavku Direct Line představuje základní identifikátor URI; základní identifikátor URI pro požadavky, které se můžou lišit problémy s robotem. Podrobnosti o nastavení základního identifikátoru URI najdete v referenčních informacích k rozhraní 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": "What is your favorite color?",
"inputHint": "expectingInput",
"replyToId": "5d5cdc723"
}
Ignorování vstupu
Pokud chcete označit, že robot není připravený přijímat vstup od uživatele, nastavte inputHint vlastnost na ignorováníInput v objektu Activity , který představuje vaši zprávu. U kanálů, které ho podporují, to způsobí zakázání vstupního pole klienta a zavření mikrofonu.
Následující příklad ukazuje požadavek, který odešle zprávu a určuje, že robot ignoruje vstup. V tomto příkladu požadavku Direct Line představuje základní identifikátor URI; základní identifikátor URI pro požadavky, které se můžou lišit problémy s robotem. Podrobnosti o nastavení základního identifikátoru URI najdete v referenčních informacích k rozhraní 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": "Please hold while I perform the calculation.",
"inputHint": "ignoringInput",
"replyToId": "5d5cdc723"
}