Bot untuk Workplace

Ringkasan

Dengan integrasi khusus untuk Workplace, kini Anda bisa membuat bot canggih yang bisa berinteraksi dengan orang-orang di grup dan obrolan.

Anda dapat membuat bot yang secara otomatis memposting konten ke dalam grup, menanggapi pertanyaan dengan informasi tambahan, atau mengambil tindakan saat disebut dalam komentar di postingan. Anda juga dapat membuat bot yang dapat berkomunikasi dengan orang-orang di Work Chat, memberikan informasi secara realtime, atau menangani permintaan dengan elemen percakapan terstruktur seperti balasan cepat dan menu persisten.

Bot sebagai Halaman

Di Workplace, serupa dengan platform Messenger, bot diwakili sebagai halaman. Halaman secara otomatis dibuat saat Anda membuat aplikasiintegrasi khusus. Orang-orang di komunitas Workplace Anda dapat menemukan dan berinteraksi dengan bot Anda melalui halaman ini

Halaman bot bersifat publik perusahaan, sehingga setiap anggota komunitas Workplace dapat melihat, memberi tanda, dan mengirim pesan ke bot. Namun, bergantung pada level izin yang Anda pilih saat membuat bot, bot mungkin tidak dapat melihat dan berinteraksi dengan semua konten di Workplace.

Contoh: jika bot Anda memiliki izin Membaca konten grup, bot akan dapat melihat konten dalam grup. Dan jika bot Anda tidak memiliki izin Memposting ke grup, bot tidak akan dapat membalas konten dalam grup.

Selain itu, orang hanya dapat menemukan dan mengirim pesan bot Anda di Work Chat jika ada izin Mengirim pesan ke semua anggota.

Bot dalam Grup

Dalam grup, bot dapat melakukan banyak hal yang dapat dilakukan orang. Ini berarti Anda dapat membuat bot yang memposting konten baru, mengomentari konten dengan informasi baru, dan menyukai postingan untuk menunjukkan persetujuan atau sudah menerima.

Bot juga dapat @menyebut orang untuk mendapatkan perhatian mereka, dan @disebut untuk memulai alur kerja tertentu atau mengajukan pertanyaan.

Terakhir, bot dapat berlangganan ke grup dan Webhooks @sebutan yang memberikan kemampuan untuk memantau konten dan berinteraksi dengan pengguna dengan cara yang fleksibel.

Bot dalam Obrolan

Saat berada dalam grup, bot dapat menggunakan dan berbagi informasi ke sekelompok orang secara asinkron, bot dalam obrolan paling baik untuk interaksi langsung realtime dengan satu orang atau grup tertentu.

Contoh: bot obrolan dapat digunakan untuk mengirim pengingat atau notifikasi penting kepada seseorang berdasarkan acara yang akan datang seperti wawancara atau rapat. Bot obrolan kerja juga dapat digunakan untuk terlibat dengan pengguna dalam percakapan dan mengambil tindakan tindak lanjut berdasarkan masukan yang diterima.

Model interaksi ini didasarkan pada konsep yang sama yang digunakan oleh Platform Messenger. Sebagai hasil, bot obrolan kerja dapat menggunakan fitur sebagai menu persisten, balasan cepat, dan template untuk memperkaya pengalaman pengguna.

Obrolan Bot ke Pengguna

Ketika bot memiliki izin Mengirim Pesan ke Semua Anggota, bot akan diizinkan untuk mengirim pesan langsung kepada siapa pun di Workplace melalui alamat email atau ID Workplace mereka melalui Messenger Send API.

Bot di typeahead pesan baru

Izin Kirim Pesan ke Setiap Anggota juga mengizinkan bot Anda untuk muncul di typeahead di permukaan obrolan Workplace.

Bot di typeahead pesan baru

Dengan berlangganan Webhooks Kirim Pesan ke Halaman, bot Anda juga akan diberi tahu saat pengguna mengirim pesan ke bot Anda, dan Anda dapat membangun alur percakapan dengan menggabungkan pengiriman dan penerimaan.

Percakapan bot ke pengguna

Obrolan Bot ke Grup

Ketika sebuah bot memiliki izin Mengirim Pesan kepada setiap Anggota & Bot Obrolan Grup, bot dapat membuat, mengelola, dan ditambahkan ke utas obrolan grup banyak orang. Bot dapat membuat utas grup baru dengan menentukan daftar penerima, dan dapat mengganti nama utas untuk membuat diskusi obrolan tentang topik tertentu dengan orang-orang tertentu.

Utas bernama dengan orang-orang tertentu, dibuat oleh bot.

Dengan mengaktifkan dukungan obrolan grup, bot Anda akan muncul di typeahead Tambahkan orang di utas obrolan grup yang ada. Ini kemudian akan menerima webhooks untuk setiap pesan yang dikirim oleh orang-orang di utas itu, dan dapat membalas utas itu menggunakan thread ID.

Menambahkan bot ke obrolan grup, lalu @ -menyebut si bot

Membuat utas dengan nama baru

Untuk membuat utas baru dengan penerima tertentu, buat permintaan POST ke endpoint /me/messages, yang menentukan array recipient IDs dan payload message awal, sebagai berikut:

POST /me/messages
{
  "recipient": {
    "ids": [<user_ids>]
  },
  "message": <message_payload>
}

Anda akan mendapatkan kembali payload tanggapan yang mencakup thread ID, yang dapat Anda gunakan untuk pesan tindak lanjut.

Jika Anda menggunakan endpoint yang sama dengan daftar penerima yang sama lagi, utas baru akan dibuat. Untuk mengirim pesan tindak lanjut ke utas yang sudah dibuat, buat permintaan POST ke endpoint /me/messages menggunakan thread_id di payload recipient sebagai berikut:

POST /me/messages
{
  "recipient": {
    "thread_key": <thread_id>
  },
  "message": <message_payload>
}

Untuk mengganti nama utas yang dibuat oleh bot Anda, buat permintaan POST ke edge /{thread}/threadname, sebagai berikut:

POST /t_<thread_id>/threadname
{
  "name": "new name"
}

Perhatikan perlunya untuk mengawali thread_id dengan "t_" di jalur edge.

Anda juga dapat menambah dan menghapus peserta dari utas dengan mengeluarkan permintaan POST atau DELETE di edge /{thread}/participants sebagai berikut:

POST t_<thread_id>/participants
{
  "to": [<user_ids>]
}

DELETE t_<thread_id>/participants
{
  "to": [<user_ids>]
}

Disebut di utas

Ketika bot Anda disebut pada sebuah pesan, webhooks kami akan mengirimkan daftar anggota yang ditandai pada pesan itu, sebagai payload berikut:

{
    "object":"page",
    "entry":[{
        "id":"746230239054322",
        "time":1539281406974,
        "messaging":[{
            ...
            "message":{
                "mid":"<message id>",
                "seq":2192,
                "text":"@Edu Gomes @Example Bot What's 2+2?"
            },
            "mentions":[{
                "offset":0,
                "length":10,
                "id":"100017376437045"
            },
            {
                "offset":11,
                "length":12,
                "id":"746230239054322"
            }]
        }]
    }]
} 

Partner Platform Bot

Workplace memiliki sejumlah partner platform bot yang telah membangun dukungan untuk bot di Workplace. Daftarnya dapat dilihat di sini. Anda dapat menggunakan salah satu dari platform ini untuk membuat bot yang kuat tanpa menulis satu baris kode pun.

Praktik Terbaik

Gunakan Saluran yang Tepat

Saat memutuskan apakah akan membangun interaksi grup atau obrolan untuk bot Anda, ada baiknya mempertimbangkan di mana bot Anda akan paling berguna.

• Jika Anda membuat bot yang mungkin berinteraksi dengan beberapa orang sekaligus, atau bot yang memposting konten untuk dilihat beberapa orang, buatlah bot yang memposting ke dalam grup dan menanggapi komentar dan sebutan pada postingan dalam grup.
• Jika Anda membuat bot yang perlu memberi tahu seseorang tentang sesuatu yang segera, sesuatu yang mungkin memerlukan tindak lanjut cepat, atau sesuatu yang harus berinteraksi dengan orang lain secara pribadi, percakapan di Work Chat harus didukung untuk bot Anda.

Satu aplikasi dapat menangani kedua saluran. Mungkin ada kalanya, contoh: bot tim bantuan Anda menerima pesan di Work Chat, sementara di lain waktu, bot perlu memposting dalam grup dan menerima balasan.

Penautan dalam ke bot

Gunakan format tautan https://w.m.me/{page-id} untuk menautkan langsung ke bot obrolan di Workplace. Dukungan saat ini tersedia di Obrolan Workplace saat menggunakan web, Android, dan iOS. Pada platform seluler tempat aplikasi Obrolan Workplace diinstal, tautan akan terbuka langsung di aplikasi.

Parameter Perujuk

Parameter Perujuk juga dapat digunakan untuk memasukkan informasi lebih lanjut ke tautan. Ini bisa, misalnya, memungkinkan bot untuk melakukan tindakan khusus berdasarkan pengguna mana yang telah diklik pengguna untuk tiba di bot.

Untuk menggunakan fitur tersebut, gunakan format tautan https://w.m.me/{page-id}?ref={referral_parameter}. Fitur ini diterapkan dengan cara yang sama dengan Platform Messenger. Baca dokumentasi Messenger untuk detailnya.

Kolom Webhooks yang relevan adalah messaging_referrals dan membutuhkan langganan baru. Ini sebelumnya bukan kolom Webhooks yang tersedia untuk aplikasi Workplace, tetapi Anda sekarang dapat berlangganan dengan cara biasa.

Payload Webhooks dalam format yang sama dengan Messenger, dengan perbedaan biasanya: Workplace menggunakan ID lingkup aplikasi, bukan ID lingkup Halaman. Selain itu, Workplace juga menyediakan kolom komunitas di Webhooks, membawa ID komunitas.

Interaksi Grup

Setelah aplikasi Anda berlangganan Webhooks, bot Anda akan diberi tahu saat disebutkan dalam postingan grup atau komentar. Bot Anda harus menanggapi sebutan secara tepat waktu. Jika bot Anda harus memproses permintaan sebelum membalas, menyukai komentar tersebut ada gunanya, untuk menunjukkan kepada orang bahwa bot mengetahui penyebutan tersebut.

Kemudian jika Anda memberikan informasi setelah disebut dalam komentar, tambahkan balasan berantai agar percakapan grup sisanya tetap mengalir.

Jika bot Anda perlu memberikan info ke pengepos asli, tambahkan komentar di postingan itu sendiri, sehingga mereka juga mendapat notifikasi.

Interaksi Obrolan

Interaksi bot di Work Chat mendukung fungsi yang mirip dengan platform Messenger. Ini termasuk tombol dan template balas cepat yang membantu Anda menerapkan pohon keputusan dalam percakapan bot.

Ini membuatnya lebih mudah untuk membangun alur kerja yang berguna dan mengurangi jumlah pengetikan yang perlu dilakukan orang, tanpa perlu pemrosesan bahasa alami yang canggih, yang membuat internasionalisasi jauh lebih sederhana jika Anda membangun bot untuk tenaga kerja global.