Bagikan melalui

Koneksi bot ke email

  • Artikel

BERLAKU UNTUK: SDK v4

Anda dapat mengonfigurasi bot untuk berkomunikasi dengan pengguna melalui email Microsoft 365. Saat Anda mengonfigurasi bot untuk mengakses akun email, bot menerima pesan saat email baru tiba. Bot kemudian dapat menggunakan email untuk merespons. Misalnya, sebagai respons terhadap pesan email pengguna, bot dapat mengirim balasan email dengan pesan, "Hai! Terima kasih atas pesanan anda! Kami akan segera mulai memprosesnya."

Saluran Email saat ini hanya berfungsi dengan Office 365. Layanan email lain saat ini tidak didukung.

Peringatan

  • Untuk alasan keamanan, Exchange Online akan menonaktifkan autentikasi dasar pada 1 Oktober 2022. Saluran Email sekarang mendukung model autentikasi modern Exchange Online baru. Bot yang menggunakan model autentikasi dasar akan mengalami kegagalan setelah perubahan Oktober 2022; atau sebelumnya jika administrator penyewa Anda menonaktifkan autentikasi dasar sebelum tanggal tersebut. Untuk informasi selengkapnya, lihat Autentikasi Dasar dan Exchange Online - Pembaruan September 2021.
  • Ini adalah pelanggaran kode etik Kerangka Kerja Bot untuk membuat "spambot", termasuk bot yang mengirim email massal yang tidak diinginkan atau tidak diminta.

Prasyarat

  • Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
  • Akun email Office 365 khusus untuk bot.
  • Izin untuk memberikan bot Mail.ReadWrite dan Mail.Send akses. Untuk informasi selengkapnya, lihat Memahami pengalaman persetujuan aplikasi ID Microsoft Entra.

Catatan

Anda tidak boleh menggunakan akun email pribadi Anda sendiri untuk bot, karena setiap pesan yang dikirim ke akun email tersebut akan diteruskan ke bot. Ini dapat mengakibatkan bot secara tidak pantas mengirim respons ke pengirim. Untuk alasan ini, bot hanya boleh menggunakan akun email M365 khusus.

Mengonfigurasi email untuk menggunakan autentikasi modern

  1. Buka portal Microsoft Azure.

  2. Buka bilah sumber daya Azure Bot untuk bot Anda.

  3. Di panel kiri, pilih Saluran.

  4. Pilih Email untuk membuka bilah Konfigurasi email .

    Configure email settings

    1. Atur Jenis autentikasi ke Autentikasi modern (OAUTH).

    2. Di Alamat Email, masukkan akun email Office 365 khusus untuk bot.

    3. Pilih Otorisasi.

      1. Saat diminta, masuk ke akun email dan berikan izin baca/tulis dan kirim ke bot.

      2. Setelah berhasil, halaman terbuka dengan kode validasi. Salin kode validasi.

        Interaction with validation code

    4. Di Kode autentikasi, masukkan kode validasi yang baru saja Anda salin.

    5. Pilih Terapkan untuk menyelesaikan konfigurasi email.

Mengonfigurasi email untuk menggunakan autentikasi dasar

Catatan

  • Autentikasi gabungan menggunakan vendor apa pun yang menggantikan ID Microsoft Entra tidak didukung.
  • Untuk alasan keamanan, penggunaan autentikasi dasar di Exchange Online dinonaktifkan pada 1 Oktober 2022. Anda harus memigrasikan semua bot Anda untuk menggunakan autentikasi modern sebelum tenggat waktu.
  • Jika Anda menggunakan Microsoft Server Exchange, pastikan Anda telah mengaktifkan Autodiscover terlebih dahulu, sebelum mengonfigurasi email untuk menggunakan autentikasi dasar.
  • Jika Anda menggunakan akun Office 365 dengan MFA diaktifkan di dalamnya, pastikan Anda menonaktifkan MFA untuk akun yang ditentukan terlebih dahulu; kemudian Anda dapat mengonfigurasi akun untuk saluran email. Jika tidak, koneksi akan gagal.

  1. Buka portal Microsoft Azure.

  2. Buka bilah sumber daya Azure Bot untuk bot Anda.

  3. Di panel kiri, pilih Saluran (pratinjau) untuk membuka bilah Saluran .

  4. Pilih Email untuk membuka bilah Konfigurasi email .

    Enter email credentials

    1. Atur Jenis autentikasi ke Autentikasi dasar (menonaktifkan menatap Oktober, 2022).
    2. Di Alamat Email, masukkan akun email Office 365 khusus untuk bot.
    3. Di Kata Sandi, masukkan kata sandi untuk akun email.
    4. Pilih Terapkan untuk menyelesaikan konfigurasi email.

Mengkustomisasi email

Saluran Email mendukung pengiriman nilai kustom untuk membuat email yang lebih canggih dan disesuaikan dengan menggunakan properti aktivitas channelData . Cuplikan di bawah ini menunjukkan contoh channelData untuk pesan email kustom masuk, dari bot ke pengguna.

{
    "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",
    }
}

Untuk informasi selengkapnya tentang properti aktivitas channelData , lihat Membuat pesan Email kustom.

Pemecahan Masalah

Untuk kesalahan yang dapat terjadi saat memproses persetujuan untuk aplikasi, lihat Memahami pengalaman persetujuan aplikasi ID Microsoft Entra dan Kesalahan tak terduga saat melakukan persetujuan untuk aplikasi.

Jika bot Anda tidak mengembalikan kode status HTTP 200 OK dalam waktu 15 detik sebagai respons terhadap pesan email masuk, saluran email akan mencoba mengirim ulang pesan, dan bot Anda mungkin menerima aktivitas pesan email yang sama beberapa kali. Untuk informasi selengkapnya, lihat bagian detail HTTP di artikel Cara kerja bot dan pemecahan masalah kesalahan waktu habis.

Sumber Daya Tambahan: