Bot Connector API를 사용하여 메시지에 입력 힌트 추가
메시지에 대한 입력 힌트를 지정하여 메시지를 클라이언트에 전달한 후 봇이 사용자 입력을 허용, 필요 또는 무시하는지 여부를 나타낼 수 있습니다. 이 필드를 지원하는 채널의 경우 이를 통해 클라이언트에서 가 사용자 입력 컨트롤의 상태를 적절하게 설정할 수 있습니다. 예를 들어 메시지의 입력 힌트가 봇이 사용자 입력을 무시하고 있는 것으로 표시하면 클라이언트는 마이크를 닫고 사용자가 입력을 제공하지 못하도록 입력 상자를 비활성화할 수 있습니다.
입력 허용
봇이 수동적으로 입력할 준비가 되었지만 사용자의 응답을 기다리고 있지 않음을 나타내려면 메시지를 나타내는 Activity 개체 내에서 속성을 acceptingInput으로 설정합니다inputHint. 많은 채널에서 이렇게 하면 클라이언트의 입력 상자가 활성화되고 마이크는 닫히지만 사용자는 계속 액세스할 수 있습니다.
다음은 메시지를 보내고 봇이 입력을 받아들이도록 지정하는 요청을 보여주는 예제입니다. 이 예제 요청에서 Direct Line은 기본 URI를 나타냅니다. 봇에서 실행하는 요청에 대한 기본 URI는 다를 수 있습니다. 기본 URI를 설정하는 방법에 대한 자세한 내용은 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"
}
입력 필요
봇에서 사용자의 응답을 적극적으로 기다리고 있음을 나타내려면 메시지를 나타내는 Activity 개체 내에서 inputHint 속성을 expectingInput으로 설정합니다. 이를 지원하는 채널에서 이렇게 하면 클라이언트의 입력 상자를 사용하도록 설정되고 마이크가 열립니다.
다음은 메시지를 보내고 봇이 입력을 기다리도록 지정하는 요청을 보여주는 예제입니다. 이 예제 요청에서 Direct Line은 기본 URI를 나타냅니다. 봇에서 실행하는 요청에 대한 기본 URI는 다를 수 있습니다. 기본 URI를 설정하는 방법에 대한 자세한 내용은 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"
}
입력 무시
봇이 사용자로부터 입력을 받을 준비가 되지 않았음을 나타내려면 메시지를 나타내는 Activity 개체 내에서 속성을 ignoringInput으로 설정합니다inputHint. 이를 지원하는 채널에서 이렇게 하면 클라이언트의 입력 상자를 사용하지 않도록 설정되고 마이크가 닫힙니다.
다음은 메시지를 보내고 봇이 입력을 무시하도록 지정하는 요청을 보여주는 예제입니다. 이 예제 요청에서 Direct Line은 기본 URI를 나타냅니다. 봇에서 실행하는 요청에 대한 기본 URI는 다를 수 있습니다. 기본 URI를 설정하는 방법에 대한 자세한 내용은 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"
}