Pesan Marketing

(Juga dikenal sebagai Notifikasi Berulang)

Dokumen ini menunjukkan cara meminta izin dari seseorang untuk mengirim pesan marketing (disebut juga Notifikasi Berulang), tentang persyaratan dan batasan khusus untuk mengirim permintaan, serta cara membuat dan mengirim permintaan izin pesan marketing.

Ringkasan

Pesan Marketing memungkinkan Halaman Facebook atau Akun Profesional Instagram untuk mengirim pesan di luar periode berkirim pesan standar bagi orang-orang yang telah memberi Anda izin untuk melakukannya. Pesan Marketing memungkinkan Anda menjalin hubungan dengan orang-orang yang tertarik pada Anda atau bisnis Anda.

Pesan Marketing adalah fitur premium opsional baru yang nantinya akan kami kenakan biaya ke depannya. Saat ini kami mengenakan biaya kepada pelaku bisnis yang ingin mengirim pesan dari API WhatsApp Business dan menerima masukan pelanggan untuk memandu keputusan tentang model harga kami. Kami akan menginformasikan kepada pelanggan dan mitra tentang setiap perubahan pada uji coba gratis dengan pemberitahuan jauh-jauh hari sebelumnya.

Persyaratan

• Anda harus mematuhi semua Kebijakan Developer yang berlaku saat menggunakan Pesan Marketing atau fitur Platform Messenger lainnya

• Anda hanya bisa mengirimkan permintaan persetujuan keikutsertaan kepada pengguna untuk menerima Pesan Marketing dalam periode berkirim pesan standar. Tindakan pengguna yang menyetujui Pesan Marketing tidak menutup periode berkirim pesan standar

• Aplikasi dan/atau pengalaman berkirim pesan dari Anda tidak boleh menerima banyak masukan negatif dari pengguna. Kemampuan berkirim pesan dapat dibatasi atau dihapus jika kami menentukan bahwa pengalaman berkirim pesan aplikasi Anda telah menerima tingkat masukan negatif yang berlebihan dari pengguna

• Anda tidak boleh menggunakan Pesan Marketing, termasuk permintaan menyetujui, untuk mengirim spam kepada pengguna. Hal ini mencakup pengiriman permintaan persetujuan duplikat pada frekuensi tinggi kepada pengguna yang sama atau pengguna lain dan jenis spam lainnya seperti yang didefinisikan oleh Kebijakan Developer kami

• Anda harus menghormati batasan yang telah kami tetapkan pada fungsi Platform Messenger dan Pesan Marketing agar bisa tetap menggunakan lingkup layanan yang kami sediakan kepada Anda

Batasan

• Anda hanya dapat mengirim satu permintaan persetujuan keikutsertaan kepada seseorang per minggu dengan judul spesifik yang sama. Ini mencakup nilai default "Pembaruan dan promosi".
• Jangan mengirim permintaan persetujuan keikutsertaan duplikat kepada seseorang. Permintaan persetujuan keikutsertaan duplikat didefinisikan sebagai permintaan yang memiliki title yang sama untuk notifikasi dari Halaman Facebook atau title dan image_url yang sama untuk notifikasi dari akun Profesional Instagram
• Anda hanya bisa mengirim permintaan persetujuan selama periode berkirim pesan standar
• Jika seseorang ikut serta untuk menerima pesan marketing, tindakan ini tidak membuka periode berkirim pesan standar
• Anda hanya dapat melihat apakah seseorang telah ikut serta untuk menerima pesan marketing tetapi bukan status untuk permintaan persetujuan keikutsertaan yang masih menunggu persetujuan
• Jika seseorang telah memilih untuk berhenti menerima pesan marketing, notifikasi Anda tidak akan lagi dikirimkan kepada orang tersebut dan Anda akan menerima kesalahan
• Seseorang dapat memblokir, membuat senyap, atau melaporkan pesan Anda
• Untuk pesan marketing yang dikirim dari akun Profesional Instagram, umumnya, hingga 10 permintaan persetujuan keikutsertaan dengan judul yang berbeda dapat dikirim per pengguna selama periode 7 hari. Batas sub hingga 5 permintaan persetujuan bisa dikirim ke satu pengguna dalam sehari. Namun, Anda harus mempertimbangkan apakah pengguna cenderung menemukan setiap permintaan keikutsertaan relevan dan berharga sebelum mengirimkannya.

Persyaratan dan batasan ini bisa berubah karena kami selalu berusaha untuk memberikan pengalaman terbaik bagi pengguna dan bisnis.

Praktik Terbaik

Anda harus mengirim kepada orang-orang Pesan Marketing yang relevan dan bernilai, untuk menciptakan pengalaman pengguna yang berkualitas tinggi dengan melakukan hal berikut:

• Permintaan persetujuan keikutsertaan, termasuk judul dan gambar, mencakup berbagai jenis Pesan Marketing sesuai harapan pengguna, seperti info terbaru pesanan, rekomendasi produk, atau promo tertentu

• Saat mengirimkan lebih dari satu permintaan keikutsertaan kepada pengguna, setiap permintaan keikutsertaan harus menyatakan dengan jelas jenis Pesan Marketing yang berbeda dan spesifik yang bisa diharapkan untuk diterima pengguna

Pesan Pemasaran harus relevan dan disesuaikan dengan kasus penggunaan yang mungkin dianggap berharga oleh pengguna.

Pengguna bisa memberikan masukan tentang pengalaman berkirim pesan dengan Anda, termasuk dengan memblokir berkirim pesan dengan Anda, yang dapat mengakibatkan pembatasan dalam penggunaan Pesan Marketing Anda. Anda harus meninjau permintaan keikutsertaan dan Pesan Pemasaran Anda secara berkala untuk melihat apakah permintaan tersebut memenuhi praktik terbaik di atas.

Masa tunggu pengiriman pesan

Ada masa tunggu pengiriman pesan subscription_token 24 jam. Ini berarti pesan marketing yang dikirim menggunakan subscription_token yang sama memerlukan interval 24 jam di antara pengiriman.

Mulai 1 September 2025, masa tunggu pengiriman pesan subscription_token akan berubah dari mengizinkan satu pengiriman per pelanggan setiap 24 jam menjadi satu pengiriman setiap 48 jam.

Berlaku untuk token pesan notifikasi yang dibuat sebelum 2 Februari 2023.

• Setelah seseorang menyetujui, Anda bisa mengirim pesan kepada orang tersebut dengan frekuensi harian, mingguan, atau bulanan tergantung pada frekuensi yang dipilih orang tersebut selama menyetujui.

Meminta Izin untuk Mengirim Pesan Marketing

Seseorang harus memberikan izin, menyetujui, untuk menerima pesan marketing dari Halaman Facebook atau akun Profesional Instagram Anda. Platform Messenger menawarkan banyak cara agar Anda mendapatkan persetujuan. Anda bisa membuat permintaan persetujuan ke dalam pengalaman pengiriman pesan berikut:

• Iklan yang Klik ke Messenger – ketika seseorang mengklik iklan Anda
• Plugin Kotak Centang – ketika seseorang mengklik kotak centang dalam formulir dan mengirimkan formulir
• m.me Tautan – ketika seseorang mengeklik m.me tautan di situs web, email, postingan media sosial, dan banyak lagi
• Balasan pribadi – ketika seseorang menerbitkan postingan pengunjung atau komentar ke Halaman Facebook bisnis Anda
• Kode QR – ketika seseorang memindai Kode QR Anda pada permukaan digital dan cetak (didukung oleh m.me Tautan)
• Plugin Kirim ke Messenger – ketika seseorang memulai percakapan menggunakan daftar tombol atau teks CTA yang telah ditentukan sebelumnya

Contoh Permintaan Menyetujui

Untuk mengirim permintaan persetujuan ikut serta pesan marketing, kirimkan permintaan POST ke endpoint /PAGE-ID/messages dengan jenis template pesan diatur ke notification_messages. ID Halaman adalah ID untuk Halaman Facebook Anda atau Halaman Facebook yang tertaut dengan akun Profesional Instagram Anda.

Catatan: Parameter title wajib untuk pesan marketing yang berisi carousel dari Halaman Facebook atau akun Profesional Instagram Anda .

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID-OR-IGSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
         "notification_messages_timezone": "UTC",
         "title":"TITLE",
         "image_url":"IMAGE-URL",
         "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Jika berhasil, aplikasi Anda menerima tanggapan JSON berikut yang menyertakan ID untuk penerima dan pesan.

{ 
        "recipient": {
          "id":"PSID-OR-IGSID",
          "message_id":"MESSAGE-ID",
}

Referensi Objek Lampiran Pesan

Objek JSON messageattachment harus disertakan dalam POST permintaan ke endpoint /PAGE-ID/messages untuk permintaan menyetujui pesan marketing.

Token Pesan Notifikasi

Ketika seseorang menyetujui, bisnis Anda akan menerima notifikasi Webhooks messaging_optin dengan token pesan notifikasi dan informasi seperti judul pesan dan zona waktu dari orang yang menyetujui. Dengan token pesan notifikasi, Anda bisa mengirim pesan marketing kepada orang tersebut.

Notifikasi Webhooks Persetujuan

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
      "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
      "notification_messages_timezone": "TIMEZONE-ID",
      "token_expiry_timestamp": "TIMESTAMP",
      "user_token_status": "TOKEN-STATUS"  
      "notification_messages_status": "MESSAGE-STATUS", 
      "title": "TITLE-FOR-THE-NOTIFICATION"
    }
}

Tanggal kedaluwarsa token akan diperpanjang untuk orang-orang yang memilih untuk tetap menyetujui menerima pesan marketing. Orang bisa menolaknya kapan saja.

Pesan Tindak Lanjut Menyetujui

Setelah seseorang telah menyetujui untuk menerima pesan marketing, Anda dapat mengirim hingga tiga pesan tindak lanjut. Pesan-pesan ini harus dikirim dalam waktu dua menit dari pesan tindak lanjut pertama. Pesan tindak lanjut kedua dan ketiga tidak boleh melebihi 250 karakter. Pesan tindak lanjut ini dapat dikirim di luar periode berkirim pesan standar 24 jam.

Untuk mengirim pesan tindak lanjut, kirim permintaan POST ke endpoint /PAGE-ID/messages dengan objek recipient yang berisi token pesan notifikasi dan objek message yang berisi teks pesan tindak lanjut. Sintaksis untuk permintaan API ketiga pesan tindak lanjut adalah sama.

Contoh Permintaan

curl -X POST -H "Content-Type: application/json" -d 
    '{ 
        "recipient":{ 
            "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN" 
        }, 
        "message":{ 
            "text":FOLLOWUP-MESSAGE-TEXT-HERE, 
        } 
    }' 
"https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=TOKEN"

Mendapatkan Daftar Token

Untuk mendapatkan daftar semua token pesan notifikasi yang valid, kirim permintaan GET ke endpoint /PAGE-ID/notification_message_tokens.

Contoh Permintaan

curl -i -X GET "https://graph.facebook.com/API-VERSION-NUMBER/PAGE-ID/notification_message_tokens
    ?access_token=PAGE-ACCESS-TOKEN"

Daftar hingga 25 token diberikan secara default dan diurutkan berdasarkan waktu diperbarui. Untuk membaca selengkapnya, Anda bisa menambahkan parameter limit. Saat ini, ada batas 100 token yang dapat diberikan. Anda dapat menggunakan parameter after untuk paginasi, namun parameter before tidak tersedia.

Jika berhasil, aplikasi Anda akan menerima tanggapan JSON berikut, yang mencakup token, ID penerima baik ID lingkup Instagram atau ID lingkup Halaman, waktu pembuatan token, judul notifikasi, dan waktu saat Anda bisa mengirim pesan marketing berikutnya ke penerima tersebut.

{
  "data":[
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-1",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-1",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    },
...
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-25",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-25",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    }
  ],
  "paging":{"cursors":{"before":"QVFIU...","after":"QVFIU..."},"next":"https:\/\/graph.facebook.com\/LATEST-API-VERSION\/PAGE-ID\/notification_message_tokens?access_token=PAGE-ACCESS-TOKEN"}
}

Mendapatkan Informasi Token

Meski kami merekomendasikan penggunaan Webhooks messaging_optin untuk mengumpulkan informasi pesan marketing, Anda dapat mengirim permintaan GET ke endpoint token tempat token Anda ditambahkan ke notification_messages_, notification_messages_NOTIFICATION-MESSAGES-TOKEN, untuk mendapatkan informasi token.

Contoh Permintaan

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/notification_messages_NOTIFICATION-MESSAGES-TOKEN
    ?access_token=PAGE-ACCESS-TOKEN"

Jika berhasil, aplikasi Anda akan menerima tanggapan JSON berikut yang menyertakan token pesan notifikasi, ID penerima pesan, dan informasi token lainnya. Anda akan menggunakan token pesan notifikasi dan ID penerima kirim pesan marketing.

{
  "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN",
  "recipient_id": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "creation_timestamp": "TIMESTAMP",
  "token_expiry_timestamp": "TIMESTAMP",
  "user_token_status": "REFRESHED",
  "notification_messages_reoptin": "ENABLED",
  "notification_messages_timezone": "TIMEZONE-ID"
  "next_eligible_time": TIMESTAMP
}

Panggilan API ini akan dihitung terhadap batas laju aplikasi Anda.

Mengirim pesan marketing

Sebelum Memulai

Anda akan memerlukan:

• Token pesan notifikasi dari orang yang telah menyetujui untuk menerima notifikasi
• ID untuk Halaman Facebook bisnis Anda
• Token akses Halaman yang diminta dari orang yang bisa melakukan tugas MESSAGING di Halaman
• Izin pages_messaging, menggunakan Facebook Login
• Aset apa pun yang akan disertakan dalam pesan marketing
• Langganan webhook messaging_referrals untuk aplikasi Anda

Untuk mengirim pesan marketing, kirim permintaan POST ke endpoint /PAGE-ID/messages dengan nilai NOTIFICATION-MESSAGES-TOKEN penerima dan informasi pesan di lampiran pesan.

Batasan

• Anda hanya bisa mengirim satu pesan per hari per token pesan notifikasi. Jika Anda mengirim banyak pesan, pastikan untuk menunda pesan berikutnya selama 24 jam atau Anda akan menerima pesan kesalahan. (Tidak berlaku untuk pesan Tindak Lanjut Menyetujui.)

Rekomendasi

• Kami sangat menyarankan untuk memeriksa zona waktu penerima saat mengirim pesan marketing untuk memastikan pesan diterima pada waktu yang sesuai bagi penerima.

Contoh Permintaan

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://raw.githubusercontent.com/fbsamples/original-coast-clothing/main/public/styles/male-work.jpg",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://www.originalcoastclothing.com/",
              "webview_height_ratio": "tall"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://www.originalcoastclothing.com/",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"ADDITIONAL-WEBHOOK-INFORMATION"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Setelah berhasil, aplikasi Anda akan menerima tanggapan berikut:

{ 
  "recipient": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "message_id": "MESSAGE-ID"      
}

Uji Pesan Marketing

Anda bisa menguji pesan marketing Anda kapan saja.

Sebelum Memulai

Anda akan memerlukan:

• Seseorang, penguji, untuk menerima notifikasi. Orang ini harus memiliki peran pada aplikasi tersebut.

Uji Persetujuan

Anda bisa menguji pesan marketing Anda kapan saja dengan mengikuti langkah-langkah ini.

• Langkah 1. Kirimkan pesan kepada penguji dengan template menyetujui pesan marketing.
• Langkah 2. Pastikan penguji mengklik tombol menyetujui, seperti Menerima pesan penjualan diskon 50%, dalam percakapan.
• Langkah 3. Kirim pesan marketing pertama ke penguji Anda
• Langkah 4. Kirim pesan marketing lain segera setelah yang pertama dengan parameter developer_action diatur ke ENABLE_FOLLOWUP_MESSAGE.
• Langkah 5. Kirim pesan marketing lain ke penguji, ini adalah pesan uji Anda.

Contoh Permintaan

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

Jika berhasil, aplikasi Anda akan menerima tanggapan JSON berikut, berisi success diatur ke true.

{ "success": true }

Untuk menguji persetujuan ulang, ulangi langkah-langkah dengan parameter developer_action diatur ke SEND_RE_OPTIN di Langkah 4.

Langkah Berikutnya

• Notifikasi Webhooks Menyetujui Pengiriman Pesan
• Kunjungi ringkasan Jenis Pesan untuk mempelajari tentang berbagai jenis pesan yang bisa Anda kirim.

Lihat Juga

• Referensi Pesan Halaman untuk informasi selengkapnya tentang kolom yang tersedia untuk pesan berulang.
• Daftar Zona Waktu yang tersedia
• Kode Kesalahan untuk Platform Messenger