Office 365 메일에 봇 연결Connect a bot to Office 365 email

적용 대상: SDK v4APPLIES TO: SDK v4

봇은 기타 채널 외에 Office 365 메일을 통해 사용자와 통신할 수 있습니다.Bots can communicate with users via Office 365 email in addition to other channels. 메일 계정에 액세스하도록 구성된 봇은 새 메일이 도착할 때 메시지를 받습니다.When a bot is configured to access an email account, it receives a message when a new email arrives. 이후 봇은 비즈니스 논리에 지정된 대로 응답할 수 있습니다.The bot can then respond as indicated by its business logic. 예를 들어, 봇은 다음 메시지와 함께 메일을 받았음을 확인하는 메일 회신을 보낼 수 있습니다. “안녕하세요!For example, the bot could send an email reply acknowledging an email was received with the message, "Hi! 주문해 주셔서 감사합니다!Thanks for your order! 주문 처리가 즉시 시작될 예정입니다.”We will begin processing it immediately."

경고

원치 않거나 요청하지 않은 벌크 메일을 보내는 봇을 포함하여 “스팸 봇”을 만드는 것은 Bot Framework 준수 사항을 위반하는 것입니다.It is a violation of the Bot Framework Code of Conduct to create "spambots", including bots that send unwanted or unsolicited bulk email.

참고

Microsoft Exchange Server를 사용하는 경우 이메일 채널을 구성하기 전에 먼저 자동 검색을 사용하도록 설정했는지 확인합니다.If you are using Microsoft Exchange Server, make sure you have enabled Autodiscover first before configuring email channel.

메일 자격 증명 구성Configure email credentials

메일 채널 구성에 Office 365 자격 증명을 입력하여 봇을 메일 채널에 연결할 수 있습니다.You can connect a bot to the Email channel by entering Office 365 credentials in the Email channel configuration. AAD를 대체하는 공급업체를 사용하는 페더레이션 인증은 지원되지 않습니다.Federated authentication using any vendor that replaces AAD is not supported.

참고

고유한 개인 메일 계정을 봇에 사용하면 안 됩니다. 해당 메일에 전송되는 모든 메시지가 봇에 전달되기 때문입니다.You should not use your own personal email accounts for bots, as every message sent to that email account will be forwarded to the bot. 이로 인해 봇이 부적절하게 보낸 사람에게 응답을 보낼 수 있습니다.This can result in the bot inappropriately sending a response to a sender. 이런 이유로 봇은 전용 O365 메일 계정만 사용해야 합니다.For this reason, bots should only use dedicated O365 email accounts.

메일 채널을 추가하려면 Azure Portal에서 봇을 열고, 채널 블레이드를 클릭한 다음, 메일 을 클릭합니다.To add the Email channel, open the bot in the Azure Portal, click the Channels blade, and then click Email. 유효한 메일 자격 증명을 입력하고 저장 을 클릭합니다.Enter your valid email credentials and click Save.

메일 자격 증명 입력

메일 채널은 현재 Office 365에서만 작동합니다.The Email channel currently works with Office 365 only. 다른 메일 서비스는 현재 지원되지 않습니다.Other email services are not currently supported.

메일 사용자 지정Customize emails

전자 메일 채널은 사용자 지정 값 보내기를 지원 하 여 작업 속성을 통해 사용자 지정 된 고급 전자 메일을 만듭니다 channelData .The Email channel supports sending custom values to create more advanced, customized emails by using the activity channelData property. 아래 코드 조각은 channelData 봇에서 사용자에 들어오는 사용자 지정 전자 메일 메시지에 대 한의 예를 보여 줍니다.The snippet below shows an example of the channelData for an incoming custom email message, from the bot to the user.

속성Property DescriptionDescription
htmlBodyhtmlBody 메시지의 본문에 사용할 HTML입니다.The HTML to use for the body of the message.
subjectsubject 메시지에 사용할 제목입니다.The subject to use for the message.
importanceimportance 메시지에 사용할 중요도 플래그로, low, normal 또는 high입니다.The importance flag to use for the message: low, normal, or high.
toRecipientstoRecipients 메시지의 받는 사람 필드에 추가할 세미콜론(;)으로 구분된 이메일 주소 문자열입니다.A semicolon (;) delimited string of email addresses to add to the message's To field.
ccRecipientsccRecipients 메시지의 Cc(참조) 필드에 추가할 세미콜론(;)으로 구분된 이메일 주소 문자열입니다.A semicolon (;) delimited string of email addresses to add to the message's Cc (carbon copy) field.
bccRecipientsbccRecipients 메시지의 Bcc(숨은 참조) 필드에 추가할 세미콜론(;)으로 구분된 이메일 주소 문자열입니다.A semicolon (;) delimited string of email addresses to add to the message's Bcc (blind carbon copy) field.

작업 속성에 대 한 자세한 내용은 channelData 사용자 지정 전자 메일 메시지 만들기를 참조 하세요.For more information about the activity channelData property, see Create a custom Email message.

기타 고려 사항Other considerations

봇이 수신 이메일 메시지에 대한 응답으로 200 OK HTTP 상태 코드를 15초 내에 반환하지 않을 경우 이메일 채널이 메시지 재전송을 시도하고, 봇이 동일한 이메일 메시지 활동을 몇 번 수신할 수 있습니다.If your bot does not return a 200 OK HTTP status code within 15 seconds in response to an incoming email message, the email channel will try to resend the message, and your bot may receive the same email message activity a few times. 자세한 내용은 봇 작동 방식시간 초과 오류 문제 해결 방법 문서의 HTTP 세부 정보 섹션을 참조하세요.For more information, see the HTTP details section in How bots work and the how to troubleshooting timeout errors article.

참고

Office 365 계정 사용 시 MFA가 활성 상태에 있다면 지정된 계정에서 MFA를 사용하지 않도록 설정합니다. 이렇게 하면 이메일 채널에 대한 계정을 구성할 수 있습니다.If you are using an Office 365 account with MFA enabled on it, make sure you disable MFA for the specified account first, then you can configure the account for the email channel. 그렇지 않으면 연결이 실패합니다.Otherwise, the connection will fail.

추가 리소스Additional resources