BotAdapter class

BotIdentityKey: symbol

속성 값

ConnectorClientKey: symbol

속성 값

OAuthScopeKey: symbol

속성 값

미들웨어 또는 애플리케이션에서 예외를 catch할 수 있는 오류 처리기를 가져오거나 설정합니다. 미들웨어 또는 애플리케이션에서 예외를 catch할 수 있는 오류 처리기를 설정합니다.

(context: TurnContext, error: Error) => Promise<void> onTurnError

속성 값

비동기 작업을 나타내는 프라미스입니다.

설명

오류 처리기는 다음 매개 변수를 사용하여 호출됩니다.

시간이 지나면 사용자와의 대화를 비동기적으로 다시 시작합니다.

function continueConversation(reference: Partial<ConversationReference>, logic: (revocableContext: TurnContext) => Promise<void>): Promise<void>

매개 변수

반환

설명

이를 사전 알림이라고도 하며, 봇은 들어오는 메시지를 기다리지 않고 대화 또는 사용자에게 메시지를 사전에 보낼 수 있습니다. 예를 들어 봇은 이 방법을 사용하여 사용자에게 알림 또는 쿠폰을 보낼 수 있습니다.

시간이 지나면 사용자와의 대화를 비동기적으로 다시 시작합니다.

function continueConversationAsync(claimsIdentity: ClaimsIdentity, reference: Partial<ConversationReference>, logic: (context: TurnContext) => Promise<void>): Promise<void>

매개 변수

반환

비동기 작업을 나타내는 promise

시간이 지나면 사용자와의 대화를 비동기적으로 다시 시작합니다.

function continueConversationAsync(claimsIdentity: ClaimsIdentity, reference: Partial<ConversationReference>, audience: string, logic: (context: TurnContext) => Promise<void>): Promise<void>

매개 변수

반환

비동기 작업을 나타내는 promise

시간이 지나면 사용자와의 대화를 비동기적으로 다시 시작합니다.

function continueConversationAsync(botAppId: string, reference: Partial<ConversationReference>, logic: (context: TurnContext) => Promise<void>): Promise<void>

매개 변수

반환

비동기 작업을 나타내는 promise

지정된 채널에 대화를 만듭니다.

function createConversationAsync(_botAppId: string, _channelId: string, _serviceUrl: string, _audience: string, _conversationParameters: ConversationParameters, _logic: (context: TurnContext) => Promise<void>): Promise<void>

매개 변수

반환

비동기 작업을 나타내는 프라미스

설명

대화를 시작하려면 봇이 해당 채널의 계정 정보와 사용자의 계정 정보를 알고 있어야 합니다. 대부분의 _channels 직접 메시지(그룹이 아닌) 대화 시작만 지원합니다.

어댑터는 채널에서 새 대화를 만든 다음, 미들웨어 파이프라인을 conversationUpdate 통해 논리 메서드로 활동을 보냅니다.

지정된 사용자와 대화가 설정된 경우 활동 대화의 ID에 새 대화의 ID가 포함됩니다.

기존 활동을 비동기적으로 삭제합니다. 이 인터페이스는 프레임워크를 지원하며 코드에 대해 직접 호출할 수 없습니다. TurnContext.deleteActivity를 사용하여 봇 코드에서 활동을 삭제합니다.

function deleteActivity(context: TurnContext, reference: Partial<ConversationReference>): Promise<void>

매개 변수

반환

설명

모든 채널이 이 작업을 지원하는 것은 아닙니다. 그렇지 않은 채널의 경우 이 호출이 예외를 throw할 수 있습니다.

채널 서버에 보내는 활동 집합을 비동기적으로 보냅니다. 이 메서드는 프레임워크를 지원하며 코드에 대해 직접 호출할 수 없습니다. 봇 코드에서 턴 컨텍스트의 sendActivity 또는 sendActivities 메서드를 사용합니다.

function sendActivities(context: TurnContext, activities: Partial<Activity>[]): Promise<ResourceResponse[]>

매개 변수

반환

ResourceResponse의 배열

설명

활동은 받은 순서대로 1회씩 전송됩니다. 전송된 각 작업에 대해 응답 개체가 반환됩니다. 활동의 경우 message 배달된 메시지의 ID가 포함됩니다.

이전 작업을 업데이트된 버전으로 비동기적으로 대체합니다. 이 인터페이스는 프레임워크를 지원하며 코드에 대해 직접 호출할 수 없습니다. TurnContext.updateActivity를 사용하여 봇 코드에서 활동을 업데이트합니다.

function updateActivity(context: TurnContext, activity: Partial<Activity>): Promise<ResourceResponse | void>

매개 변수

반환

설명

모든 채널이 이 작업을 지원하는 것은 아닙니다. 그렇지 않은 채널의 경우 이 호출이 예외를 throw할 수 있습니다.

어댑터의 파이프라인에 미들웨어를 추가합니다.

function use(middlewares: (context: TurnContext, next: () => Promise<void>) => Promise<void> | Middleware[]): this

매개 변수

반환

업데이트된 어댑터 개체입니다.

설명

미들웨어는 초기화 시 어댑터에 추가됩니다. 턴마다 어댑터는 추가한 순서대로 미들웨어를 호출합니다.