Adicione dicas de entrada a mensagens com a API do Conector Bot
Ao especificar uma sugestão de entrada para uma mensagem, pode indicar se o seu bot está a aceitar, esperar ou ignorar a entrada do utilizador após a entrega da mensagem ao cliente. Para canais que suportam este campo, isto permite que os clientes desemodem o estado dos controlos de entrada do utilizador em conformidade. Por exemplo, se a indicação de entrada de uma mensagem indicar que o bot está a ignorar a entrada do utilizador, o cliente pode fechar o microfone e desativar a caixa de entrada para impedir que o utilizador forneça entrada.
Aceitação de entrada
Para indicar que o seu bot está passivamente pronto para entrada, mas não aguarda uma resposta do utilizador, defina a inputHint propriedade para aceitar o Input dentro do objeto De atividade que representa a sua mensagem. Em muitos canais, isto fará com que a caixa de entrada do cliente seja ativada e o microfone seja fechado, mas ainda acessível ao utilizador.
O exemplo a seguir mostra um pedido que envia uma mensagem e especifica que o bot está a aceitar a entrada. Neste pedido de exemplo, Direct Line representa a base URI; a base URI para pedidos de que os seus problemas de bot podem ser diferentes. Para mais informações sobre a definição do URI base, consulte referência da 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"
}
Esperando entrada
Para indicar que o seu bot está a aguardar ativamente uma resposta do utilizador, defina a inputHint propriedade para esperar a Participação dentro do objeto De atividade que representa a sua mensagem. Nos canais que o suportam, isto fará com que a caixa de entrada do cliente esteja ativada e o microfone esteja aberto.
O exemplo a seguir mostra um pedido que envia uma mensagem e especifica que o bot está à espera de entrada. Neste pedido de exemplo, Direct Line representa a base URI; a base URI para pedidos de que os seus problemas de bot podem ser diferentes. Para mais informações sobre a definição do URI base, consulte referência da 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"
}
Ignorando a entrada
Para indicar que o seu bot não está pronto para receber a entrada do utilizador, defina a inputHint propriedade para ignorar a Informação dentro do objeto De atividade que representa a sua mensagem. Nos canais que o suportam, isto fará com que a caixa de entrada do cliente seja desativada e o microfone seja fechado.
O exemplo a seguir mostra um pedido que envia uma mensagem e especifica que o bot está ignorando a entrada. Neste pedido de exemplo, Direct Line representa a base URI; a base URI para pedidos de que os seus problemas de bot podem ser diferentes. Para mais informações sobre a definição do URI base, consulte referência da 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"
}