MasukMulai uji coba gratis
easyCoexistence API resmi

Messenger Send API: mengirim pesan dari Halaman Facebook

Halaman Facebook mengirim pesan Messenger dengan POST /{page-id}/messages dan token akses Halaman. Penerima membawa ID yang dibatasi Halaman milik orang tersebut (PSID). messaging_type berupa RESPONSE atau UPDATE di dalam jendela pesan standar, atau MESSAGE_TAG setelahnya. message berisi teks atau lampiran seperti gambar, audio, video, atau file. Meta membalas dengan recipient_id dan message_id.

easyCoexistence membalas DM di Messenger dengan send_social_dm dari Claude, ChatGPT, atau kode Anda sendiri di dalam jendela layanan pelanggan 24 jam, sebagai teks; media, quick_replies, dan template tidak tercakup.

300 per second

Panggilan Send API yang dapat dilakukan aplikasi per Halaman untuk pesan berisi teks, tautan, reaksi, dan stiker.

10 per second

Panggilan Send API yang dapat dilakukan aplikasi per Halaman untuk pesan yang berisi audio atau video.

25 MB

Aset terbesar yang disimpan Messenger Platform untuk dipakai ulang; gambar yang diunggah dari URL dibatasi 8 MB.

30 images

Jumlah gambar terbanyak yang dapat dimuat satu pesan dalam array attachments, satu-satunya jenis media yang diizinkan di sana.

90 days

Berapa lama attachment_id yang tersimpan berlaku sebelum media harus diunggah ulang.

Apa saja yang terdapat dalam permintaan Send API?

Meta menyebutkan enam komponen yang harus ada dalam sebuah pengiriman: ID Halaman pengirim, ID penerima, token akses dari Halaman tersebut, izin dari orang tersebut, jenis pesan, dan isinya. Permintaannya berupa POST JSON ke /{page-id}/messages, dan balasan kepada seseorang yang baru saja menulis terlihat seperti ini:

A text reply, and Meta's answer
POST /{page-id}/messages
{
  "recipient": { "id": "<PSID>" },
  "messaging_type": "RESPONSE",
  "message": { "text": "Your order ships tomorrow." }
}

{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }

ID mana yang dimasukkan ke recipient?

Biasanya PSID (ID yang dibatasi Halaman), yang diberikan Meta kepada seseorang saat pertama kali mengirim pesan ke Halaman; ID ini masuk sebagai sender.id di webhook messages. Objek recipient juga menerima jenis ID lain untuk kasus tertentu:

  • id: PSID, unik untuk orang tersebut dan Halaman tersebut.
  • user_ref: untuk seseorang yang memakai plugin atau tombol postback untuk mengirim pesan ke Halaman.
  • comment_id atau post_id: untuk balasan privat atas komentar atau kiriman pengunjung.
  • ID dari Facebook Login bersifat terikat aplikasi dan tidak berfungsi di Messenger Platform.

messaging_type apa yang sebaiknya dipakai sebuah pesan?

Jenis ini memberi tahu Meta mengapa pesan dikirim, dan menentukan kapan pengiriman diizinkan. Referensi pesan Halaman dari Meta mencantumkan empat nilai:

  • RESPONSE: balasan atas pesan yang diterima Halaman, promosi atau bukan, di dalam jendela pesan standar.
  • UPDATE: pesan yang dikirim Halaman atas inisiatifnya sendiri, promosi atau bukan, juga di dalam jendela tersebut.
  • MESSAGE_TAG: pesan non-promosi yang dikirim setelah jendela berakhir, dengan tag yang sesuai dengan kasus penggunaan yang disetujui.
  • UTILITY: pesan utilitas yang dibangun dari template yang disetujui, misalnya pembaruan pesanan atau janji temu.

Apa yang bisa dimuat sebuah pesan?

Teks, atau satu objek lampiran dengan type dan payload: lampiran gambar, audio, video, dan file mengarah ke URL atau attachment_id yang tersimpan, dan lampiran template membawa pesan terstruktur dengan tombol. Endpoint yang sama juga menerima berikut ini:

  • attachments: array berisi hingga 30 gambar yang dikirim sebagai satu pesan.
  • reply_to dengan mid: balasan atas pesan tertentu sebelumnya, milik orang tersebut atau milik Halaman.
  • quick_replies: hingga 13 tombol di atas kolom ketik, masing-masing dengan title hingga 20 karakter.
  • sender_action: indikator mengetik, tanda sudah dibaca, atau reaksi, dikirim dalam permintaan terpisah dari pesan itu sendiri.
  • notification_type: REGULAR secara default, atau SILENT_PUSH atau NO_PUSH.

Seberapa besar lampiran boleh berukuran?

Panduan Meta tentang menyimpan aset menetapkan batas untuk media yang diambil dan disimpan Messenger Platform: aset hingga 25 MB, gambar hingga 8 MB jika diunggah dari URL, audio yang dikirim dengan Content-Type audio, dan video yang diambil dalam 75 detik. Jika is_reusable diatur ke true, akan dikembalikan attachment_id yang hanya dapat dipakai ulang oleh Halaman yang mengirimnya, selama 90 hari, dan POST /{page-id}/message_attachments mengunggah media lebih dulu.

Berapa pembatasan laju Send API?

Meta menghitungnya per Halaman dan menurut jenis konten. Referensi pesan Halaman dari Meta mencantumkan 613, Calls to this api have exceeded the rate limit, di antara kesalahan pengiriman, jadi perlambat, jangan langsung mencoba kembali saat kode ini muncul:

  • 300 panggilan per detik per Halaman untuk pesan berisi teks, tautan, reaksi, dan stiker.
  • 10 panggilan per detik per Halaman untuk pesan berisi audio atau video.
  • Terlalu banyak pesan ke satu percakapan dapat dibatasi lajunya tersendiri.
  • Panggilan Messenger API secara keseluruhan: 200 kali jumlah pengguna yang terlibat, dalam 24 jam bergulir.
  • Di atas 40 pesan per detik, kotak masuk Halaman berhenti menampilkan pesan baru dan Halaman tidak dapat mengirim sampai volumenya turun.

Kesalahan apa yang dikembalikan Send API?

Tabel kesalahan Messenger dari Meta memasangkan setiap kode dengan subkode yang menyebutkan penyebabnya. Berikut yang paling sering dialami Halaman saat mengirim:

  • 10 dengan 2018278 atau 2534022: Pesan ini dikirim di luar jendela yang diizinkan.
  • 10 dengan 2018300: aplikasi lain mengendalikan percakapan.
  • 100: Parameter tidak valid, misalnya ID penerima yang salah; subkode 2018001 berbunyi No matching user found.
  • 551: orang tersebut tidak tersedia, mungkin karena memblokir Halaman atau menonaktifkan akunnya; 200 dengan 1545041 berbunyi This person isn't available right now.
  • 200 dengan 2018028: aplikasi tidak dapat mengirim pesan kepada orang di luar perannya sampai pages_messaging ditinjau dan aplikasi sudah aktif.
  • 10904: Halaman telah menonaktifkan pesan di pengaturan.

Bagaimana easyCoexistence mengirim melalui ini?

send_social_dm menerima account_id, recipient_id orang tersebut (yaitu sender.id dalam event pesan yang diteruskan), serta teks, lalu mengirimkannya ke /{page-id}/messages dengan messaging_type RESPONSE. Hasilnya berupa jawaban Meta dengan message_id, dan pengiriman yang ditolak kembali dengan kode dan pesan kesalahan dari Meta. Media, quick_replies, template, dan sender_action tidak termasuk dalam tool: send_social_dm mengirim teks.

Kesalahan umum

  • Mengirim indikator mengetik bersama pesan. Meta menginginkan sender_action sendiri bersama penerima, dan teks atau template dalam permintaan terpisah.
  • Mengirim lonjakan pesan ke satu orang. Meta dapat membatasi laju satu percakapan secara tersendiri, terpisah dari 300 panggilan per detik milik Halaman.
  • Mengirim audio atau video dengan laju teks. Pesan berisi audio atau video dibatasi 10 panggilan per detik per Halaman.
  • Memakai attachment_id yang lebih dari 90 hari. attachment_id yang tersimpan kedaluwarsa, jadi unggah ulang media untuk mendapatkan yang baru.
Melakukan ini dengan EasyCoexistence

Otomatisasi membalas pesan baru dengan sendirinya memakai teks tetap atau balasan AI. US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah Messenger Send API gratis?

Ya, untuk pesan standar. Ikhtisar Messenger dari Meta menyebut Messenger Platform gratis digunakan, sehingga Halaman yang membalas orang yang menulis kepadanya tidak membayar apa pun per pesan; pesan pemasaran dikenai biaya per pesan.

Tugas Halaman apa yang dibutuhkan untuk mengirim pesan?

Ikhtisar Messenger dari Meta meminta token Halaman dari seseorang yang dapat menjalankan tugas MESSAGING dan MODERATE, dengan izin pages_messaging sudah diberikan.

Dapatkah easyCoexistence membalas dengan gambar di Messenger?

Belum saat ini. send_social_dm mengirim teks, dan tidak ada tool yang mengirim lampiran.

Berapa biaya easyCoexistence untuk Halaman Facebook?

Setiap Halaman yang Anda hubungkan adalah satu koneksi, ditagih US$ 9 hingga US$ 0.75 per koneksi per bulan tergantung jumlahnya, dan 3 hari pertama gratis.

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