Messenger Send API: menghantar mesej dari Halaman Facebook
Halaman Facebook menghantar mesej Messenger dengan POST /{page-id}/messages dan token akses Halaman. Penerima membawa ID dalam skop Halaman bagi setiap orang (PSID). messaging_type ialah RESPONSE atau UPDATE dalam tetingkap mesej standard, atau MESSAGE_TAG selepas tetingkap itu. Medan message memuat teks atau lampiran seperti imej, audio, video atau fail. Meta membalas dengan recipient_id dan message_id.
easyCoexistence membalas DM pada Messenger dengan send_social_dm daripada Claude, ChatGPT atau kod anda sendiri dalam tetingkap 24 jam, sebagai teks; media, balasan pantas dan template tidak dilindungi.
Panggilan Send API yang boleh dibuat oleh aplikasi bagi setiap Halaman untuk mesej dengan teks, pautan, reaksi dan pelekat.
Panggilan Send API yang boleh dibuat oleh aplikasi bagi setiap Halaman untuk mesej yang mengandungi audio atau video.
Aset terbesar yang Messenger Platform simpan untuk guna semula; imej yang dimuat naik dari URL dihadkan kepada 8 MB.
Jumlah imej paling banyak yang boleh dibawa oleh satu mesej dalam tatasusunan attachments, satu-satunya jenis media yang dibenarkan di situ.
Tempoh sah bagi attachment_id yang disimpan sebelum media perlu dimuat naik semula.
Apakah yang terkandung dalam permintaan Send API?
Meta menyenaraikan enam komponen yang mesti ada dalam penghantaran: ID Halaman pengirim, ID penerima, token akses daripada Halaman itu, kebenaran daripada orang tersebut, jenis mesej, serta kandungan. Permintaan ialah POST JSON ke /{page-id}/messages, dan balasan kepada seseorang yang baru menulis kelihatan seperti ini:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }ID manakah yang dimasukkan dalam recipient?
Biasanya ID dalam skop Halaman (PSID) yang Meta berikan kepada seseorang kali pertama mereka menghantar mesej kepada Halaman itu; ia tiba sebagai sender.id dalam webhook mesej. Objek recipient juga menerima jenis ID lain untuk kes tertentu:
- id: PSID, unik kepada orang itu dan Halaman itu.
user_ref: bagi seseorang yang menggunakan plugin atau butang postback untuk menghubungi Halaman.comment_idataupost_id: bagi balasan peribadi kepada komen atau catatan pelawat.- ID daripada Facebook Login berskop aplikasi dan tidak berfungsi pada Messenger Platform.
Apakah messaging_type yang sepatutnya digunakan untuk sesuatu mesej?
Jenis ini memberitahu Meta sebab mesej dihantar, dan ia menentukan bila penghantaran dibenarkan. Rujukan mesej Halaman Meta menyenaraikan empat nilai:
- RESPONSE: balasan kepada mesej yang diterima Halaman, sama ada promosi atau tidak, dalam tetingkap mesej standard.
- UPDATE: mesej yang Halaman hantar atas inisiatif sendiri, sama ada promosi atau tidak, juga dalam tetingkap itu.
MESSAGE_TAG: mesej bukan promosi yang dihantar selepas tetingkap, dengan tag yang sepadan dengan kes penggunaan yang diluluskan.- UTILITY: mesej utiliti yang dibina daripada template yang diluluskan, seperti kemas kini pesanan atau temu janji.
Apakah yang boleh dibawa oleh sesuatu mesej?
Teks, atau satu objek lampiran dengan jenis dan payload: lampiran imej, audio, video dan fail menunjuk ke URL atau attachment_id yang disimpan, dan lampiran template membawa mesej berstruktur dengan butang. Endpoint yang sama turut menerima perkara berikut:
- attachments: tatasusunan sehingga 30 imej yang dihantar sebagai satu mesej.
reply_todengan mid: balasan kepada mesej tertentu yang terdahulu, sama ada milik orang itu atau Halaman.quick_replies: sehingga 13 butang di atas ruang tulis, setiap tajuk sehingga 20 aksara.sender_action: penunjuk menaip, tanda telah dibaca atau reaksi, dihantar dalam permintaan berasingan daripada mesej itu sendiri.notification_type: REGULAR secara lalai, atauSILENT_PUSHatauNO_PUSH.
Berapakah had saiz lampiran?
Panduan Meta untuk menyimpan aset menetapkan had bagi media yang diambil dan disimpan oleh Messenger Platform: aset sehingga 25 MB, imej sehingga 8 MB apabila dimuat naik dari URL, audio yang dihantar dengan Content-Type audio, dan video yang diambil dalam tempoh 75 saat. Menetapkan is_reusable kepada true memulangkan attachment_id yang hanya boleh digunakan semula oleh Halaman yang menghantarnya, selama 90 hari, dan POST /{page-id}/message_attachments memuat naik media lebih awal.
Apakah had kadar bagi Send API?
Meta mengira had mengikut Halaman dan mengikut jenis kandungan. Rujukan mesej Halaman Meta menyenaraikan 613, Calls to this api have exceeded the rate limit, antara ralat penghantaran, jadi perlahankan dan jangan cuba semula serta-merta apabila ia muncul:
- 300 panggilan sesaat bagi setiap Halaman untuk mesej dengan teks, pautan, reaksi dan pelekat.
- 10 panggilan sesaat bagi setiap Halaman untuk mesej dengan audio atau video.
- Terlalu banyak mesej kepada satu urutan perbualan boleh dihadkan kadarnya dengan sendiri.
- Jumlah panggilan Messenger API keseluruhan: 200 kali bilangan pengguna yang terlibat, dalam tempoh 24 jam bergolek.
- Melebihi 40 mesej sesaat, peti masuk Halaman berhenti memaparkan mesej baharu dan Halaman tidak dapat menghantar sehingga jumlahnya menurun.
Apakah ralat yang dikembalikan oleh Send API?
Jadual ralat Messenger Meta memadankan setiap kod dengan subkod yang menamakan punca. Inilah yang paling kerap dihadapi Halaman apabila menghantar:
- 10 dengan 2018278 atau 2534022: Mesej ini dihantar di luar tetingkap yang dibenarkan.
- 10 dengan 2018300: aplikasi lain mengawal perbualan.
- 100: Parameter tidak sah, seperti ID penerima yang salah; subkod 2018001 berbunyi No matching user found.
- 551: orang itu tidak tersedia, mungkin kerana menyekat Halaman atau menyahaktifkan akaun mereka; 200 dengan 1545041 berbunyi This person isn't available right now.
- 200 dengan 2018028: aplikasi tidak boleh menghubungi orang di luar peranannya sehingga
pages_messagingdisemak dan aplikasi dilancarkan. - 10904: Halaman itu telah mematikan mesej dalam tetapan.
Bagaimanakah easyCoexistence menghantar melalui ini?
send_social_dm mengambil account_id, recipient_id penerima, iaitu sender.id dalam peristiwa mesej yang dimajukan, dan teks, lalu menghantarnya ke /{page-id}/messages dengan messaging_type RESPONSE. Hasilnya ialah jawapan Meta dengan message_id, dan penghantaran yang ditolak kembali dengan kod ralat dan mesej Meta. Media, balasan pantas, template dan tindakan pengirim tiada dalam tool: send_social_dm menghantar teks.
Kesilapan biasa
- Menghantar penunjuk menaip bersama mesej. Meta mahu sender_action sahaja bersama penerima, dan teks atau template dalam permintaan berasingan.
- Menghantar banjiran mesej kepada seorang individu. Meta boleh menghadkan kadar satu urutan perbualan secara berasingan, selain daripada 300 panggilan sesaat Halaman.
- Menghantar audio atau video pada kadar teks. Mesej dengan audio atau video dihadkan kepada 10 panggilan sesaat bagi setiap Halaman.
- Menggunakan semula attachment_id yang berusia lebih 90 hari. ID lampiran yang disimpan tamat tempoh, jadi muat naik semula media untuk mendapatkan yang baharu.
Automasi membalas mesej baharu dengan sendirinya menggunakan teks tetap atau balasan AI. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari pertama.
Soalan lazim
Adakah Messenger Send API percuma?
Ya, untuk mesej standard. Gambaran keseluruhan Meta menyatakan Messenger Platform percuma digunakan, jadi Halaman yang membalas orang yang menghubunginya tidak membayar apa-apa bagi setiap mesej; mesej pemasaran dicaj per mesej.
Tugasan Halaman apakah yang diperlukan untuk menghantar mesej?
Gambaran keseluruhan Messenger Meta meminta token Halaman daripada seseorang yang boleh melaksanakan tugas MESSAGING dan MODERATE, dengan kebenaran pages_messaging diberikan.
Bolehkah easyCoexistence membalas dengan imej di Messenger?
Tidak buat masa ini. send_social_dm menghantar teks, dan tiada tool yang menghantar lampiran.
Berapakah kos easyCoexistence untuk Halaman Facebook?
Setiap Halaman yang anda sambungkan ialah satu sambungan, dikenakan daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan bergantung pada jumlah yang anda ada, dan 3 hari pertama adalah percubaan percuma.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada