Membuat pesan dengan BOT Connector API
Bot Anda akan mengirim objek Aktivitas jenis pesan untuk mengomunikasikan informasi kepada pengguna, dan juga, juga akan menerima aktivitas pesan dari pengguna. Beberapa pesan mungkin hanya terdiri dari teks biasa, sementara yang lain mungkin berisi konten yang lebih kaya seperti teks yang akan diucapkan, tindakan yang disarankan, lampiran media, kartu kaya, dan data khusus saluran. Artikel ini menjelaskan beberapa properti pesan yang umum digunakan.
Teks dan pemformatan pesan
Teks pesan dapat diformat menggunakan biasa, markdown, atau xml. Format default untuk textFormat properti adalah markdown dan menginterpretasikan teks menggunakan standar pemformatan Markdown. Tingkat dukungan format teks bervariasi di seluruh saluran.
Tip
Untuk informasi tentang fitur mana yang didukung di setiap saluran, lihat artikel referensi saluran .
Properti textFormat objek Aktivitas dapat digunakan untuk menentukan format teks. Misalnya, untuk membuat pesan dasar yang hanya berisi teks biasa, atur textFormat properti Activity objek ke biasa, atur text properti ke konten pesan dan atur locale properti ke lokal pengirim.
Lampiran
attachments Properti objek Aktivitas dapat digunakan untuk mengirim lampiran media sederhana (gambar, audio, video, file) dan kartu kaya. Untuk detailnya, lihat Menambahkan lampiran media ke pesan dan Menambahkan kartu kaya ke pesan.
Entitas
Properti entities objek Aktivitas adalah array objek schema.org terbuka yang memungkinkan pertukaran metadata kontekstual umum antara saluran dan bot.
Sebutkan entitas
Banyak saluran mendukung kemampuan bot atau pengguna untuk "menyebutkan" seseorang dalam konteks percakapan. Untuk menyebutkan pengguna dalam pesan, isi properti pesan entities dengan objek Sebutan .
Menempatkan entitas
Untuk menyampaikan informasi terkait lokasi dalam pesan, isi properti pesan entities dengan Tempatkan objek.
Data saluran
channelData Properti objek Aktivitas dapat digunakan untuk mengimplementasikan fungsionalitas khusus saluran. Untuk detailnya, lihat Menerapkan fungsionalitas khusus saluran.
Teks ke ucapan
speak Properti objek Aktivitas dapat digunakan untuk menentukan teks yang akan diucapkan oleh bot Anda pada saluran yang mendukung ucapan dan inputHint properti Activity objek dapat digunakan untuk memengaruhi status mikrofon klien. Untuk detailnya, lihat Menambahkan ucapan ke pesan dan Menambahkan petunjuk input ke pesan.
Tindakan yang disarankan
Properti suggestedActions objek Aktivitas dapat digunakan untuk menyajikan tombol yang dapat diketukan pengguna untuk memberikan input. Tidak seperti tombol yang muncul dalam kartu kaya (yang tetap terlihat dan dapat diakses oleh pengguna bahkan setelah diketuk), tombol yang muncul dalam panel tindakan yang disarankan akan hilang setelah pengguna membuat pilihan. Untuk detailnya, lihat Menambahkan tindakan yang disarankan ke pesan.