Aracılığıyla paylaş

E-postaya bot Bağlan

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Botunuzu Microsoft 365 e-postası aracılığıyla kullanıcılarla iletişim kuracak şekilde yapılandırabilirsiniz. Botunuzu bir e-posta hesabına erişecek şekilde yapılandırdığınızda, yeni bir e-posta geldiğinde bir ileti alır. Bot daha sonra yanıt vermek için e-postayı kullanabilir. Örneğin, kullanıcının e-posta iletisine yanıt olarak bot şu iletiyi içeren bir e-posta yanıtı gönderebilir: "Merhaba! Siparişiniz için teşekkürler! Hemen işlemeye başlayacağız."

E-posta kanalı şu anda yalnızca Office 365 ile çalışır. Diğer e-posta hizmetleri şu anda desteklenmiyor.

Uyarı

  • Güvenlik nedeniyle, Exchange Online 1 Ekim 2022'de temel kimlik doğrulamasını devre dışı bırakacaktır. E-posta kanalı artık yeni Exchange Online modern kimlik doğrulama modelini destekliyor. Temel kimlik doğrulama modelini kullanan botlar Ekim 2022 değişikliğinden sonra hatalarla karşılaşır; veya kiracı yöneticiniz bu tarihten önce temel kimlik doğrulamayı devre dışı bırakırsa daha önce. Daha fazla bilgi için bkz . Temel Kimlik Doğrulaması ve Exchange Online - Eylül 2021 Güncelleştirmesi.
  • İstenmeyen veya istenmeyen toplu e-posta gönderen botlar da dahil olmak üzere "istenmeyen posta botları" oluşturmak Bot Framework Davranış Kuralları'nın ihlalidir.

Ön koşullar

Dekont

Bu e-posta hesabına gönderilen her ileti bota iletileceğinden botlar için kendi kişisel e-posta hesaplarınızı kullanmamalısınız. Bu, botunun gönderene uygunsuz bir şekilde yanıt göndermesine neden olabilir. Bu nedenle botlar yalnızca ayrılmış M365 e-posta hesaplarını kullanmalıdır.

E-postayı modern kimlik doğrulaması kullanacak şekilde yapılandırma

  1. Azure portalını açın.

  2. Botunuzun Azure Bot kaynak dikey penceresini açın.

  3. Sol bölmede Kanallar'ı seçin.

  4. E-postayı Yapılandır dikey penceresini açmak için E-posta'ya tıklayın.

    Configure email settings

    1. Kimlik doğrulama türünü Modern kimlik doğrulaması (OAUTH) olarak ayarlayın.

    2. E-posta Adresi alanına bot için ayrılmış Office 365 e-posta hesabını girin.

    3. Yetkilendir'i seçin.

      1. İstendiğinde, e-posta hesabında oturum açın ve bota okuma/yazma ve gönderme izinleri verin.

      2. Başarılı olduğunda, doğrulama koduyla bir sayfa açılır. Doğrulama kodunu kopyalayın.

        Interaction with validation code

    4. Kimlik doğrulama kodu alanına, az önce kopyaladığınız doğrulama kodunu girin.

    5. E-posta yapılandırmasını tamamlamak için Uygula'yı seçin.

E-postayı temel kimlik doğrulamasını kullanacak şekilde yapılandırma

Dekont

  • Microsoft Entra Id'nin yerini alacak herhangi bir satıcı kullanılarak federasyon kimlik doğrulaması desteklenmez.
  • Güvenlik nedeniyle, Exchange Online'da temel kimlik doğrulaması kullanımı 1 Ekim 2022'de devre dışı bırakılıyor. Son tarihten önce modern kimlik doğrulamasını kullanmak için tüm botlarınızı geçirmeniz gerekir.
  • Microsoft Exchange Server kullanıyorsanız, e-postayı temel kimlik doğrulamasını kullanacak şekilde yapılandırmadan önce Otomatik Bulma'yı etkinleştirdiğinizden emin olun.
  • MFA'nın etkinleştirildiği bir Office 365 hesabı kullanıyorsanız, önce belirtilen hesap için MFA'yı devre dışı bırakın; ardından hesabı e-posta kanalı için yapılandırabilirsiniz. Aksi takdirde bağlantı başarısız olur.

  1. Azure portalını açın.

  2. Botunuzun Azure Bot kaynak dikey penceresini açın.

  3. Sol bölmede Kanallar (önizleme) öğesini seçerek Kanallar dikey penceresini açın.

  4. E-postayı Yapılandır dikey penceresini açmak için E-posta'ya tıklayın.

    Enter email credentials

    1. Kimlik doğrulama türünü Temel kimlik doğrulaması olarak ayarlayın (Ekim 2022'ye bakarken devre dışı bırakılıyor).
    2. E-posta Adresi alanına bot için ayrılmış Office 365 e-posta hesabını girin.
    3. Parola alanına e-posta hesabının parolasını girin.
    4. E-posta yapılandırmasını tamamlamak için Uygula'yı seçin.

E-postaları özelleştirme

E-posta kanalı, etkinlik channelData özelliğini kullanarak daha gelişmiş, özelleştirilmiş e-postalar oluşturmak için özel değerler göndermeyi destekler. Aşağıdaki kod parçacığında bottan kullanıcıya gelen özel e-posta iletisinin bir örneği channelData gösterilmektedir.

{
    "type": "ActivityTypes.Message",
    "locale": "en-Us",
    "channelID": "email",
    "fromName": { "id": "mybot@mydomain.com", "name": "My bot"},
    "recipientName": { "id": "joe@otherdomain.com", "name": "Joe Doe"},
    "conversation": { "id": "123123123123", "topic": "awesome chat" },
    "channelData":
    {
        "htmlBody": "<html><body style = \"font-family: Calibri; font-size: 11pt;\" >This is more than awesome.</body></html>",
        "importance": "high",
        "ccRecipients": "Yasemin@adatum.com;Temel@adventure-works.com",
    }
}

Etkinlik channelData özelliği hakkında daha fazla bilgi için bkz . Özel E-posta iletisi oluşturma.

Sorun giderme

Bir uygulamaya onay işlenirken oluşabilecek hatalar için bkz . Microsoft Entra ID uygulama onayı deneyimlerini anlama ve Uygulamaya onay verirken beklenmeyen hata.

Botunuz gelen e-posta iletisine yanıt olarak 15 saniye içinde 200 Tamam HTTP durum kodu döndürmezse, e-posta kanalı iletiyi yeniden göndermeyi dener ve botunuz aynı e-posta iletisi etkinliğini birkaç kez alabilir. Daha fazla bilgi için, Botların nasıl çalıştığı ve zaman aşımı hatalarını giderme makalesinin HTTP ayrıntıları bölümüne bakın.

Ek kaynaklar