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

Webhook messaging_postbacks του Instagram: ice breakers και κουμπιά

Το πεδίο messaging_postbacks του Instagram ενημερώνει μια εφαρμογή όταν ένα άτομο πατά μια ερώτηση ice breaker, ένα κουμπί postback σε πρότυπο ή ένα στοιχείο του μόνιμου μενού σε μια συνομιλία με επαγγελματικό λογαριασμό. Το αντικείμενο postback του συμβάντος περιέχει το title, δηλαδή το κείμενο που πάτησε το άτομο· το payload, τη συμβολοσειρά που όρισε η εφαρμογή για αυτή την επιλογή· και το mid, το ID του μηνύματος, από το Graph API v11.0.

Το easyCoexistence εγγράφει κάθε συνδεδεμένο λογαριασμό Instagram σε σχόλια, μηνύματα και αναφορές, και προωθεί αυτά τα συμβάντα, συμπεριλαμβανομένων των πατημάτων γρήγορων απαντήσεων, στο HTTPS endpoint σας καθώς φτάνουν, υπογεγραμμένα με το μυστικό του λογαριασμού και χωρίς αντίγραφο.

4

Το μέγιστο πλήθος ερωτήσεων ice breaker που μπορεί να ορίσει ένας λογαριασμός μέσω του Ice Breaker API της Meta.

v11.0

Η έκδοση Graph API από την οποία τα συμβάντα postback περιλαμβάνουν το mid. Το ίδιο το πεδίο χρειάζεται v8.0 ή νεότερη.

3

Το μέγιστο πλήθος κουμπιών σε ένα μήνυμα με πρότυπο κουμπιών, καθένα από τα οποία είναι postback ή web_url.

24 hours

Ο χρόνος για απάντηση μετά το πάτημα ενός στοιχείου του μόνιμου μενού, που ανοίγει το τυπικό παράθυρο μηνυμάτων.

13

Το μέγιστο πλήθος γρήγορων απαντήσεων (quick replies) που προσφέρει ένα μήνυμα. Μια πατημένη γρήγορη απάντηση φτάνει στο messages, όχι στο messaging_postbacks.

Πότε ενεργοποιείται το messaging_postbacks;

Όταν ένα άτομο πατά μία από τις δομημένες επιλογές του λογαριασμού σε μια συνομιλία, αφού η εφαρμογή και ο λογαριασμός είναι εγγεγραμμένοι στο πεδίο. Οι οδηγοί της Meta αναφέρουν αυτές τις πηγές:

  • Μια ερώτηση ice breaker, από έως 4 που προσφέρει ο λογαριασμός όταν ξεκινά μια συνομιλία. Δεν είναι διαθέσιμη στην έκδοση για υπολογιστή.
  • Ένα κουμπί postback σε πρότυπο κουμπιών, έως 3 ανά μήνυμα, ή σε γενικό πρότυπο, έως 3 ανά στοιχείο.
  • Ένα στοιχείο postback στο μόνιμο μενού του λογαριασμού.
  • Ένα ice breaker πατημένο σε νέο νήμα που άνοιξε από σύνδεσμο ig.me με παράμετρο ref: το postback τότε φέρει και το referral.
  • Μια δοκιμή αυτομήνυσης, όπου ο λογαριασμός πατά το δικό του κουμπί: το συμβάν προσθέτει το is_self με τιμή true.

Πώς μοιάζει μια ειδοποίηση postback;

Ένα συμβάν μηνύματος με αντικείμενο postback εκεί όπου θα βρισκόταν το μήνυμα ενός DM. Το παράδειγμα της Meta για το Instagram Login περιλαμβάνει mid, title και payload, και ο οδηγός των ice breaker δείχνει το ίδιο αντικείμενο χωρίς mid. Μια ειδοποίηση μοιάζει με αυτό:

A messaging_postbacks notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "postback": {
            "mid": "<MESSAGE_ID>",
            "title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
            "payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
          }
        }
      ]
    }
  ]
}

Τι σημαίνει κάθε πεδίο;

Τα πεδία που τεκμηριώνει η Meta για ένα postback, από έξω προς τα μέσα:

  • sender.id: το ID του ατόμου που πάτησε, με εμβέλεια Instagram, δηλαδή το ID στο οποίο απαντάτε. recipient.id και entry[].id: ο επαγγελματικός λογαριασμός.
  • timestamp: πότε πάτησε το άτομο, σύμφωνα με τον οδηγό ice breaker της Meta.
  • postback.title: η ερώτηση ice breaker ή ο τίτλος του κουμπιού που είδε το άτομο.
  • postback.payload: η συμβολοσειρά που ορίστηκε για εκείνη την επιλογή κατά τη δημιουργία της, επιλεγμένη από την εφαρμογή.
  • postback.mid: το ID του μηνύματος που έστειλε το πάτημα στον λογαριασμό, από το Graph API v11.0.
  • postback.referral: ref, source και type, όταν το νήμα άνοιξε από σύνδεσμο ig.me με παράμετρο ref.
  • is_self: τιμή true, δίπλα στο postback, όταν ο λογαριασμός πατά το δικό του κουμπί σε δοκιμή αυτομήνυσης.

Πώς ρυθμίζονται τα ice breakers;

Με POST /<IG_ID>/messenger_profile στο graph.instagram.com: platform ίσο με instagram και ένας πίνακας ice_breakers, του οποίου τα call_to_actions περιέχουν έως 4 ζεύγη ερώτησης και payload, με locale για κάθε μεταφρασμένο σύνολο. Το GET /me/messenger_profile?fields=ice_breakers τα εμφανίζει, και ένα DELETE με fields ίσο με ice_breakers τα αφαιρεί. Το payload που επιλέγετε εδώ είναι αυτό που επιστρέφει το messaging_postbacks όταν πατηθεί η ερώτηση.

Setting two ice breakers
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "platform": "instagram",
  "ice_breakers": [
    {
      "call_to_actions": [
        { "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
        { "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
      ]
    }
  ]
}

Πώς στέλνονται τα κουμπιά postback;

Μέσα σε μήνυμα που στέλνει ο λογαριασμός με POST /<IG_ID>/messages. Ένα πρότυπο κουμπιών φέρει κείμενο έως 640 χαρακτήρες και από 1 έως 3 κουμπιά· ένα γενικό πρότυπο φέρει έως 10 στοιχεία, το καθένα με έως 3 κουμπιά. Ένα κουμπί τύπου postback επιστρέφει το payload του στο messaging_postbacks όταν πατηθεί, ενώ ένα κουμπί web_url ανοίγει σελίδα στο ενσωματωμένο πρόγραμμα περιήγησης. Το μόνιμο μενού, που ορίζεται στο messenger_profile, δέχεται τους ίδιους δύο τύπους.

Χρησιμοποιούν οι γρήγορες απαντήσεις το messaging_postbacks;

Όχι: φτάνουν στο messages. Μια πατημένη γρήγορη απάντηση εμφανίζει τον τίτλο της στη συνομιλία ως μήνυμα, και το συμβάν messages φέρει το text ίσο με αυτόν τον τίτλο και το quick_reply.payload ίσο με το payload της επιλογής. Ένα μήνυμα μπορεί να προσφέρει έως 13 γρήγορες απαντήσεις, καθεμιά έως 20 χαρακτήρες, μόνο απλό κείμενο. Ο οδηγός Instagram Messaging της Meta αναφέρει επίσης τα ice breaker και τις επιλογές γενικού προτύπου ανάμεσα σε όσα αναφέρει το messages, χωρίς δείγμα payload.

Ανοίγει το πάτημα το παράθυρο μηνυμάτων;

Για το μόνιμο μενού, το λέει η Meta: το πάτημα ενός στοιχείου μενού ανοίγει το τυπικό παράθυρο μηνυμάτων, και ο λογαριασμός έχει 24 ώρες για να απαντήσει. Απαντήστε με POST /<IG_ID>/messages και recipient.id ίσο με το sender.id του postback. Η απάντηση του λογαριασμού επιστρέφει στο messages ως echo, με is_echo ίσο με true.

Προωθεί το easyCoexistence τα postbacks;

Μόνο τα πατήματα γρήγορων απαντήσεων. Φτάνουν στο messages, στο οποίο είναι εγγεγραμμένη η εφαρμογή του easyCoexistence και κάθε συνδεδεμένος λογαριασμός, οπότε φτάνουν στο endpoint σας με το quick_reply.payload. Τα πατήματα ice breaker, κουμπιών και μενού φτάνουν στο messaging_postbacks, στο οποίο δεν είναι εγγεγραμμένο το easyCoexistence, οπότε δεν προωθούνται.

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

  • Αναμονή γρήγορων απαντήσεων στο messaging_postbacks. Μια γρήγορη απάντηση φτάνει στο messages, με το quick_reply.payload δίπλα στο κείμενο της επιλογής που πατήθηκε.
  • Δρομολόγηση με βάση το postback.title. Ο τίτλος είναι αυτό που είδε το άτομο και μπορεί να διαφέρει ανά locale· δρομολογήστε με βάση το payload, που ορίζει η εφαρμογή.
  • Αναμονή του mid σε παλαιότερη έκδοση API. Η Meta περιλαμβάνει το postback.mid μόνο από το Graph API v11.0.
  • Ορισμός περισσότερων από 4 ice breakers ή δοκιμή τους στον υπολογιστή. Το Ice Breaker API της Meta δέχεται έως 4 ερωτήσεις, και η λειτουργία δεν είναι διαθέσιμη στον υπολογιστή.
Κάντε το με EasyCoexistence

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

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

Ποιο πεδίο webhook αναφέρει τα πατήματα ice breaker στο Instagram;

messaging_postbacks. Το αντικείμενο postback φέρει την ερώτηση ως title και το payload που ορίστηκε για αυτήν, καθώς και το mid από το Graph API v11.0.

Πόσα ice breakers μπορεί να έχει ένας λογαριασμός Instagram;

Έως 4 ερωτήσεις, ορισμένες με POST /<IG_ID>/messenger_profile και platform ίσο με instagram, προαιρετικά ανά locale.

Πώς απαντώ σε ένα postback του Instagram;

Με POST /<IG_ID>/messages και recipient.id ίσο με το sender.id του postback, δηλαδή το ID με εμβέλεια Instagram του ατόμου που πάτησε. Μετά το πάτημα μόνιμου μενού, η Meta δίνει στον λογαριασμό 24 ώρες για να απαντήσει.

Πρέπει να δρομολογώ τα postbacks του Instagram με βάση το title ή το payload;

Με βάση το payload, τη συμβολοσειρά που όρισε η εφαρμογή για την επιλογή. Το title είναι το κείμενο που είδε το άτομο, και μπορεί να διαφέρει ανά locale.

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

Το webhook messaging_referral του Instagram: συνδέσμοι ig.me και παραπομπές διαφημίσεωνΤι στέλνει το messaging_referral webhook του Instagram όταν κάποιος ανοίγει σύνδεσμο ig.me με ref, και πού φτάνουν οι νέες παραπομπές.Το webhook message_reactions του Instagram: το payload για react και unreactΤι στέλνει το webhook message_reactions του Instagram όταν κάποιος αντιδρά σε DM ή την αφαιρεί, και πότε δεν στέλνει τίποτα.Το webhook μηνυμάτων του Instagram: το payload των DM, τα echoes και τα πεδίαΤι στέλνει το webhook μηνυμάτων του Instagram για DM: το Instagram-scoped ID του αποστολέα, κείμενο, συνημμένα, απαντήσεις σε Story, echoes και το παράθυρο 24 ωρών.Πεδία webhook του Instagram: η πλήρης λίσταΤα πεδία webhook της Meta για το Instagram API με Instagram Login: τι ενεργοποιεί το καθένα, τι δικαίωμα χρειάζεται και ποια ανήκουν στο Facebook Login.Τα Instagram DM μέσω του API και το παράθυρο 24 ωρώνΤα DM του Instagram μέσω του API: σε ποιον μπορεί να απαντήσει ο λογαριασμός, το παράθυρο 24 ωρών, οι ιδιωτικές απαντήσεις και η ρύθμιση πρόσβασης.

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

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

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

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