Pembaruan Game melalui Messenger

Game instan Facebook dapat dilengkapi dengan Bot Platform Messenger. Meskipun ini bersifat opsional, ini memberi game Anda saluran yang andal untuk interaksi ulang. Berikut ini cara membuat dan menyiapkan Bot Game Anda:

Langkah 1: Buat Halaman

Untuk membuat bot Game, Anda harus membuat halaman Facebook terlebih dulu. Agar berfungsi untuk Game Instan Anda dengan benar, halaman itu harus memenuhi beberapa kriteria spesifik:

• Kategori halaman haruslah Halaman Aplikasi (dan hanya kategori tersebut)
• Nama halaman harus berisi nama aplikasi.
• Halaman tersebut tidak dapat dikaitkan dengan aplikasi lainnya.

Untuk membuat halaman dengan kriteria-kriteria ini, buka Dasbor Aplikasi Anda dan ikuti langkah-langkah berikut:

1. Dalam menu Produk, bentangkan dropdown Game Instan dan pilih Perincian
2. Pada halaman Perincian, temukan bagian yang bernama Halaman Aplikasi dan klik Buat Halaman Baru
3. Buka bagian Halaman Aplikasi dari produk Game Instan itu. Sebelum melanjutkan ke langkah berikutnya, pastikan bahwa bagian Halaman Aplikasi Anda telah terlihat seperti langkah di sebelah kanan:

Langkah 2: Aktifkan Bot Anda

Setelah membuat halaman, Anda harus selalu menanggapi webhook pengiriman pesannya. Webhook adalah panggilan HTTP yang dikirimkan ke backend Anda saat peristiwa pengiriman pesan dikirimkan ke halaman Anda. Logika server Anda lalu akan menentukan cara menanggapi setiap peristiwa dengan benar, jika sebuah tanggapan sudah sesuai. Untuk mengaitkan endpoint server dengan peristiwa halaman Anda, ikuti petunjuk di Tutorial Singkat Platform Messenger guna mengaktifkan bot untuk halaman Anda. Tabel di bawah ini berisi informasi tentang webhook dan izin yang akan Anda perlukan untuk membuat bot Anda berfungsi dengan Game Instan:

Langkah 3: Tanggapi webhook messaging_game_plays

Setelah bot Anda dikonfigurasi dengan benar, aplikasi server Anda akan mulai menerima webhook messaging_game_plays setiap kali pemain menutup Game Instan. Di bawah ini adalah contoh aplikasi server yang mendeteksi dan menanggapi salah satu webhook ini.

if (event.game_play) {
  var senderId = event.sender.id; // Messenger sender id
  var playerId = event.game_play.player_id; // Instant Games player id
  var contextId = event.game_play.context_id; 
  var payload = event.game_play.payload;
  var playerWon = payload['playerWon'];
  if (playerWon) {
    sendMessage(
      senderId, 
      contextId, 
      'Congratulations on your victory!', 
      'Play Again'
    );

  } else {
    sendMessage(
      senderId, 
      contextId, 
      'Better luck next time!', 
      'Rematch!'
    );
  }
}

Anda dapat melihat dokumentasi Platform Messenger untuk informasi selengkapnya tentang webhook ini: Dokumentasi Webhook Game Play.

Langkah 4: Bawa pemain Anda kembali ke dalam game

Di bawah ini adalah contoh cara menggunakan API Graf untuk mengirimkan tombol game_play ke pemain Anda.

curl "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>" -X POST -H "Content-Type: application/json" -d '{ "messaging_type": "UPDATE", "recipient": { "id": "<RECIPIENT_ID>" }, "message": { "attachment": { "type": "template", "payload": { "template_type": "generic", "elements": [ { "title": "It has been a while since your last game. Time to get back", "buttons": [ { "type": "game_play", "title": "Play Tic-Tac-Toe.", "payload": "{}", "game_metadata": { "context_id": "<CONTEXT_ID>" } } ] } ] } } } }'

Anda dapat melihat dokumentasi Platform Messenger untuk informasi selengkapnya tentang tombol ini: Dokumentasi Tombol Game Play.

Langkah 5: Ikuti pedoman dan kebijakan kami

Sebelum diluncurkan untuk produksi, bot game Anda harus melalui proses pengajuan Platform Messenger. Pastikan untuk melihat Daftar Periksa Bot kami sebelum mengajukannya untuk ditinjau.