채널 참조
적용 대상: SDK v4
이 문서에서는 다양한 Bot Framework 기능에 대한 채널 지원을 간략하게 설명합니다.
- 각 채널이 보내거나 받을 수 있는 활동 유형입니다.
- 적응형 카드를 포함하여 각 채널에 표시할 수 있는 카드 유형입니다.
- 카드 작업 및 각 채널에서 제안된 작업 지원.
- 다양한 활동 형식의 일반 분류입니다.
프로토콜 수준의 활동 및 카드 구조에 대한 자세한 내용은 Bot Framework 활동 및 카드 스키마를 참조하세요.
적응형 카드는 별도의 기술입니다. 자세한 내용은 adaptivecards.io 참조하세요.
채널별 활동 지원
다음 표에서는 지정된 채널이 지정된 활동 유형을 봇에 보낼 수 있는지 여부를 나타냅니다. 표 내에서 다음 용어는 다음과 같은 의미를 갖습니다.
| 용어 | 의미 |
|---|---|
| 예 | 봇은 채널에서 이 활동을 받을 수 있습니다. |
| 아니요 | 봇은 채널에서 이 활동을 받을 수 없습니다. |
| 결정되지 않음 | 현재 결정되지 않았습니다. |
| 채널 | 연락처 관계 업데이트 | 대화 업데이트 | 대화 종료 | 이벤트 | 설치 업데이트 | Invoke | 메시지 | 메시지 반응 | 메시지 업데이트 | 메시지 삭제 | 입력 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Alexa | 아니요 | 아니요 | 예 | 예 | 아니요 | 아니요 | 예 | 아니요 | 아니요 | 아니요 | 아니요 |
| Azure Communication Services | 예 | 예 | 아니요 | 예 | 아니요 | 아니요 | 예 | 아니요 | 예 | 예 | 예 |
| 직접 회선 | 예 | 예 | 예 | 예 | 예 | 아니요 | 예 | 아니요 | 아니요 | 아니요 | 예 |
| Direct Line Speech | 예 | ||||||||||
| 전자 메일 | 아니요 | 아니요 | 아니요 | 결정되지 않음 | 아니요 | 아니요 | 예 | 아니요 | 아니요 | 아니요 | 아니요 |
| 예 | 예 | 아니요 | 예 | 아니요 | 아니요 | 예 | 예 | 아니요 | 아니요 | 아니요 | |
| GroupMe | 예 | 예 | 아니요 | 결정되지 않음 | 아니요 | 아니요 | 예 | 아니요 | 아니요 | 아니요 | 아니요 |
| LINE | 예 | 예 | 아니요 | 예 | 아니요 | 아니요 | 예 | 아니요 | 아니요 | 아니요 | 아니요 |
| Microsoft 팀 | 예 | 예 | 아니요 | 결정되지 않음 | 예 | 예 | 예 | 예 | 예 | 예 | 아니요 |
| Omnichannel | 예 | ||||||||||
| Outlook(미리 보기) | 예 | ||||||||||
| 검색(미리 보기) | 예 | ||||||||||
| Slack | 예 | 예 | 아니요 | 결정되지 않음 | 아니요 | 아니요 | 예 | 아니요 | 예 | 예 | 아니요 |
| Telegram | 예 | 예 | 아니요 | 결정되지 않음 | 아니요 | 아니요 | 예 | 아니요 | 예 | 결정되지 않음 | 아니요 |
| Twilio(SMS) | 아니요 | 아니요 | 아니요 | 결정되지 않음 | 아니요 | 아니요 | 예 | 아니요 | 아니요 | 아니요 | 아니요 |
| 웹 채팅 | 예 | 예 | 예 | 예 | 예 | 아니요 | 예 | 아니요 | 아니요 | 아니요 | 예 |
event 지원 및 invoke 활동은 활동의 이름에 따라 다르며 채널에 따라 다릅니다.
카드 채널 지원
다음 표에서는 지정된 채널이 지정된 카드 유형을 렌더링할 수 있는지 여부를 나타냅니다. 채널이 카드 유형을 렌더링할 수 있더라도 채널은 카드의 모든 기능을 지원하지 않을 수 있습니다. 봇을 릴리스하기 전에 봇이 보낼 수 있는 각 카드의 동작을 테스트합니다.
표 내에서 다음 용어는 다음과 같은 의미를 갖습니다.
| 용어 | 의미 |
|---|---|
| 예 | 카드는 이 채널에서 지원됩니다. 그러나 지정된 채널은 카드 작업의 하위 집합만 지원하거나 각 카드에 허용되는 작업 수를 제한할 수 있습니다. |
| 아니요 | 카드는 이 채널에서 지원되지 않습니다. |
| 부분 | 일부 지원. 카드에 입력 또는 단추가 포함된 경우 이 채널에 카드가 표시되지 않을 수 있습니다. 지원 수준은 채널에 따라 다릅니다. |
| 이미지 | 카드가 이미지로 변환됩니다. |
| Text | 카드가 서식 없는 텍스트로 변환됩니다. 링크를 클릭할 수 없으며, 이미지가 표시되지 않을 수 있으며, 미디어를 재생할 수 없습니다. 지원 수준은 채널에 따라 다릅니다. |
| 채널 | 적응형 카드 | 애니메이션 카드 | 오디오 카드 | 영웅 카드 | 수신 확인 카드 | 로그인 카드 | 썸네일 카드 | 비디오 카드 |
|---|---|---|---|---|---|---|---|---|
| Alexa | 아니요 | 아니요 | 아니요 | 예 | 아니요 | 예 | 아니요 | 아니요 |
| Azure Communication Services | 예* | 예 | 예 | 예 | 예 | 예 | 예 | 예 |
| 전자 메일 | 이미지 | Text | Text | 예 | 예 | 예 | 예 | Text |
| 이미지, 부분 | 예 | 예 | 예 | 예 | 예 | 예 | 예 | |
| GroupMe | 이미지 | Text | Text | Text | Text | Text | Text | Text |
| LINE | 이미지, 부분 | 예 | Text | 예 | 예 | 예 | 예 | Text |
| Microsoft 팀 | 예 | 아니요 | 아니요 | 예 | 예 | 예 | 예 | 아니요 |
| Omnichannel | ||||||||
| Outlook(미리 보기) | ||||||||
| 검색(미리 보기) | ||||||||
| Slack | Image | 예 | Text | Text | 예 | 예 | Text | Text |
| Telegram | 이미지, 부분 | 예 | Text | 예 | 예 | 예 | 예 | 예 |
| Twilio(SMS) | 이미지 | Text | 아니요 | Text | Text | Text | Text | 아니요 |
| 웹 채팅 | 네 | 예 | 예 | 예 | 예 | 예 | 예 | 예 |
참고 항목
- Direct Line 채널은 기술적으로 모든 카드를 지원하지만 이를 구현하는 것은 클라이언트의 맡입니다.
- *Azure Communication Services 채팅의 경우 적응형 카드는 Azure Communication Services 사용 사례 내에서만 지원되며, Azure Communication Services에서 Teams로의 사용 사례에는 지원되지 않습니다.
채널별 카드 작업 지원
다음 표에서는 지정된 채널에서 지원하는 제안된 작업 및 카드 작업의 최대 수를 보여 줍니다. 값 "None"은 작업 유형이 채널에서 지원되지 않음을 나타냅니다.
| 채널 | 제안 작업 | 카드 작업 |
|---|---|---|
| Alexa | None | None |
| Azure Communication Services | ||
| 직접 회선 | 100 | 100 |
| Direct Line Speech | 100 | 100 |
| 전자 메일 | None | None |
| 11 | 3 | |
| GroupMe | None | None |
| LINE | 13 | 99 |
| Microsoft 팀 | None | 3 |
| Omnichannel | ||
| Outlook(미리 보기) | ||
| 검색(미리 보기) | ||
| Slack | None | 100 |
| Telegram | 100 | 100 |
| Twilio(SMS) | None | None |
| 웹 채팅 | 100 | 100 |
- 카드 작업에 대한 자세한 내용은 메시지에 미디어 추가 문서의 서식 있는 카드 내 이벤트 처리를 참조하세요.
- 제안된 작업에 대한 자세한 내용은 입력에 단추를 사용하는 방법을 참조하세요.
활동 범주
활동을 별도의 범주로 분할할 수 있습니다. 각 활동 유형 및 각 활동 유형에 포함된 정보에 대한 자세한 설명은 Bot Framework 활동 스키마를 참조하세요.
환영합니다
이 범주에는 conversationUpdate 활동 및 contactRelationUpdate 활동이 포함됩니다.
- 많은 채널에서 대화 업데이트 활동을 보냅니다.
- 봇 시작 동작은 종종 대화 업데이트 활동에 의해 트리거됩니다. 그러나 신뢰할 수 있는 환영 동작을 생성하려면 대화 또는 사용자 상태를 사용해야 할 수 있습니다.
- 일부 채널은 연락처 관계 업데이트 활동을 보냅니다.
- 봇이 이러한 채널을 사용하는 경우 봇의 시작 동작에 이 활동에 대한 논리를 포함해야 할 수 있습니다.
대화형
이 범주에는 message, messageReaction및 endOfConversation 활동이 포함됩니다.
- 모든 채널은 메시지 활동을 보내고 받을 수 있습니다.
- 대화 상자를 사용하는 봇의 경우 일반적으로 메시지 활동이 대화 상자에 전달되어야 합니다.
- 일부 채널은 메시지 반응 활동을 보내고 받을 수 있습니다.
- 봇의 디자인에 따라 메시지 반응 활동을 대화 상자에 전달할 수 있습니다.
- 메시지 반응 활동은 ID별로 이전 메시지를 참조합니다.
- 대화 종료 활동은 보낸 사람의 관점에서 대화가 종료되었음을 나타냅니다.
- 대화 종료 활동은 기술을 위한 봇 간 통신에 사용됩니다.
팁
메시지 반응에는 이전 메모에 대한 엄지손가락과 같은 항목이 포함됩니다. 순서대로 발생할 수 있으므로 단추와 비슷하다고 생각할 수 있습니다. 이 활동 유형은 Teams 채널에서 보낼 수 있습니다.
메시지 업데이트 및 삭제
이 범주에는 messageUpdate 활동 및 messageDelete 활동이 포함됩니다.
- Teams는 메시지 업데이트 및 삭제 활동을 지원합니다.
애플리케이션 확장성
이 범주에는 event 활동 및 invoke 활동이 포함됩니다.
활동의 의미는 채널 범위 내에서 의미 있는 해당 name 필드에 의해 정의됩니다.
- 클라이언트와 서버를 모두 소유하는 애플리케이션은 이벤트 활동을 사용하여 클라이언트와 서버 간에 프로그래밍 방식 정보를 전달할 수 있습니다.
- 대부분의 활동 유형과 같은 이벤트 활동은 비동기적입니다.
- 직접 회선 및 웹 채팅 확장성 메커니즘으로 이벤트 활동을 사용합니다.
- 호출 작업은 클라이언트가 정의할 수 있는 것이 아니라 애플리케이션에만 적용됩니다.
- 다른 작업 유형과 달리 호출 활동은 동기적입니다. (Invoke는 현재 봇에서 요청-회신 동작을 트리거하는 유일한 활동 유형입니다.)
- Microsoft Teams는 호출 활동을 사용하고 몇 가지 Teams별 호출 활동을 정의합니다.
인증
OAuth 프롬프트에서 대화 TeamsVerification 상자를 사용하려면 호출 작업을 대화 상자로 전달해야 합니다.
범주화되지 않음
, typing및 handoff 활동은 installationUpdate다른 범주에 의미 있는 것은 아닙니다.
- 설치 업데이트 작업은 채널의 조직 구성 단위 내에서 봇의 설치 또는 제거를 나타냅니다.
- 입력 활동은 사용자 또는 봇의 지속적인 입력을 나타냅니다.
- 핸드오프 활동은 봇 내 요소 간의 포커스 변경을 요청하거나 신호를 전송합니다. 핸드오프 활동은 이름이 "handoff"인 이벤트 활동과 다릅니다.
사용 불가(결제 관련 호출 포함)
이러한 활동 형식은 더 이상 사용되지 않습니다.
deleteUserDatahandoffpingAddress호출PaymentRequest호출
추가 정보
모든 채널은 활동을 보내고 받을 message 수 있습니다.
팁
봇에 채널에 대한 지원을 추가할 때 채널의 개발자 문서를 숙지합니다. 각 채널에는 대화의 다양한 측면에 대해 서로 다른 제한 사항이 있습니다. 몇 가지 차이점은 다음과 같습니다.
- 봇이 각 HTTP 요청을 처리해야 하는 시간입니다.
- 봇이 특정 사용자 활동에 대한 응답이 아닌 활동을 보낼 수 있는지 여부입니다.
- 봇이 지정된 시간 프레임 내에 보낼 수 있는 메시지 수입니다.
- 카드 렌더링 방법 및 지원되는 카드