KONTEN

1. Sinopsis
2. Mengonfigurasi Titik Masuk Laci
3. Berbagi
4. Mendapatkan ID Pengguna & Konteks Utas
5. Manajemen Izin
6. Kiat & Praktik Terbaik
7. Pertanyaan Umum & Pemecahan Masalah

Sinopsis

Model Interaksi

Ekstensi Obrolan muncul di laci komposer di Messenger setelah pengguna berinteraksi dengan bot terkait.

Saat pengguna mengetuk ikon ekstensi obrolan, hal ini akan membuka UI berbasis tampilan web yang ditentukan oleh pengembang. Pengguna lalu dapat membuat atau memilih konten untuk dibagikan ke dalam utas. Pesan yang dibagikan ke dalam utas dapat berisi gambar, tautan, dan lainnya.

Saat pengguna dalam grup berinteraksi dengan setiap pesan yang dibagikan dengan cara ini, pengembang akan memiliki akses ke info konteks pada utas tersebut, kemampuan untuk meminta izin, dan semuanya yang disediakan di SDK JavaScript Ekstensi Messenger.

Potensi Contoh Penggunaan

• Ekspresi: Membuat stiker atau meme langsung dari Messenger. Membagikan lagu, video, atau konten lainnya.
• Media: Mengirimkan cerita tentang topik yang Anda ikuti ke grup saat itu terjadi.
• Perdagangan: Pemesanan dan perencanaan grup
• Produktivitas: Mengirimkan pembaruan dari pelacak tugas, menyunting dokumen secara bersama-sama.
• Hiburan: Membuat game atau tantangan grup.

Mengonfigurasi Titik Masuk Laci

Guna memungkinkan bot Anda muncul di laci bagi orang-orang yang sudah menambahkannya, Anda harus mengatur URL berandanya.

Jika ekstensi obrolan Anda belum siap diluncurkan, harap mengatur in_test ke true untuk mencegahnya agar tidak muncul untuk orang yang bukan pengembang hingga ekstensi obrolan Anda siap.

Berbagi

Platform Messenger mendukung berbagi khusus dari tampilan web, yang memungkinkan pengembang memberikan pesan dan tujuan khusus untuk pesan yang dibagikan dari bot mereka.

Beberapa peningkatan sudah ditambahkan ke fitur ini guna memungkinkannya bekerja dengan Ekstensi Obrolan. Berikut ini adalah hal yang harus Anda ketahui:

Berbagi ke Utas Saat Ini

Fungsi beginShareFlow() memiliki parameter mode yang sekarang mendukung mode current_thread. Dengan hal ini, pengguna dapat berbagi ke utas asal Ekstensi Obrolan yang diminta pengguna tersebut, bukan mengharuskan memilih utas lainnya. Sebagian besar pengembang harus memilih mode current_thread untuk bagian dalam ekstensi itu sendiri.

Mungkin terdapat situasi di mana Anda ingin memeriksa apakah mode ini didukung oleh versi Messenger pengguna. Gunakan metode getSupportedFeatures() dan periksa untuk memastikan kunci "sharing_direct".

Menanggapi Berbagi

Callback success untuk beginShareFlow() dipanggil terlepas dari apakah pengguna mengonfirmasi berbagi atau membatalkannya, selama tidak ada kesalahan yang terjadi.

Sekarang Messenger meneruskan bidang is_sent sebagai tanggapan terhadap callback success yang memberi tahu Anda apakah pesan benar-benar terkirim.

Setelah pengguna sudah membagikan, merupakan ide yang bagus untuk menutup jendela jika Anda selesai, atau mengarahkan pengguna ke bagian alur selanjutnya.

<script> 
    var messageToShare = { ... };
      
    MessengerExtensions.beginShareFlow(function success(response) {
      if(response.is_sent === true){ 
      	// User shared. We're done here!
      	MessengerExtensions.requestCloseBrowser();
      }
      else{
      	// User canceled their share! 
      
      }
    }, 
    function error(errorCode, errorMessage) {      
  	// An error occurred trying to share!
    },
    messageToShare,
    "current_thread");   
</script>

Lihat dokumentasi untuk beginShareFlow() guna lebih spesifik.

Mendapatkan ID Pengguna & Konteks Utas

Panggil fungsigetContext() untuk mendapatkan:

• ID pengguna (PSID)
• ID utas
• Jenis utas

Fungsi ini berfungsi untuk semua pengguna yang melihat tampilan web, terlepas dari apakah mereka memiliki utas yang terbuka dengan bot Anda.

Perhatikan bahwa mendapatkan ID pengguna dengan cara ini bukan berarti dapat memperoleh profil pengguna. Untuk itu, Anda membutuhkan izin profil.

Manajemen Izin

Saat pengguna memulai utas dengan bot Anda, maka Anda akan secara otomatis memiliki izin untuk mengirim pesan kepada pengguna tersebut serta mendapatkan profil mereka. Hal ini dibatalkan untuk pengguna yang memblokir bot atau menghapus utas.

Untuk pengguna yang melihat bot Anda melalui tampilan web dan belum memulai utas, Anda mungkin ingin meminta untuk izin ini. Untuk ini, Anda dapat menggunakan fungsi izin di SDK JavaScript Ekstensi Messenger.

Kiat + Praktik Terbaik

Platform Messenger menyarankan praktik terbaik untuk cara membuat Ekstensi Obrolan yang bagus, termasuk:

• Pendekatan umum
• Cara menggunakan berbagai mode berbagi
• Cara mengontrol chrome tampilan web untuk dampak maksimal
• Cara memastikan kompabilitas mundur

Kit Desain

Siap untuk mendesain Ekstensi Obrolan Anda? Lihat file Sketsa berguna kami yang berisi semua komponen yang Anda butuhkan!

Pertanyaan Umum & Pemecahan Masalah

Tanya: Apakah saya harus memiliki bot untuk mengembangkan Ekstensi Obrolan?

Jawab: Ya! Ekstensi Obrolan adalah ekstensi bot.

Tanya: Apa yang membuat Ekstensi Obrolan muncul di laci komposer?

Jawab: Ekstensi obrolan muncul di laci komposer untuk pengguna sesudah mereka berinteraksi dengan bot terkait.

Tanya: Apakah saya harus memiliki Ekstensi Obrolan guna memungkinkan pengguna membagikan konten dari bot saya?

Jawab: Tidak! Platform Messenger memberikan berbagai cara untuk memungkinkan pengguna berbagi dari bot Anda.

Tanya: Apakah saya harus memiliki Ekstensi Obrolan untuk menggunakan tampilan web dan SDK Javascript Ekstensi Messenger di bot saya? Apa hubungannya?

Jawab: Tidak! Kami hanya menyukai kata-kata tersebut. Faktanya, tampilan web dapat diminta dalam berbagai cara selain Ekstensi Obrolan, dan semuanya memungkinkan penggunaan Ekstensi Messenger.

Tanya: Saat penerima Ekstensi Obrolan mengetuk sebuah tautan, fitur mana yang tersedia melalui SDK JavaScript Ekstensi Messenger?

Jawab: Semua fitur yang tersedia untuk pengirim juga tersedia untuk pengguna yang membuka konten yang dibagikan. Anda dapat memperoleh ID pengguna, konteks utas, mengawali berbagi Anda sendiri, dan masih banyak lagi. Perhatikan bahwa dalam situasi tersebut, Anda tidak akan memiliki akses ke profil pengguna atau untuk mengirim pesan kepada pengguna tersebut hingga Anda meminta izin yang diperlukan.

Tanya: Apakah Ekstensi Obrolan berfungsi di Messenger.com dan Facebook.com?

Jawab: Fitur ini hanya didukung di iOS dan Android. Pengguna pada klien berbasis web mungkin dapat mengeklik tautan yang dibagikan oleh pengguna Ekstensi Obrolan, namun tidak akan dapat menggunakan fungsionalitas yang disediakan oleh SDK JavaScript. Untuk info selengkapnya, "Kompatibilitas dengan Versi Terdahulu" di Panduan Praktik Terbaik Ekstensi Obrolan.

Tanya: Apa perbedaan antara berbagi ke utas saat ini dan berbagi dengan siaran?

Jawab: Ekstensi obrolan dibuat di fitur berbagi tampilan web yang diluncurkan sebelumnya dengan menambahkan alur yang disebut "current_thread".

Jika pengguna sudah meminta bot Anda di dalam utas menggunakan komposer, maka dapat dipahami bahwa dia ingin berbagai di sini, bukan dengan orang lain. Jadi dengan alur "current_thread", pengguna dapat mengonfirmasi pengiriman konten ke utas saat ini, bukan mengirimkan siaran ke beberapa utas.

Tanya: Saya memiliki Messenger versi terbaru dan SDK tidak berfungsi di tampilan web. Apa yang salah di sini?

Jawab: Periksa hal berikut:

• Halaman yang tidak diterbitkan: Jika halaman yang dilampirkan bot Anda tidak diterbitkan, SDK tidak akan memuat untuk pengguna yang tidak memiliki peran (mis., pengembang, pengurus) di halaman Anda. Tambahkan pengguna ke halaman atau terbitkan halaman tersebut.

• Properti messenger_extension belum diatur: Pastikan, di mana saja tampilan web dibuka, bahwa Anda mengatur messenger_extensions ke true. Ini mencakup:

  • Menu di bot Anda.
  • Di tombol dalam pesan tempat bot Anda dikirimkan
  • Dalam pesan yang dibagikan melalui beginShareFlow() dan tombol Bagikan.

• Domain tidak berada dalam daftar putih: Tambahkan domain yang menjadi host halaman tersebut ke daftar putih domain bot Anda.

• Lihat kiat pemecahan masalah tampilan web selengkapnya.

Tanya: Saya membuat Ekstensi Obrolan dan saya tidak dapat menampilkannya di komposer. Bagaimana cara memperbaikinya?

Periksa hal berikut:

1. Pastikan Anda sudah mengatur home_url untuk halaman tertentu yang Anda inginkan agar muncul, menggunakan Token Akses Halaman yang sesuai untuk halaman tersebut. Memindahkan bot dari satu halaman Facebook ke halaman lain tidak akan memindahkan URL beranda.

2. Jika Anda sudah mengatur atribut in_test ke true saat dalam mode pengembangan, pastikan bahwa orang yang memeriksa laci adalah pengembang atau penguji bot yang dimaksud, atau pengurus halaman Facebook. Jika Anda sudah merilis bot secara publik, verifikasikan bahwa Anda sudah mengirimkannya dan disetujui untuk izin pages_messaging.

3. Verifikasikan bahwa halaman Facebook yang melampirkan bot diterbitkan.

4. Verifikasikan bahwa bot tersebut dalam mode publik.

5. Verifikasikan bahwa Anda sudah berinteraksi dengan bot tersebut sebelumnya.

6. Ekstensi obrolan yang ditampilkan di laci komposer di-cache. Anda mungkin harus menunggu sebentar agar ekstensi obrolan muncul.