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

Το webhook message_reactions του Instagram: το payload για react και unreact

Το πεδίο webhook message_reactions του Instagram ενημερώνει μια εφαρμογή όταν ένα άτομο αντιδρά σε μήνυμα στη συνομιλία του με επαγγελματικό λογαριασμό, ή αφαιρεί την αντίδρασή του. Το γεγονός βρίσκεται στον πίνακα messages, με ένα αντικείμενο reaction: mid, το ID του μηνύματος στο οποίο έγινε η αντίδραση· action, react ή unreact· και, μόνο στο react, reaction, όπως love, και emoji, το ίδιο το emoji.

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

react / unreact

Οι δύο τιμές του reaction.action: προστέθηκε μια αντίδραση, ή αφαιρέθηκε μια αντίδραση.

v12.0

Από την έκδοση Graph API που ορίζει η Meta, υποστηρίζονται στο webhook αυτό τα angry, sad, wow, love, like, laugh και άλλες αντιδράσεις.

No echo

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

Default

Το message_reactions ανήκει στα πεδία με τα οποία ξεκινά συνδρομή ένα νέο προϊόν Instagram στο App Dashboard.

100/sec

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

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

Όταν ένα άτομο αντιδρά σε μήνυμα στη συνομιλία του με τον επαγγελματικό λογαριασμό, και ξανά όταν αφαιρεί την αντίδραση, αφού η εφαρμογή και ο λογαριασμός έχουν εγγραφεί στο πεδίο. Ο οδηγός Instagram Messaging της Meta είναι σαφής για την αντίστροφη περίπτωση: όταν ο ίδιος ο λογαριασμός αντιδρά ή αφαιρεί αντίδραση, δεν στέλνεται ειδοποίηση, και ούτε το messages στέλνει echo γι' αυτόν.

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

Ένα POST με object ίσο με instagram, του οποίου το entry περιέχει έναν πίνακα messaging. Σε αντίθεση με ένα DM, το γεγονός δεν έχει αντικείμενο message: η αντίδραση βρίσκεται στο δικό της αντικείμενο reaction, δίπλα στα sender, recipient και timestamp. Το παράδειγμα της Meta για το Instagram Login:

A message_reactions notification, as Meta sends it
{
  "object": "instagram",
  "entry": [
    {
      "id": "<IG_ID>",
      "time": 1793448000512,
      "messaging": [
        {
          "sender": { "id": "<IGSID>" },
          "recipient": { "id": "<IG_ID>" },
          "timestamp": 1793447999874,
          "reaction": {
            "mid": "<MESSAGE_ID>",
            "action": "react",
            "reaction": "love",
            "emoji": "\u{2764}\u{FE0F}"
          }
        }
      ]
    }
  ]
}

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

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

  • entry[].id και recipient.id: ο επαγγελματικός λογαριασμός. sender.id: το Instagram-scoped ID του ατόμου που αντέδρασε.
  • timestamp: πότε ενεργοποιήθηκε το γεγονός, σε χιλιοστά του δευτερολέπτου στα δείγματα της Meta· το entry[].time είναι πότε η Meta έστειλε την ειδοποίηση.
  • reaction.mid: το ID του μηνύματος στο οποίο έγινε η αντίδραση, το ίδιο mid που είχε εκείνο το μήνυμα στο γεγονός messages.
  • reaction.action: react όταν προστίθεται αντίδραση, unreact όταν αφαιρείται.
  • reaction.reaction: το όνομα της αντίδρασης, όπως love· η Meta αναφέρει angry, sad, wow, love, like, laugh και other.
  • reaction.emoji: το emoji ως συμβολοσειρά Unicode, όπως \u{2764}\u{FE0F} για love.
  • Στο unreact, τα reaction και emoji παραλείπονται.

Πώς μοιάζει ένα unreact;

Το ίδιο γεγονός με action ίσο με unreact και χωρίς reaction ούτε emoji, αφού δεν υπάρχει τίποτα να ονομαστεί. Αντιστοιχίστε το με την αντίδραση που αφαιρεί μέσω των reaction.mid και sender.id, και αφαιρέστε την αντίδραση αυτού του ατόμου από το μήνυμα στα δικά σας αρχεία.

The reaction object of an unreact
"reaction": {
  "mid": "<MESSAGE_ID>",
  "action": "unreact"
}

Σε ποιο μήνυμα δείχνει το mid;

Στο μήνυμα στο οποίο αντέδρασε το άτομο, με το ίδιο mid που έφερε στο γεγονός messages, συμπεριλαμβανομένων των echo των δικών του μηνυμάτων. Ένας χειριστής που αποθηκεύει τα mid μπορεί να συνδέσει την αντίδραση με τη σωστή γραμμή της συνομιλίας. Η Meta σημειώνει ένα κενό: η αντίδραση σε μία εικόνα από carousel post αναφέρει την πρώτη εικόνα του carousel, που μπορεί να μην είναι αυτή που επιλέχθηκε.

Πώς ένας λογαριασμός αντιδρά σε μήνυμα;

Με POST /<IG_ID>/messages: recipient.id ίσο με το Instagram-scoped ID του ατόμου, sender_action ίσο με react, και ένα payload που περιέχει message_id και reaction, ένα emoji ή τη μορφή του σε UTF-8. Η επανάληψη της κλήσης με άλλο emoji αλλάζει την αντίδραση, και sender_action ίσο με unreact με μόνο το message_id την αφαιρεί. Καμία από τις δύο κλήσεις δεν δημιουργεί webhook.

Reacting to a person's message
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json

{
  "recipient": { "id": "<IGSID>" },
  "sender_action": "react",
  "payload": {
    "message_id": "<MESSAGE_ID>",
    "reaction": "<EMOJI>"
  }
}

Τι χρειάζεται το message_reactions;

Με το Instagram Login, instagram_business_basic και instagram_business_manage_messages, και Advanced Access για λογαριασμούς που ο προγραμματιστής δεν κατέχει ή δεν διαχειρίζεται. Ένα νέο προϊόν Instagram στο App Dashboard ξεκινά με συνδρομή στο message_reactions, και κάθε λογαριασμός εγγράφεται μέσω POST /<IG_ID>/subscribed_apps. Ο οδηγός Send Messages της Meta το αναφέρει ως messaging_reactions, αλλά ο πίνακας πεδίων, οι προεπιλογές του dashboard και η αναφορά webhook γράφουν message_reactions.

Το easyCoexistence προωθεί τις αντιδράσεις;

Όχι. Η εφαρμογή του easyCoexistence και κάθε συνδεδεμένος λογαριασμός εγγράφονται μόνο σε comments, messages και mentions, οπότε τα γεγονότα message_reactions δεν προωθούνται στο endpoint σας. Τα DM και τα echo στα οποία δείχνουν οι αντιδράσεις μέσω του mid τους φτάνουν σε αυτό, υπογεγραμμένα με το μυστικό του λογαριασμού.

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

  • Αναζήτηση της αντίδρασης μέσα στο message. Ένα γεγονός αντίδρασης δεν έχει αντικείμενο message· διαβάστε το αντικείμενο reaction δίπλα στα sender και recipient.
  • Ανάγνωση του reaction ή του emoji χωρίς έλεγχο του action. Και τα δύο παραλείπονται στο unreact, οπότε ο κώδικας που τα υποθέτει σπάει όταν αφαιρείται μια αντίδραση.
  • Αναμονή για webhook μετά από αντίδραση του λογαριασμού. Η Meta δεν στέλνει τίποτα για τις δικές του αντιδράσεις, ούτε echo, οπότε καταγράψτε τις όταν τις στέλνει η εφαρμογή σας.
  • Αντιγραφή του ονόματος messaging_reactions από τον οδηγό Send Messages της Meta. Το πεδίο στον πίνακα πεδίων, στις προεπιλογές του dashboard και στην αναφορά webhook είναι message_reactions.
Κάντε το με EasyCoexistence

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

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

Γιατί η αντίδραση σε carousel post δείχνει την πρώτη εικόνα;

Η Meta αναφέρει την πρώτη εικόνα του carousel όταν κάποιος αντιδρά σε μία από τις εικόνες του, και αυτή μπορεί να μην είναι η εικόνα που επέλεξε το άτομο.

Στέλνει το webhook του Instagram όταν η επιχείρηση αντιδρά σε μήνυμα;

Όχι. Η Meta δεν στέλνει ειδοποίηση message_reactions ούτε echo όταν ο λογαριασμός αντιδρά ή αφαιρεί αντίδραση σε μήνυμα.

Ποιες αντιδράσεις μπορεί να αναφέρει το webhook του Instagram;

Ο οδηγός Instagram Messaging της Meta αναφέρει angry, sad, wow, love, like, laugh και other από την Graph API v12.0, με το ίδιο το emoji στο reaction.emoji.

Το πεδίο webhook είναι message_reactions ή messaging_reactions;

message_reactions. Ο οδηγός Send Messages της Meta γράφει messaging_reactions, αλλά ο πίνακας πεδίων, οι προεπιλογές του App Dashboard και η αναφορά webhook χρησιμοποιούν όλα message_reactions.

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

Το webhook μηνυμάτων του Instagram: το payload των DM, τα echoes και τα πεδίαΤι στέλνει το webhook μηνυμάτων του Instagram για DM: το Instagram-scoped ID του αποστολέα, κείμενο, συνημμένα, απαντήσεις σε Story, echoes και το παράθυρο 24 ωρών.Συνημμένα των DM του Instagram στο webhook μηνυμάτωνΤύποι συνημμένων σε DM του Instagram: εικόνα, βίντεο, ήχος, ig_post, ig_reel και story_mention, με payloads, URLs και κενά.Webhook messaging_postbacks του Instagram: ice breakers και κουμπιάΤι στέλνει το webhook messaging_postbacks του Instagram όταν κάποιος πατά ice breaker, κουμπί ή στοιχείο μενού: title, payload και mid, και πώς ρυθμίζονται.Instagram live_comments webhook: σχόλια κατά τη μετάδοση LiveΤι στέλνει το webhook live_comments του Instagram κατά τη μετάδοση Live: το payload, η διαφορά από τα σχόλια και η απάντηση σε αυτά.Πεδία 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

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