IMessage interface
사용자와 봇 간에 전송된 채팅 메시지입니다. 봇에서 사용자로 보내는 메시지는 다음 두 가지 버전으로 제공됩니다.
- 사후 메시지 사용자의 들어오는 메시지에 대한 회신으로 봇에서 사용자에게 보낸 메시지입니다.
-
자동 관리 메시지는 경보 트리거와 같은 일부 외부 이벤트에 대한 응답으로 봇에서 사용자에게 보내는 메시지입니다.
반응적 경우 들어오는 메시지에서 보내는 메시지로 주소 필드를 복사해야 합니다(Message 작성기 클래스를 사용하고 세션으로 초기화하면 자동으로) 텍스트 설정하거나 첨부 파일을 . 자동 관리 메시지의 경우 들어오는 메시지의 주소 외부 스토리지에 저장해야 합니다. 그런 다음 나중에 UniversalBot.beginDialog() 전달하거나 UniversalBot.send()전달된 보내는 메시지에 복사할 수 있습니다.
들어오는 주소 개체를 사용하여 사용자에게 메시지를 작성하면 기본적으로 현재 대화의 컨텍스트에서 사용자에게 회신을 보냅니다. 일부 채널에서는 사용자와 새 대화를 시작할 수 있습니다. 사용자와 새 자동 관리 대화를 시작하려면 보내는 메시지를 작성하기 전에 주소 개체에서 대화 필드를 삭제하기만 하면됩니다.
- Extends
속성
| address | 이벤트에 대한 주소 라우팅 정보입니다. 나중에 사용자에게 자동 관리 메시지를 작성하려면 이 필드를 외부 스토리지에 저장합니다. |
| agent | 이벤트를 처리하는 SDK입니다. 항상 'botbuilder'가 됩니다. |
| attachment |
클라이언트가 여러 첨부 파일을 레이아웃하는 방법에 대한 힌트입니다. 기본값은 'list'입니다. |
| attachments | 들어오는 메시지에는 사용자가 보낸 이미지와 같은 첨부 파일이 포함됩니다. 보내는 메시지에는 사용자에게 보낼 카드 또는 이미지와 같은 개체가 포함됩니다. |
| code | 대화가 종료된 이유를 나타내는 코드입니다. |
| delivery |
받는 사람에게 활동의 대체 배달 경로를 알리는 배달 힌트입니다. 기본 배달 모드는 "기본값"입니다. |
| entities | 구조화된 개체가 봇 또는 사용자에게 전달됩니다. |
| expriation | 활동을 "만료됨"으로 간주하고 받는 사람에게 표시해서는 안 되는 시간입니다. |
| importance | 활동의 중요도입니다. |
| input |
봇이 추가 입력을 기대하는지 여부를 알려주는 클라이언트에 대한 힌트입니다. 기본 제공 프롬프트는 나가는 메시지에 대해 이 값을 자동으로 채웁니다. |
| label | 활동에 대한 설명이 포함된 레이블입니다. |
| listen |
음성 및 언어 초기화 시스템에서 수신해야 하는 구 및 참조 목록입니다. |
| local |
메시지가 전송된 현지 시간(클라이언트 또는 봇에서 설정됨, 예: 2016-09-23T13:07:49.4714686-07:00). |
| local |
메시지가 현지 시간으로 IANA 표준 시간대 데이터베이스 형식으로 표현되는 표준 시간대의 이름을 포함합니다. 예를 들어 미국/Los_Angeles. |
| name | 호출할 작업의 이름 또는 이벤트의 이름입니다. |
| relates |
다른 대화 또는 메시지에 대한 참조입니다. |
| reply |
이 업데이트와 관련된 이벤트의 ID입니다. |
| semantic |
이 요청과 함께 제공되는 선택적 프로그래밍 작업입니다. |
| source | 이벤트의 원래 원본(예: 'facebook', 'skype', 'slack' 등) |
| source |
원본 네이티브 스키마의 원래 이벤트입니다. 보내는 메시지의 경우 사용자 지정 첨부 파일과 같은 원본 특정 이벤트 데이터를 전달하는 데 사용할 수 있습니다. |
| speak | 음성 메시지를 Speech Synthesis Markup Language. |
| summary | 최근 대화 목록과 같은 메시지 콘텐츠에 대한 간단한 설명과 대체 항목으로 표시할 텍스트입니다. |
| text | 메시지 텍스트입니다. |
| text |
텍스트 필드의 형식입니다. 기본값은 'markdown'입니다. |
| text |
작업에 ReplyToId 값이 포함될 때 강조 표시할 텍스트 조각의 컬렉션입니다. |
| text |
알려진 경우 메시지 텍스트의 식별된 언어입니다. |
| timestamp | 메시지가 전송된 UTC 시간(서비스별 설정) |
| type | 이벤트 유형을 정의합니다. IMessage에 대한 '메시지'여야 합니다. |
| user | 들어오는 메시지의 경우 메시지를 보낸 사용자입니다. 기본적으로 address.user 복사본이지만 들어오는 사용자를 내부 사용자 ID에 매핑할 수 있는 lookupUser 함수를 사용하여 봇을 구성할 수 있습니다. |
| value | 개방형 값입니다. |
| value |
활동 값 개체의 형식입니다. |
속성 세부 정보
address
이벤트에 대한 주소 라우팅 정보입니다. 나중에 사용자에게 자동 관리 메시지를 작성하려면 이 필드를 외부 스토리지에 저장합니다.
address: IAddress
속성 값
agent
이벤트를 처리하는 SDK입니다. 항상 'botbuilder'가 됩니다.
agent: string
속성 값
string
attachmentLayout
클라이언트가 여러 첨부 파일을 레이아웃하는 방법에 대한 힌트입니다. 기본값은 'list'입니다.
attachmentLayout?: string
속성 값
string
attachments
들어오는 메시지에는 사용자가 보낸 이미지와 같은 첨부 파일이 포함됩니다. 보내는 메시지에는 사용자에게 보낼 카드 또는 이미지와 같은 개체가 포함됩니다.
attachments?: IAttachment[]
속성 값
code
대화가 종료된 이유를 나타내는 코드입니다.
code?: string
속성 값
string
deliveryMode
받는 사람에게 활동의 대체 배달 경로를 알리는 배달 힌트입니다. 기본 배달 모드는 "기본값"입니다.
deliveryMode?: string
속성 값
string
entities
구조화된 개체가 봇 또는 사용자에게 전달됩니다.
entities?: any[]
속성 값
any[]
expriation
활동을 "만료됨"으로 간주하고 받는 사람에게 표시해서는 안 되는 시간입니다.
expriation?: string
속성 값
string
importance
활동의 중요도입니다.
importance?: string
속성 값
string
inputHint
봇이 추가 입력을 기대하는지 여부를 알려주는 클라이언트에 대한 힌트입니다. 기본 제공 프롬프트는 나가는 메시지에 대해 이 값을 자동으로 채웁니다.
inputHint?: string
속성 값
string
label
활동에 대한 설명이 포함된 레이블입니다.
label?: string
속성 값
string
listenFor
음성 및 언어 초기화 시스템에서 수신해야 하는 구 및 참조 목록입니다.
listenFor?: string[]
속성 값
string[]
localTimestamp
메시지가 전송된 현지 시간(클라이언트 또는 봇에서 설정됨, 예: 2016-09-23T13:07:49.4714686-07:00).
localTimestamp?: string
속성 값
string
localTimezone
메시지가 현지 시간으로 IANA 표준 시간대 데이터베이스 형식으로 표현되는 표준 시간대의 이름을 포함합니다. 예를 들어 미국/Los_Angeles.
localTimezone?: string
속성 값
string
name
호출할 작업의 이름 또는 이벤트의 이름입니다.
name?: string
속성 값
string
relatesTo
replyToId
이 업데이트와 관련된 이벤트의 ID입니다.
replyToId?: string
속성 값
string
semanticAction
source
이벤트의 원래 원본(예: 'facebook', 'skype', 'slack' 등)
source: string
속성 값
string
sourceEvent
원본 네이티브 스키마의 원래 이벤트입니다. 보내는 메시지의 경우 사용자 지정 첨부 파일과 같은 원본 특정 이벤트 데이터를 전달하는 데 사용할 수 있습니다.
sourceEvent: any
속성 값
any
speak
summary
최근 대화 목록과 같은 메시지 콘텐츠에 대한 간단한 설명과 대체 항목으로 표시할 텍스트입니다.
summary?: string
속성 값
string
text
메시지 텍스트입니다.
text?: string
속성 값
string
textFormat
텍스트 필드의 형식입니다. 기본값은 'markdown'입니다.
textFormat?: string
속성 값
string
textHighlights
작업에 ReplyToId 값이 포함될 때 강조 표시할 텍스트 조각의 컬렉션입니다.
textHighlights?: ITextHighlight[]
속성 값
textLocale
알려진 경우 메시지 텍스트의 식별된 언어입니다.
textLocale?: string
속성 값
string
timestamp
메시지가 전송된 UTC 시간(서비스별 설정)
timestamp?: string
속성 값
string
type
이벤트 유형을 정의합니다. IMessage에 대한 '메시지'여야 합니다.
type: string
속성 값
string
user
들어오는 메시지의 경우 메시지를 보낸 사용자입니다. 기본적으로 address.user 복사본이지만 들어오는 사용자를 내부 사용자 ID에 매핑할 수 있는 lookupUser 함수를 사용하여 봇을 구성할 수 있습니다.
user: IIdentity
속성 값
value
개방형 값입니다.
value?: any
속성 값
any
valueType
활동 값 개체의 형식입니다.
valueType?: string
속성 값
string