다음을 통해 공유

실행 가능한 메시지에 대한 Outlook 채널에 봇 커넥트(미리 보기)

  • 아티클

적용 대상: SDK v4

실행 가능한 메시지를 사용하면 사용자가 Outlook 내에서 빠른 작업을 수행할 수 있습니다. 봇을 Outlook 실행 가능 메시지 채널에 연결하는 경우 봇은 적응형 카드를 사용하여 실행 가능한 메시지를 만들어 사용자 참여를 강화할 수 있습니다.

참고 항목

실행 가능한 메시지에 대한 Outlook 채널은 공개 미리 보기로 제공됩니다. 미리 보기에 포함된 기능은 완료되지 않을 수 있으며 공개 릴리스에서 사용할 수 있게 되기 전에 변경될 수 있습니다. 평가 및 탐색 목적으로만 제공됩니다.

Warning

원치 않거나 원치 않는 대량 전자 메일을 보내는 봇을 포함하여 "스팸봇"을 만드는 것은 Bot Framework 행동 강령 을 위반하는 것입니다.

필수 조건

참고 항목

  • 해당 전자 메일 계정으로 전송되는 모든 메시지가 봇에 전달되므로 봇에 대해 고유한 개인 전자 메일 계정을 사용하지 마세요. 이로 인해 봇이 보낸 사람에게 응답을 부적절하게 보낼 수 있습니다. 이러한 이유로 봇은 전용 O365 전자 메일 계정만 사용해야 합니다.
  • Microsoft Exchange Server를 사용하는 경우 전자 메일 채널을 구성하기 전에 자동 검색을 사용하도록 설정합니다.

메시지 디자인

실행 가능한 메시지에 대한 Outlook 채널은 전자 메일을 통해 적응형 카드를 보내고 받습니다.

실행 가능한 메시지 디자이너를 사용하여 실행 가능한 메시지 카드 디자인하고 테스트할 수 있습니다.

Important

범용 봇 작업 모델은 적응형 카드 스키마 버전 1.4에서 도입되었습니다. 이러한 새로운 기능을 사용하려면 적응형 카드의 버전 속성을 1.4 이상으로 설정해야 합니다. 적응형 카드 스키마 탐색기에서 Action.Execute를 참조하세요.

봇 구현 및 배포

일반적인 흐름은 봇이 사용자에게 실행 가능한 메시지를 보낸 다음 사용자의 작업을 처리하는 것입니다.

  1. 사용자가 전자 메일의 카드 응답하면 Outlook에서 호출 활동을 봇에 보냅니다. 활동의 value 속성에는 , verb및 data 속성이 있는 type작업 개체가 포함됩니다. 예를 들어 작업에는 동사와 데이터가 봇이 처음에 보낸 카드 대한 정보에 해당하는 다음 정보가 포함됩니다.

    "type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}

    전체 개체 스키마는 적응형 카드 스키마 탐색기에서 Action.Execute를 참조하세요.

  2. 봇은 들어오는 호출 작업을 처리하고 원래 적응형 카드를 대신할 새 적응형 카드를 포함하는 결과를 반환합니다. 호출 응답은 다음과 같을 수 있습니다.

    {
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}

액세스 요청

  1. Azure Portal에서 봇 리소스를 엽니다.
  2. 채널 창을 엽니다.
  3. Outlook 채널을 선택합니다.
  4. Outlook 구성 페이지에서 여기에 등록하세요.
  5. 등록 양식을 작성하여 액세스를 요청합니다. 자세한 내용은 실행 가능한 전자 메일 개발자 대시보드에 서비스 등록을 참조하세요.

다음 단계