다음을 통해 공유


IMessage interface

사용자와 봇 간에 전송된 채팅 메시지입니다. 봇에서 사용자로 보내는 메시지는 다음 두 가지 버전으로 제공됩니다.

  • 사후 메시지 사용자의 들어오는 메시지에 대한 회신으로 봇에서 사용자에게 보낸 메시지입니다.
  • 자동 관리 메시지는 경보 트리거와 같은 일부 외부 이벤트에 대한 응답으로 봇에서 사용자에게 보내는 메시지입니다.

반응적 경우 들어오는 메시지에서 보내는 메시지로 주소 필드를 복사해야 합니다(Message 작성기 클래스를 사용하고 세션으로 초기화하면 자동으로) 텍스트 설정하거나 첨부 파일을 . 자동 관리 메시지의 경우 들어오는 메시지의 주소 외부 스토리지에 저장해야 합니다. 그런 다음 나중에 UniversalBot.beginDialog() 전달하거나 UniversalBot.send()전달된 보내는 메시지에 복사할 수 있습니다.

들어오는 주소 개체를 사용하여 사용자에게 메시지를 작성하면 기본적으로 현재 대화의 컨텍스트에서 사용자에게 회신을 보냅니다. 일부 채널에서는 사용자와 새 대화를 시작할 수 있습니다. 사용자와 새 자동 관리 대화를 시작하려면 보내는 메시지를 작성하기 전에 주소 개체에서 대화 필드를 삭제하기만 하면됩니다.

Extends

속성

address

이벤트에 대한 주소 라우팅 정보입니다. 나중에 사용자에게 자동 관리 메시지를 작성하려면 이 필드를 외부 스토리지에 저장합니다.

agent

이벤트를 처리하는 SDK입니다. 항상 'botbuilder'가 됩니다.

attachmentLayout

클라이언트가 여러 첨부 파일을 레이아웃하는 방법에 대한 힌트입니다. 기본값은 'list'입니다.

attachments

들어오는 메시지에는 사용자가 보낸 이미지와 같은 첨부 파일이 포함됩니다. 보내는 메시지에는 사용자에게 보낼 카드 또는 이미지와 같은 개체가 포함됩니다.

code

대화가 종료된 이유를 나타내는 코드입니다.

deliveryMode

받는 사람에게 활동의 대체 배달 경로를 알리는 배달 힌트입니다. 기본 배달 모드는 "기본값"입니다.

entities

구조화된 개체가 봇 또는 사용자에게 전달됩니다.

expriation

활동을 "만료됨"으로 간주하고 받는 사람에게 표시해서는 안 되는 시간입니다.

importance

활동의 중요도입니다.

inputHint

봇이 추가 입력을 기대하는지 여부를 알려주는 클라이언트에 대한 힌트입니다. 기본 제공 프롬프트는 나가는 메시지에 대해 이 값을 자동으로 채웁니다.

label

활동에 대한 설명이 포함된 레이블입니다.

listenFor

음성 및 언어 초기화 시스템에서 수신해야 하는 구 및 참조 목록입니다.

localTimestamp

메시지가 전송된 현지 시간(클라이언트 또는 봇에서 설정됨, 예: 2016-09-23T13:07:49.4714686-07:00).

localTimezone

메시지가 현지 시간으로 IANA 표준 시간대 데이터베이스 형식으로 표현되는 표준 시간대의 이름을 포함합니다. 예를 들어 미국/Los_Angeles.

name

호출할 작업의 이름 또는 이벤트의 이름입니다.

relatesTo

다른 대화 또는 메시지에 대한 참조입니다.

replyToId

이 업데이트와 관련된 이벤트의 ID입니다.

semanticAction

이 요청과 함께 제공되는 선택적 프로그래밍 작업입니다.

source

이벤트의 원래 원본(예: 'facebook', 'skype', 'slack' 등)

sourceEvent

원본 네이티브 스키마의 원래 이벤트입니다. 보내는 메시지의 경우 사용자 지정 첨부 파일과 같은 원본 특정 이벤트 데이터를 전달하는 데 사용할 수 있습니다.

speak

음성 메시지를 Speech Synthesis Markup Language.

summary

최근 대화 목록과 같은 메시지 콘텐츠에 대한 간단한 설명과 대체 항목으로 표시할 텍스트입니다.

text

메시지 텍스트입니다.

textFormat

텍스트 필드의 형식입니다. 기본값은 'markdown'입니다.

textHighlights

작업에 ReplyToId 값이 포함될 때 강조 표시할 텍스트 조각의 컬렉션입니다.

textLocale

알려진 경우 메시지 텍스트의 식별된 언어입니다.

timestamp

메시지가 전송된 UTC 시간(서비스별 설정)

type

이벤트 유형을 정의합니다. IMessage에 대한 '메시지'여야 합니다.

user

들어오는 메시지의 경우 메시지를 보낸 사용자입니다. 기본적으로 address.user 복사본이지만 들어오는 사용자를 내부 사용자 ID에 매핑할 수 있는 lookupUser 함수를 사용하여 봇을 구성할 수 있습니다.

value

개방형 값입니다.

valueType

활동 값 개체의 형식입니다.

속성 세부 정보

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

다른 대화 또는 메시지에 대한 참조입니다.

relatesTo?: IAddress

속성 값

replyToId

이 업데이트와 관련된 이벤트의 ID입니다.

replyToId?: string

속성 값

string

semanticAction

이 요청과 함께 제공되는 선택적 프로그래밍 작업입니다.

semanticAction?: ISemanticAction

속성 값

source

이벤트의 원래 원본(예: 'facebook', 'skype', 'slack' 등)

source: string

속성 값

string

sourceEvent

원본 네이티브 스키마의 원래 이벤트입니다. 보내는 메시지의 경우 사용자 지정 첨부 파일과 같은 원본 특정 이벤트 데이터를 전달하는 데 사용할 수 있습니다.

sourceEvent: any

속성 값

any

speak

음성 메시지를 Speech Synthesis Markup Language.

speak?: string

속성 값

string

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