ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Messenger Send API: αποστολή μηνυμάτων από σελίδα Facebook

Μια σελίδα Facebook στέλνει μηνύματα Messenger με POST /{page-id}/messages και ένα token πρόσβασης Σελίδας. Το πεδίο recipient περιέχει το ID ανά Σελίδα (PSID) του ατόμου, το messaging_type είναι RESPONSE ή UPDATE μέσα στο τυπικό παράθυρο αποστολής ή MESSAGE_TAG μετά από αυτό, και το πεδίο message περιέχει κείμενο ή ένα συνημμένο, όπως εικόνα, ήχο, βίντεο ή αρχείο. Η Meta απαντά με το recipient_id και ένα message_id.

Το easyCoexistence απαντά σε DMs στο Messenger με το send_social_dm από το Claude, το ChatGPT ή τον δικό σας κώδικα μέσα στο παράθυρο 24 ωρών, ως κείμενο· τα πολυμέσα, οι γρήγορες απαντήσεις και τα templates δεν καλύπτονται.

300 per second

Κλήσεις Send API που μπορεί να κάνει μια εφαρμογή ανά Σελίδα για μηνύματα με κείμενο, συνδέσμους, αντιδράσεις και stickers.

10 per second

Κλήσεις Send API που μπορεί να κάνει μια εφαρμογή ανά Σελίδα για μηνύματα με ήχο ή βίντεο.

25 MB

Το μεγαλύτερο αρχείο που αποθηκεύει η Messenger Platform για επαναχρησιμοποίηση· μια εικόνα που ανεβαίνει από URL περιορίζεται σε 8 MB.

30 images

Ο μέγιστος αριθμός εικόνων που μπορεί να περιέχει ένα μήνυμα στον πίνακα attachments, ο μόνος τύπος πολυμέσων που επιτρέπεται εκεί.

90 days

Πόση ώρα ισχύει ένα αποθηκευμένο attachment_id πριν χρειαστεί να ανεβεί ξανά το πολυμέσο.

Τι περιέχει ένα αίτημα Send API;

Η Meta αναφέρει έξι στοιχεία που πρέπει να περιλαμβάνει μια αποστολή: το ID της Σελίδας που στέλνει, το ID του ατόμου που λαμβάνει, ένα token πρόσβασης από εκείνη τη Σελίδα, την άδεια του ατόμου, τον τύπο του μηνύματος και το περιεχόμενο. Το αίτημα είναι ένα POST με JSON στο /{page-id}/messages, και η απάντηση σε κάποιον που μόλις έγραψε μοιάζει με αυτό:

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 μπαίνει στο recipient;

Συνήθως το ID ανά Σελίδα, ή PSID, που η Meta αποδίδει σε ένα άτομο την πρώτη φορά που γράφει στη Σελίδα· φτάνει ως sender.id στο webhook των μηνυμάτων. Το αντικείμενο recipient δέχεται και άλλα είδη ID για συγκεκριμένες περιπτώσεις:

  • id: το PSID, μοναδικό για αυτό το άτομο και για τη Σελίδα αυτή.
  • user_ref: για κάποιον που χρησιμοποίησε ένα plugin ή ένα κουμπί postback για να γράψει στη Σελίδα.
  • comment_id ή post_id: για ιδιωτική απάντηση σε σχόλιο ή σε ανάρτηση επισκέπτη.
  • Τα IDs από το Facebook Login έχουν εύρος εφαρμογής και δεν λειτουργούν στη Messenger Platform.

Ποιο messaging_type πρέπει να έχει ένα μήνυμα;

Ο τύπος λέει στη Meta γιατί στέλνεται το μήνυμα, και καθορίζει πότε επιτρέπεται η αποστολή. Η τεκμηρίωση για τα μηνύματα Σελίδας της Meta απαριθμεί τέσσερις τιμές:

  • RESPONSE: απάντηση σε μήνυμα που έλαβε η Σελίδα, προωθητικό ή όχι, μέσα στο τυπικό παράθυρο αποστολής.
  • UPDATE: μήνυμα που στέλνει η Σελίδα με δική της πρωτοβουλία, προωθητικό ή όχι, επίσης μέσα στο παράθυρο.
  • MESSAGE_TAG: μη προωθητικό μήνυμα που στέλνεται μετά το παράθυρο, με ετικέτα που αντιστοιχεί σε εγκεκριμένη χρήση.
  • UTILITY: μήνυμα βοηθητικού τύπου που βασίζεται σε εγκεκριμένο template, όπως ενημέρωση παραγγελίας ή ραντεβού.

Τι μπορεί να περιέχει ένα μήνυμα;

Κείμενο ή ένα αντικείμενο συνημμένου με τύπο και το payload του: τα συνημμένα εικόνας, ήχου, βίντεο και αρχείου δείχνουν σε ένα URL ή σε ένα αποθηκευμένο attachment_id, ενώ τα συνημμένα τύπου template μεταφέρουν δομημένα μηνύματα με κουμπιά. Το ίδιο endpoint δέχεται και τα εξής:

  • attachments: πίνακας έως 30 εικόνων που στέλνονται ως ένα μήνυμα.
  • reply_to με mid: απάντηση σε ένα συγκεκριμένο προηγούμενο μήνυμα, του ατόμου ή της Σελίδας.
  • quick_replies: έως 13 κουμπιά πάνω από το πεδίο γραφής, καθένα με τίτλο έως 20 χαρακτήρων.
  • sender_action: ένδειξη πληκτρολόγησης, ένδειξη ανάγνωσης ή αντίδραση, που στέλνεται σε ξεχωριστό αίτημα από το ίδιο το μήνυμα.
  • notification_type: REGULAR προεπιλεγμένα, ή SILENT_PUSH ή NO_PUSH.

Πόσο μεγάλα μπορούν να είναι τα συνημμένα;

Ο οδηγός της Meta για την αποθήκευση περιουσιακών στοιχείων ορίζει τα όρια για τα πολυμέσα που η Messenger Platform ανακτά και κρατά: αρχεία έως 25 MB, εικόνες έως 8 MB όταν ανεβαίνουν από URL, ήχο που στέλνεται με Content-Type ήχου και βίντεο που ανακτάται μέσα σε 75 δευτερόλεπτα. Με is_reusable ίσο με true επιστρέφεται ένα attachment_id που μπορεί να το επαναχρησιμοποιήσει μόνο η Σελίδα που το έστειλε, για 90 ημέρες, και το POST /{page-id}/message_attachments ανεβάζει τα πολυμέσα εκ των προτέρων.

Ποια είναι τα όρια ρυθμού του Send API;

Η Meta τα μετρά ανά Σελίδα και ανά περιεχόμενο. Η τεκμηρίωση για τα μηνύματα Σελίδας αναφέρει το 613, «Οι κλήσεις σε αυτό το API ξεπέρασαν το όριο ρυθμού», μεταξύ των σφαλμάτων αποστολής, άρα όταν εμφανιστεί επιβραδύνετε αντί να ξαναδοκιμάζετε αμέσως:

  • 300 κλήσεις ανά δευτερόλεπτο ανά Σελίδα για μηνύματα με κείμενο, συνδέσμους, αντιδράσεις και stickers.
  • 10 κλήσεις ανά δευτερόλεπτο ανά Σελίδα για μηνύματα με ήχο ή βίντεο.
  • Πολλά μηνύματα προς ένα μόνο νήμα μπορεί να περιοριστούν αυτόνομα.
  • Συνολικές κλήσεις Messenger API: 200 φορές τον αριθμό των ενεργών χρηστών, σε κυλιόμενο διάστημα 24 ωρών.
  • Πάνω από 40 μηνύματα το δευτερόλεπτο, το εισερχόμενο κουτί της Σελίδας σταματά να εμφανίζει νέα μηνύματα και η Σελίδα δεν μπορεί να στείλει μέχρι να πέσει ο όγκος.

Ποια σφάλματα επιστρέφει το Send API;

Ο πίνακας σφαλμάτων του Messenger της Meta αντιστοιχίζει κάθε κωδικό με έναν υποκωδικό που ονομάζει την αιτία. Αυτά είναι τα πιο συχνά που συναντά μια Σελίδα όταν στέλνει:

  • 10 με 2018278 ή 2534022: «Το μήνυμα στάλθηκε εκτός του επιτρεπόμενου παραθύρου».
  • 10 με 2018300: άλλη εφαρμογή ελέγχει τη συνομιλία.
  • 100: Μη έγκυρη παράμετρος, όπως λάθος ID παραλήπτη· ο υποκωδικός 2018001 λέει «Δεν βρέθηκε αντίστοιχος χρήστης».
  • 551: το άτομο δεν είναι διαθέσιμο, ίσως επειδή έχει αποκλείσει τη Σελίδα ή απενεργοποιήσει τον λογαριασμό του· το 200 με 1545041 λέει «Αυτό το άτομο δεν είναι διαθέσιμο αυτή τη στιγμή».
  • 200 με 2018028: η εφαρμογή δεν μπορεί να στέλνει μηνύματα σε άτομα εκτός των ρόλων της μέχρι να εγκριθεί το pages_messaging και η εφαρμογή να γίνει ενεργή σε λειτουργία.
  • 10904: Τα μηνύματα της σελίδας είναι απενεργοποιημένα στις ρυθμίσεις.

Πώς στέλνει το easyCoexistence μέσω αυτού;

Το send_social_dm παίρνει το account_id, το recipient_id του ατόμου, που είναι το sender.id σε ένα προωθημένο γεγονός των μηνυμάτων, και το κείμενο, και τα στέλνει στο /{page-id}/messages με messaging_type RESPONSE. Το αποτέλεσμα είναι η απάντηση της Meta με το message_id, και μια αποστολή που απορρίπτεται επιστρέφει τον κωδικό σφάλματος και το μήνυμα της Meta. Τα πολυμέσα, οι γρήγορες απαντήσεις, τα templates και οι ενέργειες αποστολέα δεν περιλαμβάνονται στα tools: το send_social_dm στέλνει κείμενο.

Συνηθισμένα λάθη

  • Αποστολή ενδείξης πληκτρολόγησης μαζί με το μήνυμα. Η Meta θέλει το sender_action μόνο του με τον παραλήπτη, και το κείμενο ή τα templates σε ξεχωριστό αίτημα.
  • Ριπή μηνυμάτων προς ένα άτομο. Η Meta μπορεί να περιορίσει ένα νήμα αυτόνομα, ανεξάρτητα από τις 300 κλήσεις ανά δευτερόλεπτο της Σελίδας.
  • Αποστολή ήχου ή βίντεο με τον ρυθμό του κειμένου. Τα μηνύματα με ήχο ή βίντεο έχουν όριο 10 κλήσεων ανά δευτερόλεπτο ανά Σελίδα.
  • Επαναχρήση attachment_id παλαιότερου των 90 ημερών. Τα αποθηκευμένα attachment ID λήγουν, οπότε ανεβάστε ξανά το πολυμέσο για νέο.
Κάντε το με EasyCoexistence

Οι αυτοματισμοί απαντούν σε νέα μηνύματα μόνοι τους, με σταθερό κείμενο ή με απάντηση AI. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με δωρεάν δοκιμή τις πρώτες 3 ημέρες.

Συχνές ερωτήσεις

Είναι δωρεάν το Messenger Send API;

Ναι, για τυπικά μηνύματα. Η επισκόπηση του Messenger της Meta χαρακτηρίζει τη Messenger Platform δωρεάν για χρήση, οπότε μια Σελίδα που απαντά σε άτομα που της έγραψαν δεν πληρώνει τίποτα ανά μήνυμα· τα μηνύματα μάρκετινγκ χρεώνονται ανά μήνυμα.

Ποια εργασία της Σελίδας χρειάζεται η αποστολή μηνύματος;

Η επισκόπηση του Messenger της Meta ζητά token Σελίδας από κάποιον που μπορεί να εκτελεί τις εργασίες MESSAGING και MODERATE, με δοθείσα την άδεια pages_messaging.

Μπορεί το easyCoexistence να απαντά με εικόνες στο Messenger;

Όχι σήμερα. Το send_social_dm στέλνει κείμενο και κανένα tool δεν στέλνει συνημμένο.

Πόσο κοστίζει το easyCoexistence για μια σελίδα Facebook;

Κάθε Σελίδα που συνδέετε είναι μία σύνδεση, που χρεώνεται US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, ανάλογα με το πόσες έχετε, με δωρεάν δοκιμή τις πρώτες 3 ημέρες.

Συνεχίστε την ανάγνωση

Ετικέτες μηνυμάτων Messenger το 2026: τι μπορεί να στείλει μια Σελίδα Facebook μετά το παράθυρο 24 ωρώνΤι μπορεί να στείλει μια Σελίδα Facebook μετά το παράθυρο 24 ωρών του Messenger το 2026: HUMAN_AGENT, CUSTOMER_FEEDBACK και οι τρεις αποσυρμένες ετικέτες.Ανάγνωση του ιστορικού συνομιλιών Messenger μέσω του APIΔιαβάστε το ιστορικό Messenger μιας Σελίδας Facebook με το Conversations API: /{page-id}/conversations, πεδία, όριο 20 μηνυμάτων και δικαιώματα.Το παράθυρο 24 ωρών του Messenger: πότε μια Facebook Page μπορεί να στείλει μήνυμα σε κάποιονΠότε μια Facebook Page μπορεί να στείλει μήνυμα στο Messenger: τυπικό παράθυρο 24 ωρών, οι ενέργειες που το ανοίγουν και έως 7 ημέρες μετά από διαφήμιση.Πρωτόκολλο μεταβίβασης Messenger: κοινή χρήση του inbox μιας Σελίδας μεταξύ AI agent και ανθρώπωνΠώς μεταβιβάζονται οι συνομιλίες Messenger μιας Σελίδας Facebook μεταξύ εφαρμογών και του inbox: Conversation Routing, pass_thread_control και thread owner.Σφάλμα Facebook 10: άρνηση άδειας ή μήνυμα εκτός επιτρεπόμενου παραθύρουΣφάλμα Facebook 10: η εφαρμογή δεν έχει άδεια για την ενέργεια ή, στο Messenger, το μήνυμα εστάλη εκτός παραθύρου. Λύσεις και για τις δύο περιπτώσεις.Σφάλμα Facebook 551: το άτομο δεν είναι διαθέσιμο στο MessengerΣφάλμα Facebook 551: το Messenger δεν μπόρεσε να φτάσει σε κάποιον που μπορεί να έχει μπλοκάρει τη Σελίδα ή να έχει απενεργοποιήσει τον λογαριασμό του.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις