Το webhook messaging_referral του Instagram: συνδέσμοι ig.me και παραπομπές διαφημίσεων
Το πεδίο messaging_referral του webhook του Instagram ειδοποιεί μια εφαρμογή όταν κάποιος με ήδη υπάρχουσα συνομιλία με επαγγελματικό λογαριασμό ανοίγει σύνδεσμο ig.me που φέρει παράμετρο ref. Το γεγονός περιέχει ένα αντικείμενο referral ανώτατου επιπέδου: το ref (η τιμή της παραμέτρου), το source (SHORTLINKS) και το type (OPEN_THREAD). Ένα ref σε νέα συνομιλία φτάνει μέσα στο γεγονός messages ή messaging_postbacks.
Το easyCoexistence εγγράφει κάθε συνδεδεμένο λογαριασμό Instagram σε σχόλια, μηνύματα και αναφορές, οπότε ένα ref στο πρώτο μήνυμα νέας συνομιλίας και η παραπομπή διαφήμισης Click-to-Direct φτάνουν στο HTTPS endpoint σας μέσα στο προωθημένο DM, υπογεγραμμένα με το μυστικό κλειδί αυτού του λογαριασμού.
Ο μέγιστος αριθμός χαρακτήρων που μπορεί να έχει η παράμετρος ref του ig.me, με γράμματα, ψηφία, παύλες, κάτω παύλες και σημεία ισότητας μόνο.
Ο τύπος παραπομπής για συνδέσμους ig.me. Τον χρησιμοποιεί και η παραπομπή διαφήμισης Click-to-Direct, με source ADS.
Ο χρόνος που έχει η εφαρμογή για να απαντήσει μετά από παραπομπή σε υπάρχουσα συνομιλία, η οποία επαναφέρει το τυπικό παράθυρο.
Πόσο μπορεί να διαρκέσει το παράθυρο από ένα πρώτο μήνυμα που στέλνεται μετά το κλικ σε διαφήμιση Click-to-Direct.
Πού δεν υποστηρίζονται οι σύνδεσμοι ig.me, σύμφωνα με τον οδηγό ig.me της Meta.
Πότε ενεργοποιείται το messaging_referral;
Όταν κάποιος με ήδη υπάρχουσα συνομιλία με τον επαγγελματικό λογαριασμό ανοίγει σύνδεσμο ig.me που φέρει παράμετρο ref. Το Instagram ανοίγει την υπάρχουσα συνομιλία και η Meta στέλνει την παραπομπή μόνη της, χωρίς μήνυμα. Το πού φτάνει μια ref εξαρτάται από τη συνομιλία και από το τι κάνει το άτομο:
Πώς μοιάζει μια ειδοποίηση παραπομπής;
Ένα γεγονός messaging με το αντικείμενο referral δίπλα στα sender, recipient και timestamp, χωρίς μήνυμα ή postback γύρω του. Ο οδηγός ig.me της Meta δίνει τις τιμές της παραπομπής, μέσα στο ίδιο περίβλημα με τα υπόλοιπα γεγονότα μηνυμάτων του Instagram:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"referral": {
"ref": "<REF_PARAMETER_VALUE>",
"source": "SHORTLINKS",
"type": "OPEN_THREAD"
}
}
]
}
]
}Τι σημαίνει κάθε πεδίο;
Τα πεδία που τεκμηριώνει η Meta για παραπομπή ig.me, από έξω προς τα μέσα:
- sender.id: το αναγνωριστικό Instagram-scoped του ατόμου που άνοιξε τον σύνδεσμο. recipient.id και entry[].id: ο επαγγελματικός λογαριασμός.
- referral.ref: η τιμή της παραμέτρου ref του συνδέσμου, όπως την είχε ο σύνδεσμος.
- referral.source: SHORTLINKS στα δείγματα ig.me της Meta. Ένας πίνακας στον οδηγό Instagram Messaging γράφει SHORTLINK, και η σελίδα παραδειγμάτων του δείχνει ένα placeholder.
- referral.type:
OPEN_THREAD, που η Meta χρησιμοποιεί για παραπομπές ig.me. - timestamp: πότε ενεργοποιήθηκε το γεγονός, σε χιλιοστά του δευτερολέπτου στα δείγματα της Meta.
Πώς φτιάχνεται ένας σύνδεσμος ig.me με ref;
Ως https://ig.me/<USERNAME>?ref=<VALUE>, όπου USERNAME είναι το handle του επαγγελματικού λογαριασμού, στον οδηγό Instagram Login της Meta· ο οδηγός Instagram Messaging γράφει https://ig.me/m/<USERNAME>. Το ref μπορεί να φτάνει έως 2.083 χαρακτήρες, με γράμματα, ψηφία, παύλες, κάτω παύλες και σημεία ισότητας. Η Meta προτείνει τα ref για παρακολούθηση καναλιών, για σύνδεση ενός ατόμου με συνεδρία σε άλλη εφαρμογή ή για παραπομπή σε συγκεκριμένο περιεχόμενο, και συνιστά ice breakers, το καθένα με δικό του ref, για νέες συνομιλίες.
Πού φτάνουν οι παραπομπές διαφημίσεων;
Στα μηνύματα. Όταν κάποιος κάνει κλικ σε διαφήμιση που ανοίγει το Instagram Direct και στέλνει μήνυμα, δημιουργείται ένα γεγονός messages του οποίου το message.referral περιέχει το ref της διαφήμισης, αν έχει οριστεί, το ad_id, το source ADS, το type OPEN_THREAD και το ads_context_data με τον τίτλο της διαφήμισης και το photo_url ή το video_url στο οποίο έγινε το κλικ. Οι σελίδες του Instagram της Meta τεκμηριώνουν το messaging_referral μόνο για συνδέσμους ig.me.
"message": {
"mid": "<MESSAGE_ID>",
"referral": {
"ref": "<AD_REF_IF_SET>",
"ad_id": "<AD_ID>",
"source": "ADS",
"type": "OPEN_THREAD",
"ads_context_data": {
"ad_title": "<AD_TITLE>",
"photo_url": "<IMAGE_URL_CLICKED>",
"video_url": "<THUMBNAIL_URL_FOR_THE_AD_VIDEO>"
}
}
}Ανοίγει η παραπομπή το παράθυρο μηνυμάτων;
Ναι, σε υπάρχουσα συνομιλία: ο οδηγός ig.me της Meta λέει ότι η παραπομπή επαναφέρει το τυπικό παράθυρο μηνυμάτων 24 ωρών, άρα η εφαρμογή μπορεί να απαντήσει μέσα σε 24 ώρες από το γεγονός. Ένα πρώτο μήνυμα που στέλνεται μετά το κλικ σε διαφήμιση Click-to-Direct μπορεί να ανοίξει παράθυρο έως 7 ημερών από αυτό το μήνυμα. Απαντήστε με POST /<IG_ID>/messages και recipient.id ίσο με το sender.id του γεγονότος.
Προωθεί το easyCoexistence τις παραπομπές;
Εκείνες που ταξιδεύουν μέσα σε μηνύματα. Κάθε συνδεδεμένος λογαριασμός εγγράφεται σε σχόλια, μηνύματα και αναφορές, οπότε ένα ref στο πρώτο μήνυμα μιας νέας συνομιλίας και η παραπομπή διαφήμισης Click-to-Direct φτάνουν στο endpoint σας μέσα στο προωθημένο DM, ως message.referral. Το messaging_referral, για υπάρχουσες συνομιλίες, και το messaging_postbacks, για πατήματα σε ice breakers, είναι ξεχωριστά πεδία που η Meta παραδίδει σε εφαρμογή εγγεγραμμένη σε αυτά.
Συνηθισμένα λάθη
- Αναμονή για messaging_referral σε νέα συνομιλία. Εκεί το ref φτάνει στο messages ή στο messaging_postbacks, ανάλογα με το αν το άτομο έγραψε ή πάτησε ice breaker.
- Χρήση άλλων χαρακτήρων στο ref. Η Meta δέχεται γράμματα, ψηφία, παύλες, κάτω παύλες και σημεία ισότητας, έως 2.083 χαρακτήρες.
- Σύγκριση του source με μία ακριβή συμβολοσειρά. Τα δείγματα της Meta δείχνουν SHORTLINKS για ig.me και ADS για διαφημίσεις, αλλά ένας πίνακας γράφει SHORTLINK, οπότε διακλαδίστε με βάση το πού βρίσκεται η παραπομπή και το ref.
- Δοκιμή συνδέσμων στο Instagram Web. Η Meta δεν υποστηρίζει εκεί τους συνδέσμους ig.me, οπότε ανοίξτε τους στην εφαρμογή Instagram.
Το send_social_dm απαντά μέσα στο παράθυρο 24 ωρών. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με πτώση καθώς προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Τι περιέχει το referral.source σε μια παραπομπή Instagram;
SHORTLINKS στα δείγματα ig.me της Meta και ADS για διαφήμιση Click-to-Direct, αν και ένας πίνακας στον οδηγό Instagram Messaging της Meta γράφει SHORTLINK. Διακλαδίστε με βάση το πού βρίσκεται η παραπομπή και το ref, και όχι σε μία ακριβή συμβολοσειρά.
Πόσο μεγάλη μπορεί να είναι η παράμετρος ref ενός ig.me;
Έως 2.083 χαρακτήρες, με χρήση μόνο γραμμάτων, ψηφίων, παυλών, κάτω παυλών και σημείων ισότητας.
Πού φτάνει το ref ενός ig.me σε νέα συνομιλία στο Instagram;
Στο messages όταν το άτομο πληκτρολογεί πρώτο μήνυμα, ή στο messaging_postbacks όταν πατά ice breaker. Το messaging_referral καλύπτει μόνο υπάρχουσες συνομιλίες.
Λειτουργούν οι σύνδεσμοι ig.me στο Instagram Web;
Όχι. Ο οδηγός ig.me της Meta λέει ότι δεν υποστηρίζονται στο Instagram Web.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις