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

Messenger profile API: χαιρετισμός, Get Started, ice breakers και μόνιμο μενού

Το Messenger profile μιας Σελίδας Facebook ορίζεται μέσω του /{page-id}/messenger_profile, με ένα token πρόσβασης της Σελίδας και το pages_messaging. Το POST γράφει ιδιότητες όπως τα get_started, greeting, ice_breakers, persistent_menu και commands, το GET τις διαβάζει με fields, και το DELETE αφαιρεί όσες αναφέρονται σε έναν πίνακα fields. Η Meta επιτρέπει 10 κλήσεις ανά 10 λεπτά ανά Σελίδα, και ενημερώνονται μόνο οι ιδιότητες που στέλνονται.

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

10 per 10 min

Κλήσεις του Messenger Profile API που επιτρέπονται ανά Σελίδα σε κάθε διάστημα 10 λεπτών.

4 questions

Ο μέγιστος αριθμός ice breakers που ορίζει το API. Όταν ορίζονται και τα δύο, τα ice breakers του API υπερισχύουν του κουμπιού Get Started.

20 items

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

24 hours

Πόση ώρα μπορεί να χρειαστεί μια ενημέρωση του μενού σε επίπεδο Σελίδας. Ένα μενού για ένα άτομο ενημερώνεται σε πραγματικό χρόνο.

Deprecated

Το κείμενο του χαιρετισμού, για το οποίο η τεκμηρίωση της Meta αναφέρει ότι δεν λειτουργεί πλέον σε Messenger για Android και iOS.

Τι περιέχει το Messenger profile;

Οι ρυθμίσεις από τις οποίες ξεκινά η εμπειρία Messenger μιας Σελίδας. Το Messenger Profile API της Meta απαριθμεί αυτές τις ιδιότητες, καθεμία ορίζεται και διαβάζεται στο ίδιο endpoint. Για μια εφαρμογή σε Development Mode, οι ρυθμίσεις είναι ορατές μόνο στα άτομα που έχουν ρόλο στην εφαρμογή:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

Πώς διαβάζονται, ορίζονται και διαγράφονται οι ιδιότητες;

Με τρεις μεθόδους σε ένα endpoint, που καλούνται με το token της Σελίδας. Το POST δέχεται ένα σώμα JSON με ιδιότητες και αντικαθιστά μόνο όσες αναφέρει, το GET δέχεται το fields ως λίστα χωρισμένη με κόμματα, και το DELETE δέχεται ένα σώμα JSON του οποίου ο πίνακας fields ορίζει τι θα αφαιρεθεί. Τα POST και DELETE απαντούν με result success. Ορισμός ενός κουμπιού Get Started και ενός μενού σε μία κλήση:

Get Started and a persistent menu in one POST
POST /{page-id}/messenger_profile
{
  "get_started": { "payload": "GET_STARTED" },
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        { "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
        { "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
      ]
    }
  ]
}

{ "result": "success" }

Πώς λειτουργεί το κουμπί Get Started;

Βρίσκεται στην οθόνη καλωσορίσματος, η οποία εμφανίζει το όνομα της Σελίδας, τη φωτογραφία προφίλ και το εξώφυλλο, καθώς και πόση ώρα συνήθως χρειάζεται η επιχείρηση για να απαντήσει. Με ένα πάτημα, το Get Started αποστέλλεται στη συνομιλία, το get_started.payload στέλνεται στην εφαρμογή ως γεγονός messaging_postbacks και ανοίγει το τυπικό παράθυρο μηνυμάτων. Η Meta σημειώνει ότι το κουμπί δεν υποστηρίζεται όταν το Messenger τρέχει στο ενσωματωμένο πρόγραμμα περιήγησης της εφαρμογής Facebook, και ότι ένα μόνιμο μενού προϋποθέτει να έχει οριστεί πρώτα αυτό.

Ισχύει ακόμη το κείμενο χαιρετισμού;

Όχι στα κινητά. Η τεκμηρίωση της Meta φέρει πλέον τον τίτλο [Deprecated] Greeting Text: η λειτουργία δεν δουλεύει πια στο Messenger για Android και iOS. Ενώ το API ενδέχεται να δέχεται ακόμη την ιδιότητα greeting, οι πελάτες δεν θα τη δουν, γι' αυτό η Meta ζητά από τους προγραμματιστές να την αποφεύγουν. Όπως τεκμηριώνεται, το greeting περιέχει ένα κείμενο ανά locale, με το default υποχρεωτικό, έως 160 χαρακτήρες, εξατομικευμένο με {{user_first_name}}, {{user_last_name}} ή {{user_full_name}}, και ο ορισμός του απαιτεί τον ρόλο Administrator στη Σελίδα.

Πώς λειτουργούν τα ice breakers;

Παρουσιάζουν έως 4 ερωτήσεις που ένα άτομο μπορεί να πατήσει για να ανοίξει συνομιλία. Η ερώτηση αναρτάται στο νήμα σαν να την έκανε το άτομο, και το payload της επιστρέφει ως γεγονός postback. Από τον Απρίλιο του 2022 είναι τοπικοποιημένα: κάθε αντικείμενο στο ice_breakers περιέχει call_to_actions και locale, απαιτείται ένα default locale, και μια DELETE στο ice_breakers τα αφαιρεί όλα. Η Meta κατατάσσει τα στοιχεία που ανταγωνίζονται για μια νέα συνομιλία:

  • Τα ice breakers του API υπερισχύουν του κουμπιού Get Started όταν ορίζονται και τα δύο.
  • Και τα δύο προηγούνται των προσαρμοσμένων ερωτήσεων που ορίζονται στα εισερχόμενα της Σελίδας, η επεξεργασία των οποίων είναι απενεργοποιημένη όσο ορίζονται τα ice breakers του API.

Πώς χτίζεται το μόνιμο μενού;

Ως πίνακας μενού, ένα ανά locale με το default υποχρεωτικό, καθένα με έως 20 call_to_actions τύπου web_url ή postback. Ένας τίτλος παίρνει έως 30 χαρακτήρες και ένα postback payload έως 1.000, ενώ το composer_input_disabled ορισμένο σε true αφήνει το μενού, τα κουμπιά και τα webviews ως τον μόνο τρόπο αλληλεπίδρασης. Οι απαιτήσεις της Meta πριν εμφανιστεί:

  • Ένα κουμπί Get Started ήδη ορισμένο και η άδεια pages_messaging.
  • Μια δημοσιευμένη Σελίδα, και η εφαρμογή ορισμένη ως δημόσια.
  • Ο ρόλος Administrator στη Σελίδα για όποιον το ορίζει.
  • Messenger v106 ή νεότερο σε iOS ή Android, εκτός του ενσωματωμένου προγράμματος περιήγησης της εφαρμογής Facebook.
  • Οι αλλαγές σε επίπεδο Σελίδας μπορεί να χρειαστούν έως 24 ώρες, ενώ ένα μενού για ένα άτομο, ορισμένο μέσω custom_user_settings με PSID, ενημερώνεται σε πραγματικό χρόνο.

Τι είναι οι εντολές;

Λέξεις-κλειδιά που ένα άτομο μπορεί να καλέσει ανά πάσα στιγμή, από ένα μενού εντολών δίπλα στο πεδίο σύνθεσης, πληκτρολογώντας μια κάθετο ή ένα @, ή από ένα αναδυόμενο παράθυρο όταν πληκτρολογεί μια ταιριαστή λέξη. Κάθε locale περιέχει από 1 έως 100 εντολές, με όνομα 1 έως 32 χαρακτήρες και χωρίς αρχική κάθετο, και περιγραφή 1 έως 64. Όταν οριστούν εντολές, έχουν προτεραιότητα έναντι του μόνιμου μενού. Οι εντολές που καλούνται φτάνουν στην εφαρμογή μέσα στο γεγονός messages, στο message.commands.

Τι κάνουν τα whitelisted_domains και account_linking_url;

Και τα δύο εξυπηρετούν εμπειρίες έξω από την ίδια τη συνομιλία. Το whitelisted_domains περιέχει έως 50 domains που μπορεί να ανοίξει το webview του Messenger για το Messenger Extensions SDK και το checkbox plugin, καθένα σε HTTPS κάτω από πλήρως αναγνωρισμένο όνομα, ποτέ IP διεύθυνση ή localhost. Ο ορισμός του απαιτεί τον ρόλο Administrator στη Σελίδα. Το account_linking_url είναι το callback HTTPS που συνδέει τον λογαριασμό Messenger ενός ατόμου με τον λογαριασμό του στην επιχείρηση.

Πώς ορίζει το easyCoexistence το Messenger profile μιας Σελίδας;

Δεν το κάνει: κανένα εργαλείο δεν καλεί το {page-id}/messenger_profile, και τα tokens της Σελίδας δεν παραδίδονται, οπότε ο ορισμός του προφίλ είναι εκτός αυτής της σύνδεσης. Οι εντολές που καλούν τα άτομα φτάνουν στο γεγονός messages, το οποίο προωθεί το easyCoexistence και διαβάζουν οι αυτοματισμοί. Τα πατήματα που η Meta αναφέρει ως γεγονότα messaging_postbacks, από το Get Started, τα στοιχεία postback του μενού και τα ice breakers, δεν προωθούνται, αφού οι Σελίδες είναι εγγεγραμμένες σε feed, messages και mention.

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

  • Ορισμός μόνιμου μενού πριν από το Get Started. Η Meta απαιτεί ένα κουμπί Get Started, γι' αυτό ορίστε πρώτα το get_started.
  • Παράλειψη του προεπιλεγμένου locale. Τα ice breakers, τα μενού και οι εντολές χρειάζονται το καθένα ένα αντικείμενο με locale ορισμένο σε default ως εναλλακτική.
  • Κλήση του profile API σε βρόχο. Η Meta επιτρέπει 10 κλήσεις ανά 10 λεπτά ανά Σελίδα, γι' αυτό βάλτε πολλές ιδιότητες σε ένα POST.
  • Αναμονή άμεσης αλλαγής μενού. Μια ενημέρωση μενού σε επίπεδο Σελίδας μπορεί να χρειαστεί έως 24 ώρες για να φτάσει στα άτομα.
Κάντε το με EasyCoexistence

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

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

Μπορεί ένα μόνιμο μενού να διαφέρει ανά άτομο;

Ναι. Το custom_user_settings με το PSID του ατόμου υπερισχύει του μενού της Σελίδας για αυτό το άτομο, ενημερώνεται σε πραγματικό χρόνο και επιτρέπει 10 κλήσεις ανά άτομο σε 10 λεπτά.

Ποια locales υποστηρίζει το Messenger profile;

Εκείνα της λίστας των υποστηριζόμενων locales της Meta, όπως τα en_GB, pt_BR ή ja_JP, και το default, η εναλλακτική που χρησιμοποιείται όταν κανένα locale δεν ταιριάζει με του ατόμου.

Ποιος μπορεί να αλλάξει το Messenger profile μιας Σελίδας;

Μια εφαρμογή με token Σελίδας που φέρει το pages_messaging. Το μόνιμο μενού, ο χαιρετισμός και η λίστα domains απαιτούν επίσης τον ρόλο Administrator στη Σελίδα.

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

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

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

Messenger Send API: αποστολή μηνυμάτων από σελίδα FacebookΠώς μια σελίδα Facebook στέλνει μηνύματα Messenger με POST /{page-id}/messages: PSID, messaging_type, κείμενο, συνημμένα, όρια και σφάλματα.Πρωτόκολλο μεταβίβασης Messenger: κοινή χρήση του inbox μιας Σελίδας μεταξύ AI agent και ανθρώπωνΠώς μεταβιβάζονται οι συνομιλίες Messenger μιας Σελίδας Facebook μεταξύ εφαρμογών και του inbox: Conversation Routing, pass_thread_control και thread owner.Ετικέτες μηνυμάτων Messenger το 2026: τι μπορεί να στείλει μια Σελίδα Facebook μετά το παράθυρο 24 ωρώνΤι μπορεί να στείλει μια Σελίδα Facebook μετά το παράθυρο 24 ωρών του Messenger το 2026: HUMAN_AGENT, CUSTOMER_FEEDBACK και οι τρεις αποσυρμένες ετικέτες.Πεδία webhook της Facebook Page: η πλήρης λίσταΤα 64 πεδία webhook της Facebook Page της Meta: feed, mention, πεδία Messenger όπως τα messages, πεδία προφίλ και το δικαίωμα του καθενός.Το webhook του Messenger για Σελίδες Facebook: μηνύματα και συμβάντα μνείαςΤα πεδία του webhook της Σελίδας Facebook για μηνύματα και μνείες: σχήμα payload, ID αποστολέων, συνημμένα και πώς φτάνουν τα συμβάντα στο endpoint σας.Δικαιώματα API σελίδων Facebook και απαιτήσεις App ReviewΤα εννέα δικαιώματα σελίδων Facebook, τι ανοίγει το καθένα και τι ζητά η Meta στο App Review: Advanced Access, επαλήθευση επιχείρησης, εγγραφή οθόνης.

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

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

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

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