Conversations 인터페이스
public interface Conversations
이 클래스의 인스턴스는 대화에 정의된 모든 작업에 대한 액세스를 제공합니다.
메서드 요약
| 한정자 및 형식 | 메서드 및 설명 |
|---|---|
|
abstract
java.util.concurrent.CompletableFuture<Conversation |
createConversation(ConversationParameters parameters)
|
| abstract java.util.concurrent.CompletableFuture<java.lang.Void> |
deleteActivity(String conversationId, String activityId)
|
| abstract java.util.concurrent.CompletableFuture<java.lang.Void> |
deleteConversationMember(String conversationId, String memberId)
|
|
abstract
java.util.concurrent.CompletableFuture<java.util.List<Channel |
getActivityMembers(String conversationId, String activityId)
|
|
abstract
java.util.concurrent.CompletableFuture<Channel |
getConversationMember(String userId, String conversationId)
ID로 대화의 단일 멤버를 검색합니다. |
|
abstract
java.util.concurrent.CompletableFuture<java.util.List<Channel |
getConversationMembers(String conversationId)
|
|
abstract
java.util.concurrent.CompletableFuture<Paged |
getConversationPagedMembers(String conversationId)
대화의 멤버를 한 번에 한 페이지씩 열거합니다. |
|
abstract
java.util.concurrent.CompletableFuture<Paged |
getConversationPagedMembers(String conversationId, String continuationToken)
대화의 멤버를 한 번에 한 페이지씩 열거합니다. |
|
abstract
java.util.concurrent.CompletableFuture<Conversations |
getConversations()
|
|
abstract
java.util.concurrent.CompletableFuture<Conversations |
getConversations(String continuationToken)
|
|
default
java.util.concurrent.CompletableFuture<Resource |
replyToActivity(Activity activity)
|
|
abstract
java.util.concurrent.CompletableFuture<Resource |
replyToActivity(String conversationId, String activityId, Activity activity)
|
|
abstract
java.util.concurrent.CompletableFuture<Resource |
sendConversationHistory(String conversationId, Transcript history)
이 메서드를 사용하면 대화에 기록 활동을 업로드할 수 있습니다. |
|
default
java.util.concurrent.CompletableFuture<Resource |
sendToConversation(Activity activity)
|
|
abstract
java.util.concurrent.CompletableFuture<Resource |
sendToConversation(String conversationId, Activity activity)
|
|
default
java.util.concurrent.CompletableFuture<Resource |
updateActivity(Activity activity)
|
|
abstract
java.util.concurrent.CompletableFuture<Resource |
updateActivity(String conversationId, String activityId, Activity activity)
|
|
abstract
java.util.concurrent.CompletableFuture<Resource |
uploadAttachment(String conversationId, AttachmentData attachmentUpload)
|
메서드 세부 정보
createConversation
public abstract CompletableFuture
CreateConversation. 새 대화를 만듭니다. 직접 메시지(기본값은 false)가 아니면 봇이 대화를 만드는 봇이 true로 설정된 상태에서 이 메서드에 POST를 게시하면 대화에 포함하려는 멤버가 연결됩니다. 반환 값은 메시지 페이로드 및 REST API URI에 사용하기에 적합한 대화 ID를 포함하는 ResourceResponse입니다. 대부분의 채널은 직접 메시지 대화를 시작하는 봇의 의미 체계만 지원합니다. 이 작업을 수행하는 방법의 예는 다음과 같습니다. ''' var resource = await connector.conversation.CreateConversation(new ConversationParameters(){ Bot = bot, members = new ChannelAccount[] { new ChannelAccount("user1") } ); await connect. Conversations.SendToConversation(resource. ID, 새 활동() ... ) ; ```
매개 변수:
반환:
deleteActivity
public abstract CompletableFuture
DeleteActivity. 기존 활동을 삭제합니다. 일부 채널을 사용하면 기존 활동을 삭제할 수 있으며, 성공하면 이 메서드가 지정된 활동을 제거합니다.
매개 변수:
반환:
deleteConversationMember
public abstract CompletableFuture
DeleteConversationMember. 대화에서 멤버를 삭제합니다. 이 REST API는 ConversationId 및 memberId(문자열 형식)를 사용하고 대화에서 해당 멤버를 제거합니다. 해당 멤버가 대화의 마지막 멤버인 경우 대화도 삭제됩니다.
매개 변수:
반환:
getActivityMembers
public abstract CompletableFuture
GetActivityMembers. 활동의 멤버를 열거합니다. 이 REST API는 ConversationId 및 ActivityId를 사용하여 대화에서 특정 활동의 멤버를 나타내는 ChannelAccount 개체의 배열을 반환합니다.
매개 변수:
반환:
getConversationMember
public abstract CompletableFuture
ID로 대화의 단일 멤버를 검색합니다.
매개 변수:
반환:
getConversationMembers
public abstract CompletableFuture
GetConversationMembers. 대화의 멤버를 열거합니다. 이 REST API는 ConversationId를 사용하고 대화의 멤버를 나타내는 ChannelAccount 개체의 배열을 반환합니다.
매개 변수:
반환:
getConversationPagedMembers
public abstract CompletableFuture
대화의 멤버를 한 번에 한 페이지씩 열거합니다. 이 REST API는 ConversationId를 사용합니다. 필요에 따라 pageSize 및/또는 continuationToken을 제공할 수 있습니다. 대화의 멤버를 나타내는 ChannelAccounts 배열과 더 많은 값을 가져오는 데 사용할 수 있는 연속 토큰이 포함된 PagedMembersResult를 반환합니다. 각 호출과 함께 ChannelAccounts 레코드의 한 페이지가 반환됩니다. 페이지의 레코드 수는 채널과 호출에 따라 달라질 수 있습니다. 추가 결과가 없으면 응답에 연속 토큰이 포함되지 않습니다. 대화에 멤버가 없으면 멤버가 비어 있거나 응답에 표시되지 않습니다. 이전 요청의 연속 토큰이 있는 요청에 대한 응답은 이전 요청의 멤버를 거의 반환하지 않을 수 있습니다.
매개 변수:
반환:
getConversationPagedMembers
public abstract CompletableFuture
대화의 멤버를 한 번에 한 페이지씩 열거합니다. 이 REST API는 ConversationId를 사용합니다. 필요에 따라 pageSize 및/또는 continuationToken을 제공할 수 있습니다. 대화의 멤버를 나타내는 ChannelAccounts 배열과 더 많은 값을 가져오는 데 사용할 수 있는 연속 토큰이 포함된 PagedMembersResult를 반환합니다. 각 호출과 함께 ChannelAccounts 레코드의 한 페이지가 반환됩니다. 페이지의 레코드 수는 채널과 호출에 따라 달라질 수 있습니다. 추가 결과가 없으면 응답에 연속 토큰이 포함되지 않습니다. 대화에 멤버가 없으면 멤버가 비어 있거나 응답에 표시되지 않습니다. 이전 요청의 연속 토큰이 있는 요청에 대한 응답은 이전 요청의 멤버를 거의 반환하지 않을 수 있습니다.
매개 변수:
반환:
getConversations
public abstract CompletableFuture
GetConversations. 이 봇이 참여한 대화를 나열합니다. 건너뛰기 토큰이 있는 이 메서드에서 가져오기 반환 값은 ConversationMembers 배열과 건너뛰기 토큰을 포함하는 ConversationResult입니다. 건너뛰기 토큰이 비어 있지 않으면 반환할 추가 값이 있습니다. 반환된 토큰을 사용하여 이 메서드를 다시 호출하여 더 많은 값을 가져옵니다. 각 ConversationMembers 개체에는 대화의 ID와 대화의 멤버를 설명하는 ChannelAccounts 배열이 포함됩니다.
반환:
getConversations
public abstract CompletableFuture
GetConversations. 이 봇이 참여한 대화를 나열합니다. 건너뛰기 토큰이 있는 이 메서드에서 가져오기 반환 값은 ConversationMembers 배열과 건너뛰기 토큰을 포함하는 ConversationResult입니다. 건너뛰기 토큰이 비어 있지 않으면 반환할 추가 값이 있습니다. 반환된 토큰을 사용하여 이 메서드를 다시 호출하여 더 많은 값을 가져옵니다. 각 ConversationMembers 개체에는 대화의 ID와 대화의 멤버를 설명하는 ChannelAccounts 배열이 포함됩니다.
매개 변수:
반환:
replyToActivity
public default CompletableFuture
ReplyToActivity. 이 메서드를 사용하면 활동에 회신할 수 있습니다. SendToConversation()과 약간 다릅니다. SendToConversation(conversationId) - 채널의 타임스탬프 또는 의미 체계에 따라 대화 끝에 활동을 추가합니다. ReplyToActivity(conversationId,ActivityId) - 채널이 지원하는 경우 활동을 다른 활동에 대한 회신으로 추가합니다. 채널이 중첩된 회신을 지원하지 않는 경우 ReplyToActivity는 SendToConversation으로 돌아갑니다. 대화의 특정 활동에 회신할 때 ReplyToActivity를 사용합니다. 다른 모든 경우에 SendToConversation을 사용합니다.
매개 변수:
반환:
replyToActivity
public abstract CompletableFuture
ReplyToActivity. 이 메서드를 사용하면 활동에 회신할 수 있습니다. SendToConversation()과 약간 다릅니다. SendToConversation(conversationId) - 채널의 타임스탬프 또는 의미 체계에 따라 대화 끝에 활동을 추가합니다. ReplyToActivity(conversationId,ActivityId) - 채널이 지원하는 경우 활동을 다른 활동에 대한 회신으로 추가합니다. 채널이 중첩된 회신을 지원하지 않는 경우 ReplyToActivity는 SendToConversation으로 돌아갑니다. 대화의 특정 활동에 회신할 때 ReplyToActivity를 사용합니다. 다른 모든 경우에 SendToConversation을 사용합니다.
매개 변수:
반환:
sendConversationHistory
public abstract CompletableFuture
이 메서드를 사용하면 대화에 기록 활동을 업로드할 수 있습니다. 보낸 사람은 기록 활동에 고유한 ID와 적절한 타임스탬프가 있는지 확인해야 합니다. ID는 클라이언트에서 중복 작업을 처리하는 데 사용되며 타임스탬프는 클라이언트가 작업을 올바른 순서로 렌더링하는 데 사용됩니다.
매개 변수:
반환:
sendToConversation
public default CompletableFuture
SendToConversation. 이 메서드를 사용하면 대화가 끝날 때까지 활동을 보낼 수 있습니다. ReplyToActivity()와 약간 다릅니다. sendToConverstion(activity) - 대화 ID에 Activity.getConversation.getId를 사용하여 채널의 타임스탬프 또는 의미 체계에 따라 대화 끝에 활동을 추가합니다. replyToActivity(conversationId,ActivityId) - 채널이 지원하는 경우 다른 활동에 회신으로 활동을 추가합니다. 채널이 중첩된 회신을 지원하지 않는 경우 ReplyToActivity는 SendToConversation으로 돌아갑니다. 대화의 특정 활동에 회신할 때 ReplyToActivity를 사용합니다. 다른 모든 경우에 SendToConversation을 사용합니다.
매개 변수:
반환:
sendToConversation
public abstract CompletableFuture
SendToConversation. 이 메서드를 사용하면 대화가 끝날 때까지 활동을 보낼 수 있습니다. ReplyToActivity()와 약간 다릅니다. SendToConverstion(conversationId) - 채널의 타임스탬프 또는 의미 체계에 따라 대화 끝에 활동을 추가합니다. ReplyToActivity(conversationId,ActivityId) - 채널이 지원하는 경우 활동을 다른 활동에 대한 회신으로 추가합니다. 채널이 중첩된 회신을 지원하지 않는 경우 ReplyToActivity는 SendToConversation으로 돌아갑니다. 대화의 특정 활동에 회신할 때 ReplyToActivity를 사용합니다. 다른 모든 경우에 SendToConversation을 사용합니다.
매개 변수:
반환:
updateActivity
public default CompletableFuture
UpdateActivity. 기존 활동을 편집합니다. 일부 채널을 사용하면 기존 활동을 편집하여 봇 대화의 새 상태를 반영할 수 있습니다. 예를 들어 누군가가 "승인" 단추를 클릭한 후 단추를 제거할 수 있습니다.
매개 변수:
반환:
updateActivity
public abstract CompletableFuture
UpdateActivity. 기존 활동을 편집합니다. 일부 채널을 사용하면 기존 활동을 편집하여 봇 대화의 새 상태를 반영할 수 있습니다. 예를 들어 누군가가 "승인" 단추를 클릭한 후 단추를 제거할 수 있습니다.
매개 변수:
반환:
uploadAttachment
public abstract CompletableFuture
UploadAttachment. 채널의 Blob Storage에 직접 첨부 파일을 업로드합니다. 이는 엔터프라이즈를 처리할 때 규격 저장소에 데이터를 저장할 수 있기 때문에 유용합니다. 응답은 첨부 파일 API와 함께 사용하기에 적합한 AttachmentId를 포함하는 ResourceResponse입니다.
매개 변수:
반환: