Platform Messenger

Balasan Pribadi

Dokumen ini menunjukkan kepada Anda cara menambahkan Balasan Pribadi secara terprogram ke pengalaman berkirim pesan Anda.

Cara Kerjanya

Balasan Pribadi memungkinkan akun Profesional Instagram untuk mengirim satu pesan ke orang yang mengomentari postingan Profesional Instagram Anda, postingan iklan, reel, atau cerita siaran langsung.

Saat Anda menerima notifikasi Webhooks comments atau live_comments, melalui Instagram Graph API, bahwa seseorang telah mengomentari postingan Profesional Instagram Anda, postingan iklan, reel, atau cerita siaran langsung, Anda dapat menggunakan ID komentar untuk mengirim tanggapan pribadi langsung ke orang tersebut. Balasan ini akan disampaikan di folder Kotak Masuk orang tersebut, jika orang tersebut mengikuti akun Instagram Profesional bisnis, atau ke folder Permintaan orang tersebut, jika orang tersebut tidak mengikuti akun tersebut.

Anda dapat mengirim balasan pribadi ini dalam waktu 7 hari sejak waktu komentar dibuat, kecuali Instagram Live yang hanya dapat dikirimi balasan pribadi selama siaran langsung. Pesan akan berisi tautan ke postingan yang dikomentari orang itu.

Webhooks

  • Saat menyelenggarakan cerita Siaran Langsung Instagram, pastikan server Anda dapat menangani peningkatan beban notifikasi yang dipicu oleh peristiwa Webhooks live_comments, melalui API Instagram, , dan sistem Anda dapat membedakan antara notifikasi live_comments dan comments.
  • Notifikasi Webhooks comments Instagram Graph API untuk postingan iklan akan menyertakan ID dan judul iklan. Anda mungkin perlu memperbarui server Webhooks Anda untuk menangani kolom baru ini.

    ad_id dan ad_title akan ditampilkan di objek media ketika seseorang mengomentari postingan Instagram yang dipromosikan atau postingan iklan Instagram. Hal ini dapat mengakibatkan duplikat notifikasi Webhooks.

Batasan

  • Hanya satu pesan yang bisa dikirim ke orang yang berkomentar
  • Pesan harus dikirim dalam waktu 7 hari sejak komentar dibuat untuk komentar di postingan, postingan iklan, atau reel
  • Karena sifat sementara dari Cerita Siaran Langsung Instagram, balasan pribadi di komentar Cerita Siaran Langsung Instagram hanya dapat dikirim selama siaran langsung. Begitu siaran langsung berakhir, balasan pribadi tidak bisa dikirim lagi.
  • Hanya ketika seseorang menanggapi pesan pribadi, Anda dapat melanjutkan percakapan dalam periode berkirim pesan 24 jam.
  • Aplikasi dengan Akses Standar hanya dapat mengakses data untuk orang-orang yang memiliki peran di aplikasi
  • Balasan pribadi untuk komentar IGTV tidak didukung
  • API v7.0 atau versi sebelumnya membutuhkan fitur Agen Manusia dan Tanda Pesan Agen Manusia untuk balasan pribadi

Sebelum Memulai

Tutorial ini mengasumsi Anda telah membaca Ringkasan Platform Messenger dan Ringkasan Berkirim Pesan di Instagram dan menerapkan komponen yang dibutuhkan.

Anda akan memerlukan:

  • ID untuk Halaman Facebook yang tertaut ke akun Profesional Instagram Anda
  • ID untuk komentar yang dibuat oleh orang yang Anda kirimi balasan pribadi. ID dapat diperoleh dari Webhooks comments Instagram, untuk postingan, postingan iklan, dan reel, dan Webhooks live_comments Instagram untuk cerita siaran langsung (direkomendasikan agar terhindar dari pembatasan laju) atau panggilan API ke endpoint /page/feed
  • Izin instagram_manage_comments dan pages_messaging, diperoleh melalui Facebook Login
  • Token akses Halaman yang diminta dari orang yang dapat melakukan tugas MESSAGING di Halaman Facebook yang tertaut ke akun Profesional Instagram Anda
  • Fitur Agen Manusia
  • Akses Lanjutan

Mengirim Balasan Pribadi

Untuk mengirim balasan pribadi kepada orang yang mengomentari postingan, reel, atau cerita siaran langsung Anda, kirim permintaan POST ke endpoint /PAGE-ID/messages dengan parameter recipient berisi ID komentar dan parameter message berisi teks yang ingin Anda kirim.

Diformat agar mudah dibaca.
curl -i -X POST "https://graph.facebook.com/PAGE-ID/messages
  ?recipient: { comment_id: COMMENT-ID }
  &message: { "text": "Thanks for reaching out, how can I help?" }
  &access_token=PAGE-ACCESS-TOKEN"
GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/1353269864728879/messages",
  new JSONObject("{\"recipient\":\"{comment_id: 18000158536435933}\",\"message\":\"{\\\"text\\\": \\\"It is cool\\\"}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/1353269864728879/messages"
           parameters:@{ @"recipient": @"{comment_id: 18000158536435933}",@"message": @"{"text": "It is cool"}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];
FB.api(
  '/1353269864728879/messages',
  'POST',
  {"recipient":"{comment_id: 18000158536435933}","message":"{\"text\": \"It is cool\"}"},
  function(response) {
      // Insert your code here
  }
);

Setelah berhasil, aplikasi akan menerima tanggapan berikut:

{
  "recipient_id": "526...",   // The Instagram-scoped ID 
  "message_id": "aWdfZ..."    // The message ID for your private reply
}

Lihat Juga

Dukungan Developer