Webhooks untuk Berkirim Pesan di Instagram

Webhooks memungkinkan Anda menerima notifikasi HTTP realtime tentang perubahan objek tertentu di grafik sosial Meta. Contoh: kami bisa mengirimi Anda notifikasi saat pelanggan mengirim pesan kepada akun Profesional Instagram Anda. Dengan notifikasi Webhooks, Anda dapat melacak perubahan pesan dan menghindari batas laju yang akan terjadi jika Anda meng-kueri endpoint Platform Messenger untuk melacak perubahan.

Persyaratan

Anda harus menerapkan persyaratan berikut untuk menerima notifikasi Webhooks untuk Berkirim Pesan di Instagram.

• Izin instagram_basic, instagram_manage_messages, dan pages_manage_metadata
• Untuk mendapatkan notifikasi Webhooks yang mencakup data yang dimiliki atau dikelola oleh orang-orang yang tidak memiliki peran di aplikasi Anda, aplikasi Anda harus memiliki Akses Lanjutan

Catatan: Anda harus berlangganan semua aplikasi berkirim pesan untuk bisnis Anda ke Webhooks berkirim pesan.

Mode Aplikasi

• Mode Pengembangan – Webhooks hanya akan dikirim jika orang yang menggunakan aplikasi Anda memiliki peran di aplikasi, bahkan jika aplikasi Anda memiliki Akses Lanjutan. Anda hanya dapat mengakses data yang Anda miliki atau kelola.
• Mode Live – Webhooks akan dikirim, bergantung pada level akses.

  • Akses Standar – Webhooks hanya akan dikirim jika orang yang menggunakan aplikasi Anda memiliki peran di aplikasi. Anda hanya dapat mengakses data yang Anda miliki atau kelola.
  • Akses Lanjutan – Webhooks akan dikirim ketika ada orang yang menggunakan aplikasi Anda selama izin prasyarat telah diberikan.

Pelajari selengkapnya tentang level akses , mode aplikasi , dan peran aplikasi.

Batasan

• Ketika pelanggan menanggapi atau meneruskan gambar dari carousel di Postingan Instagram, notifikasi akan menyertakan gambar pertama dalam carousel yang mungkin bukan gambar yang ditanggapi atau diteruskan oleh pelanggan.
• Hanya URL untuk media atau postingan yang dibagikan akan disertakan dalam notifikasi saat pelanggan mengirim pesan dengan membagikan.
• Pesan dengan GIF dan stiker tidak didukung. Jika seseorang mengirim pesan dengan GIF atau stiker, Webhooks tidak akan terpicu dan notifikasi Webhooks tidak akan dikirim.

Peristiwa Webhook

Contoh Notifikasi

Berikut ini adalah contoh untuk jenis notifikasi Webhooks yang dapat Anda terima.

Pesan

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGID",  // ID of your Instagram Professional account
      "time": 1569262486134,
      "messaging": [
        {
          "sender": { "id": "IGSID" },    // Instagram-scoped ID for the customer who sent the message
          "recipient": { "id": "IGID" },  // ID of your Instagram Professional account
          "timestamp": 1569262485349,
          "message": {
            "mid": "MESSAGE-ID",   // ID of the message sent to your business
      
            "text": "MESSAGE-TEXT"     // Included when a customer sends a message containing text
      
            "attachments": [           // Included when a customer sends multiple media attachments or a URL for a story mention or share
              {
                "type":"image",             // Can be audio, file, image (image or sticker), share, story_mention, or video
                "payload":{ "url":"LINK" }  
              },
              {
                "type":"video",
                "payload":{ "url":"LINK" }
              }
            ]
      
            "is_deleted": true         // Included when a customer deletes a message
      
            "is_echo": true            // Included when your business sends a message to the customer

            "is_unsupported": true,    // Included when a customer sends a message with unsupported media
      
            "quick_reply": {           // Included when a customer clicks a quick reply
              "payload": "CUSTOMER-RESPONSE-PAYLOAD"   // The payload with the option selected by the customer
            },      
      
            "referral": {              // Included when a customer clicks an Instagram Shop product
              "product": {
                "id": "PRODUCT-ID"
            }      
      
            "referral": {                   // Included when a customer clicks an CTD ad
              "ref": "REF-DATA-IN-AD-IF-SPECIFIED"
              "ad_id": AD-ID,
              "source": "ADS",
              "type": "OPEN_THREAD",
              "ads_context_data": {
                "ad_title": TITLE-FOR-THE-AD,
                "photo_url": IMAGE-URL-THAT-WAS-CLICKED,
                "video_url": THUMBNAIL-URL-FOR-THE-AD-VIDEO,
              }
            }

            "reply_to":{               // Included when a customer sends an inline reply
              "mid":"MESSAGE-ID"
            } 
      
            "reply_to": {               // Included when a customer replies to a story
              "story": {
                "url":"CDN-URL",
                "id":"STORY-ID"       
              }
            }
          }
        }
      ]
    }
  ]
}

Tanggapan Pesan

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGID",  // ID for your Instagram Professional account
      "time": 1569262486134,
      "messaging": [
        {
          "sender": {
            "id": "IGSID"  // Instagram-scoped ID for the customer who sent the message
          },
          "recipient": {
            "id": "IGID"  // ID for your Instagram Professional account
          },
          "timestamp": 1569262485349,
          "reaction" :{
            "mid" : "MESSAGE-ID",
            "action": "react",    // or unreact
            "reaction": "love", // optional, to unreact if there is no reaction field
            "emoji": "\u{2764}\u{FE0F}" // optional, to unreact if there is no emoji field
          } 
        }
      ]
    }
  ]
}  

Postback Berkirim Pesan

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGSID",  // ID of your Instagram Professional account
      "time": 1502905976963,
      "messaging": [
        {
          "sender": { "id": "IGSID" },    // Instagram-scoped ID for the customer who sent the message
          "recipient": { "id": "IGID" },  // ID of your Instagram Professional account
          "timestamp": 1502905976377,
          "postback": {
            "mid":"MESSAGE-ID",           // ID for the message sent to your business
            "title": "SELECTED-ICEBREAKER-REPLY-OR-CTA-BUTTON",
            "payload": "CUSTOMER-RESPONSE-PAYLOAD",  // The payload with the option selected by the customer
          }
        }
      ]
    }
  ]
}

Rujukan Berkirim Pesan

{
  "object": "instagram",
  "entry": [
    {
      "id": "IGSID",  // ID of your Instagram Professional account  
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "IGSID"  // Instagram-scoped ID for the customer who sent the message
          },
          "recipient": {
            "id": "IGID"  // ID of your Instagram Professional account
          },
          "timestamp": 1502905976377,
          "referral": {
                 "ref": "INFORMATION-INCLUDED-IN-REF-PARAMETER-OF-IGME-LINK"
                 "source": "IGME-SOURCE-LINK"  
                 "type":  "OPEN_THREAD"  // Only supported for existing conversations 
          }
        }
      ]
    }
  ]
}
  

Pesan Dilihat

{
   "object":"instagram",
   "entry":[
      {
         "id":"IGID",  // ID for your Instagram Professional account
         "time":1569262486134,
         "messaging":[
            {
               "sender":{
                  "id":"IGSID"  // Instagram-scoped ID for the customer who sent the message
               },
               "recipient":{
                  "id":"IGID"  // ID for your Instagram Professional account
               },
               "timestamp":1569262485349,
               "read":{
                  "mid":"MESSAGE-ID"
               }
            }
         ]
      }
   ]
}

Lihat Juga

• Protokol Serah Terima Messenger —Jika Anda memiliki beberapa aplikasi yang menangani pesan, contoh: satu aplikasi menangani tanggapan otomatis dan satu aplikasi menangani eskalasi ke agen manusia, Anda perlu menerapkan Protokol Serah Terima untuk meneruskan percakapan dari satu aplikasi ke aplikasi lainnya.
• Click To Direct, CTD —Kunjungi Pusat Bantuan Bisnis untuk mempelajari lebih lanjut tentang membuat iklan yang mengeklik ke Instagram Direct.