Pesan Marketing

Dokumen ini menunjukkan kepada Anda cara meminta izin dari seseorang untuk mengirim pesan marketing, 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 mengirimkan pesan dari API WhatsApp Business dan menerima masukan pelanggan untuk mengambil keputusan tentang model harga kami. Kami akan menginformasikan kepada pelanggan dan partner tentang perubahan apa pun pada uji coba gratis ini dengan banyak pemberitahuan awal.

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 untuk ikut serta menerima Pesan Marketing tidak membuka periode berkirim pesan standar

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

• Anda tidak boleh menggunakan Pesan Marketing, termasuk permintaan persetujuan keikutsertaan, untuk mengirimkan spam kepada pengguna. Ini termasuk mengirimkan permintaan persetujuan keikutsertaan duplikat dengan frekuensi tinggi kepada pengguna yang sama dan jenis spam lainnya sebagaimana ditentukan 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 termasuk 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 dapat mengirim permintaan persetujuan keikutsertaan 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. Sub-batas hingga 5 permintaan persetujuan keikutsertaan bisa dikirimkan kepada pengguna dalam sehari. Namun, Anda harus mempertimbangkan apakah pengguna kemungkinan menganggap setiap permintaan persetujuan keikutsertaan relevan dan berharga sebelum Anda mengirimnya.

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

Praktik Terbaik

Anda harus mengirimi orang-orang Pesan Marketing yang relevan dan berharga, 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 persetujuan keikutsertaan kepada pengguna, setiap permintaan harus menyatakan dengan jelas jenis spesifik Pesan Marketing yang berbeda, sesuai harapan pengguna

Pesan Marketing harus relevan dan disesuaikan dengan kasus penggunaan yang kemungkinan besar dianggap penting oleh pengguna.

Pengguna bisa memberikan masukan tentang pengalaman berkirim pesan dari Anda, termasuk dengan memblokir pesan Anda, yang bisa mengakibatkan dibatasinya penggunaan Pesan Marketing Anda. Anda harus secara rutin meninjau permintaan persetujuan keikutsertaan dan Pesan Marketing Anda untuk mengetahui apakah sudah memenuhi praktik terbaik di atas.

Frekuensi Pesan

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

• Setelah seseorang setuju ikut serta, Anda dapat mengirim pesan kepada orang tersebut dengan frekuensi harian, mingguan, atau bulanan tergantung frekuensi yang dipilih orang itu.

Meminta Izin untuk Mengirim Pesan Marketing

Seseorang harus memberikan izin, ikut serta, untuk menerima pesan marketing dari Halaman Facebook atau akun Profesional Instagram Anda. Platform Messenger menawarkan banyak cara agar Anda mendapatkan persetujuan keikutsertaan. Anda dapat membuat permintaan persetujuan keikutsertaan ke pengalaman berkirim pesan berikut:

• Iklan yang Mengarahkan ke Messenger – saat seseorang mengeklik iklan Anda
• Plugin Obrolan – ketika seseorang memulai percakapan menggunakan plugin obrolan di situs web Anda
• Plugin Kotak Centang – ketika seseorang mengeklik kotak centang di formulir dan mengirimkan formulir
• Tautan m.me – saat seseorang mengeklik tautan m.me di situs web Anda, email, pos media sosial, dan lainnya
• 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 Tautan m.me)
• Plugin Kirim ke Messenger –ketika seseorang memulai percakapan menggunakan daftar tombol atau teks CTA yang telah ditentukan

Contoh Permintaan Persetujuan Keikutsertaan

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 ke 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 akan menerima tanggapan JSON berikut dengan ID penerima dan ID pesan.

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

Referensi Objek Lampiran Pesan

Objek JSON messageattachment harus disertakan dalam permintaan POST ke /PAGE-ID/messages untuk permintaan persetujuan ikut serta pesan marketing.

Token Pesan Notifikasi

Ketika seseorang setuju ikut serta, bisnis Anda akan menerima notifikasi Webhooks messaging_optin dengan token pesan notifikasi dan informasi seperti judul pesan dan zona waktu dari orang yang ikut serta. Token pesan notifikasi memungkinkan Anda untuk mengirimkan pesan marketing kepada orang tersebut.

Notifikasi Webhooks Ikut Serta

{
  "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 bagi orang-orang yang memilih untuk tetap ikut serta menerima pesan marketing. Orang bisa menolaknya kapan saja.

Pesan Tindak Lanjut Keikutsertaan

Setelah seseorang setuju ikut serta untuk menerima pesan marketing, Anda dapat mengirimkan 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 dapat menambahkan parameter limit. Saat ini, ada batas 100 token yang dapat diberikan. Anda dapat menggunakan parameter after untuk paginasi, tetapi parameter before tidak tersedia.

Jika berhasil, aplikasi Anda akan menerima tanggapan JSON berikut termasuk token, ID penerima (baik ID lingkup Instagram atau ID lingkup Halaman), waktu pembuatan token, judul notifikasi, dan waktu saat Anda dapat 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 untuk mengirim 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 ikut serta untuk menerima notifikasi
• ID Halaman Facebook bisnis Anda
• Token akses Halaman yang diminta dari seseorang yang dapat melakukan tugas MESSAGING di Halaman
• Izin pages_messaging, menggunakan Facebook Login
• Aset apa pun yang disertakan dalam pesan marketing
• Langganan Webhooks 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 Keikutsertaan.)

Rekomendasi

• Kami sangat merekomendasikan untuk merujuk ke zona waktu penerima saat mengirim pesan marketing untuk memastikan pesan diterima pada waktu yang tepat 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"      
}

Menguji Pesan Marketing

Anda dapat menguji pesan marketing Anda kapan saja.

Sebelum Memulai

Anda akan memerlukan:

• Seseorang, si penguji, menerima notifikasi. Orang ini harus memiliki peran di aplikasi.

Menguji Keikutsertaan

Anda dapat menguji pesan marketing Anda kapan saja dengan mengikuti langkah-langkah berikut.

• Langkah 1. Kirim pesan kepada penguji Anda dengan template persetujuan ikut serta pesan marketing.
• Langkah 2. Pastikan penguji mengeklik tombol ikut serta, seperti Menerima pesan penjualan diskon 50%, dalam percakapan.
• Langkah 3. Kirim pesan marketing pertama kepada 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 lainnya kepada 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 ikut serta ulang, ulangi langkah-langkah dengan parameter developer_action diatur ke SEND_RE_OPTIN di Langkah 4.

Langkah Berikutnya

• Notifikasi Webhooks Ikut Serta Berkirim Pesan
• Kunjungi Ringkasan Jenis Pesan untuk mempelajari tentang berbagai jenis pesan yang dapat 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