Koneksi bot ke saluran Outlook untuk Pesan yang Dapat Ditindaklaksakan (Pratinjau)

Artikel
10/24/2023

BERLAKU UNTUK: SDK v4

Pesan yang Dapat Ditindak lanjuti memungkinkan pengguna untuk mengambil tindakan cepat dari dalam Outlook. Saat Anda menyambungkan bot ke saluran Pesan yang Dapat Ditindaklanjuti Outlook, bot Anda dapat menggunakan Kartu Adaptif untuk membuat pesan yang dapat ditindaklanjuti, meningkatkan keterlibatan pengguna.

Catatan

Saluran Outlook untuk Pesan yang Dapat Ditindaklajuti berada dalam pratinjau publik. Fitur yang disertakan dalam pratinjau mungkin tidak selesai, dan mungkin mengalami perubahan sebelum tersedia dalam rilis publik. Mereka disediakan hanya untuk tujuan evaluasi dan eksplorasi.

Peringatan

Ini adalah pelanggaran kode etik Kerangka Kerja Bot untuk membuat "spambot", termasuk bot yang mengirim email massal yang tidak diinginkan atau tidak diminta.

Prasyarat

Pengetahuan tentang Kartu Adaptif dan Model Tindakan Universal.
Keakraban dengan pesan yang dapat ditindak di Outlook dan Grup Office 365.
Bot siap saluran disebarkan ke Azure.
Alamat email khusus yang akan digunakan bot Anda untuk mengirim dan menerima pesan.

Catatan

Jangan gunakan 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 O365 khusus.
Jika Anda menggunakan Microsoft Server Exchange, aktifkan Autodiscover sebelum mengonfigurasi saluran email.

Mendesain pesan

Saluran Outlook untuk Pesan yang Dapat Ditindaklajuti mengirim dan menerima Kartu Adaptif melalui email.

Anda dapat menggunakan Perancang Pesan yang Dapat Ditindaklajuti untuk merancang dan menguji kartu pesan yang dapat ditindaklajuti.

Penting

Model tindakan Bot universal diperkenalkan dalam skema Kartu Adaptif versi 1.4. Untuk menggunakan kemampuan baru ini, properti versi Kartu Adaptif Anda harus diatur ke 1.4 atau yang lebih baru. Lihat Action.Execute di Penjelajah Skema Kartu Adaptif.

Menerapkan dan menyebarkan bot

Alur umum adalah agar bot mengirim pesan yang dapat ditindak lanjuti kepada pengguna lalu menangani tindakan pengguna.

Ketika pengguna merespons kartu dalam email, Outlook mengirim aktivitas pemanggilan ke bot. Properti aktivitas value berisi objek tindakan dengan typeproperti , , verbdan data . Misalnya, aktivitas akan mencakup informasi berikut, di mana kata kerja dan data sesuai dengan informasi pada kartu yang dikirim bot awalnya.
```
"type": "invoke",
"name": "adaptiveCard/action",
"value": {
  "action": {
    "type": "Action.Execute",
    "verb": "<DEVELOPER_DEFINED_VERB>",
    "data": {
      // DEVELOPER_DEFINED_PROPERTIES
    }
  },
}
```
Lihat Action.Execute di Penjelajah Skema Kartu Adaptif untuk skema objek lengkap.
Bot menangani aktivitas pemanggilan masuk dan mengembalikan hasil yang mencakup Kartu Adaptif baru yang akan menggantikan Kartu Adaptif asli. Respons pemanggilan mungkin terlihat seperti:
```
{
  "statusCode": 200,
  "type": "application/vnd.microsoft.card.adaptive",
  "value": <UPDATED_ADAPTIVE_CARD>
}
```

Meminta akses

Buka sumber daya bot Anda di portal Azure.
Buka panel Saluran .
Pilih saluran Outlook .
Pada halaman Konfigurasi Outlook , pilih silakan daftar di sini.
Isi formulir pendaftaran untuk meminta akses. Lihat Mendaftarkan layanan Anda dengan dasbor pengembang email yang dapat ditindak lanjuti untuk informasi selengkapnya.

Langkah berikutnya

Pelajari selengkapnya tentang Pesan yang dapat ditindak lanjuti di Grup Outlook dan Office 365.
Pelajari selengkapnya tentang Kartu Adaptif untuk Pengembang Pesan yang Dapat Ditindak lanjuti Outlook

Bagikan melalui