MasukMulai uji coba gratis
easyCoexistence API resmi

Webhook messaging_postbacks Instagram: ice breaker dan tombol

Field webhook messaging_postbacks Instagram memberi tahu aplikasi saat seseorang menekan pertanyaan ice breaker, tombol postback dalam template, atau item menu persisten dalam percakapan dengan akun profesional. Objek postback pada event memuat title, yaitu teks yang ditekan orang tersebut; payload, string yang diatur aplikasi untuk opsi itu; dan mid, ID pesan, sejak Graph API v11.0.

easyCoexistence berlangganan setiap akun Instagram terhubung ke comments, messages dan mentions, lalu meneruskan event tersebut, termasuk ketukan quick reply, ke endpoint HTTPS Anda saat terjadi, ditandatangani dengan secret akun tersebut tanpa menyimpan salinan.

4

Jumlah pertanyaan ice breaker terbanyak yang dapat diatur sebuah akun melalui Ice Breaker API Meta.

v11.0

Versi Graph API sejak postback menyertakan mid; field itu sendiri membutuhkan v8.0 atau lebih baru.

3

Jumlah tombol terbanyak dalam pesan button template, masing-masing berupa tombol postback atau web_url.

24 hours

Waktu untuk merespons setelah seseorang menekan item menu persisten, yang membuka jendela pesan standar.

13

Jumlah quick reply terbanyak yang dapat ditawarkan satu pesan; quick reply yang ditekan masuk ke messages, bukan messaging_postbacks.

Kapan messaging_postbacks terpicu?

Saat seseorang menekan salah satu opsi terstruktur akun dalam percakapan, setelah aplikasi dan akun berlangganan field tersebut. Panduan Meta mencantumkan sumber-sumber berikut:

  • Pertanyaan ice breaker, salah satu dari maksimal 4 yang ditawarkan akun saat percakapan dimulai. Tidak tersedia di desktop.
  • Tombol postback dalam button template, paling banyak 3 per pesan, atau dalam generic template, paling banyak 3 per elemen.
  • Item postback dalam menu persisten akun.
  • Ice breaker yang ditekan di thread baru yang dibuka dari tautan ig.me dengan parameter ref: postback kemudian juga membawa referral.
  • Uji self-messaging, saat akun menekan tombolnya sendiri: event menambahkan is_self bernilai true.

Seperti apa notifikasi postback?

Event messaging dengan objek postback di tempat DM biasanya memuat pesannya. Contoh Meta untuk Instagram Login memuat mid, title dan payload, dan panduan ice breaker-nya menampilkan objek yang sama tanpa mid. Notifikasi terlihat seperti ini:

A messaging_postbacks notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "postback": {
            "mid": "<MESSAGE_ID>",
            "title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
            "payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
          }
        }
      ]
    }
  ]
}

Apa arti setiap field?

Field yang didokumentasikan Meta untuk postback, dari luar ke dalam:

  • sender.id: Instagram-scoped ID orang yang menekan, ID untuk membalas. recipient.id dan entry[].id: akun profesional.
  • timestamp: kapan orang itu menekan, menurut panduan ice breaker Meta.
  • postback.title: pertanyaan ice breaker atau judul tombol yang dilihat orang tersebut.
  • postback.payload: string yang diatur untuk opsi itu saat dibuat, dipilih oleh aplikasi.
  • postback.mid: ID pesan yang dikirim ketukan ke akun, sejak Graph API v11.0.
  • postback.referral: ref, source dan type, saat thread dibuka dari tautan ig.me dengan parameter ref.
  • is_self: bernilai true, di samping postback, saat akun menekan tombolnya sendiri dalam uji self-messaging.

Bagaimana ice breaker diatur?

Dengan POST /<IG_ID>/messenger_profile di graph.instagram.com: platform diisi instagram dan array ice_breakers yang call_to_actions-nya memuat hingga 4 pasangan pertanyaan dan payload, dengan locale untuk setiap set terjemahan. GET /me/messenger_profile?fields=ice_breakers menampilkannya, dan DELETE dengan fields berisi ice_breakers menghapusnya. Payload yang dipilih di sini adalah yang dikembalikan messaging_postbacks saat pertanyaan ditekan.

Setting two ice breakers
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "platform": "instagram",
  "ice_breakers": [
    {
      "call_to_actions": [
        { "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
        { "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
      ]
    }
  ]
}

Bagaimana tombol postback dikirim?

Di dalam pesan yang dikirim akun dengan POST /<IG_ID>/messages. Button template memuat teks hingga 640 karakter dan 1 sampai 3 tombol; generic template memuat hingga 10 elemen, masing-masing dengan hingga 3 tombol. Tombol bertipe postback mengembalikan payload-nya di messaging_postbacks saat ditekan, sedangkan tombol web_url membuka halaman di browser dalam aplikasi. Menu persisten, yang diatur di messenger_profile, menerima dua tipe yang sama.

Apakah quick reply memakai messaging_postbacks?

Tidak: quick reply masuk ke messages. Quick reply yang ditekan mengirim judulnya ke percakapan sebagai pesan, dan event messages memuat text berisi judul itu serta quick_reply.payload berisi payload opsi tersebut. Satu pesan dapat menawarkan hingga 13 quick reply, masing-masing hingga 20 karakter, hanya teks biasa. Panduan Instagram Messaging dari Meta juga mencantumkan pilihan ice breaker dan generic template di antara yang dilaporkan messages, tanpa contoh payload.

Apakah ketukan membuka jendela pesan?

Untuk menu persisten, Meta menyatakan demikian: ketukan pada item menu membuka jendela pesan standar, dan akun punya 24 jam untuk merespons. Balas dengan POST /<IG_ID>/messages dan recipient.id diisi dengan sender.id dari postback. Balasan akun kembali di messages sebagai echo, dengan is_echo bernilai true.

Apakah easyCoexistence meneruskan postback?

Hanya ketukan quick reply. Ketukan itu masuk ke messages, yang berlangganan aplikasi easyCoexistence dan setiap akun yang terhubung, sehingga sampai ke endpoint Anda beserta quick_reply.payload. Ketukan ice breaker, tombol, dan menu masuk ke messaging_postbacks, yang tidak didaftarkan easyCoexistence, sehingga tidak diteruskan.

Kesalahan umum

  • Menunggu quick reply di messaging_postbacks. Quick reply masuk ke messages, dengan quick_reply.payload di samping teks opsi yang ditekan.
  • Melakukan routing berdasarkan postback.title. Title adalah yang dilihat orang tersebut dan bisa berbeda per locale; lakukan routing berdasarkan payload, yang diatur aplikasi.
  • Mengharapkan mid pada versi API lama. Meta menyertakan postback.mid hanya dari Graph API v11.0.
  • Mengatur lebih dari 4 ice breaker, atau mengujinya di desktop. Ice Breaker API Meta menerima hingga 4 pertanyaan, dan fitur ini tidak tersedia di desktop.
Melakukan ini dengan EasyCoexistence

send_social_dm membalas orang tersebut dalam jendela 24 jam. US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Field webhook mana yang melaporkan ketukan ice breaker Instagram?

messaging_postbacks. Objek postback memuat pertanyaan sebagai title dan payload yang diatur untuknya, ditambah mid dari Graph API v11.0.

Berapa banyak ice breaker yang bisa dimiliki sebuah akun Instagram?

Hingga 4 pertanyaan, diatur dengan POST /<IG_ID>/messenger_profile dan platform diisi instagram, opsional per locale.

Bagaimana saya membalas postback Instagram?

Dengan POST /<IG_ID>/messages dan recipient.id diisi dengan sender.id dari postback, yaitu Instagram-scoped ID orang yang menekan. Setelah ketukan menu persisten, Meta memberi akun 24 jam untuk merespons.

Apakah saya sebaiknya melakukan routing postback Instagram berdasarkan title atau payload?

Berdasarkan payload, string yang diatur aplikasi untuk opsi itu. title adalah teks yang dilihat orang tersebut, yang bisa berbeda per locale.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada