Παρακολούθηση και αναλυτικά WhatsApp

Το Joryio παρέχει ολοκληρωμένη παρακολούθηση για τα μηνύματα WhatsApp, συμπεριλαμβανομένης της κατάστασης παράδοσης, των ανοιγμάτων, των κλικ και των αλληλεπιδράσεων με κουμπιά. Αυτά τα δεδομένα τροφοδοτούν αναλυτικά στοιχεία σε πραγματικό χρόνο.

Επισκόπηση

Η παρακολούθηση WhatsApp σάς επιτρέπει να:

• Παρακολουθείτε την παράδοση μηνυμάτων - Κατάσταση απεστάλη, παραδόθηκε, αναγνώστηκε
• Παρακολουθείτε την αλληλεπίδραση - Κλικ σε κουμπιά, κλικ σε συνδέσμους
• Αναλύετε καμπάνιες - Απόδοση μετατροπών σε συγκεκριμένες καμπάνιες
• Ενεργοποιείτε ροές εργασίας - Χρήση εισερχόμενων μηνυμάτων WhatsApp για την ενεργοποίηση journeys του Canvas

Παρακολουθούμενα συμβάντα

Συμβάντα εξερχόμενων μηνυμάτων

Όταν στέλνετε μηνύματα WhatsApp μέσω καμπανιών ή του Canvas, παρακολουθούνται τα ακόλουθα συμβάντα:

Όνομα συμβάντος	Περιγραφή	Ιδιότητες
message.sent	Το μήνυμα έγινε δεκτό από το API του WhatsApp	channel, messageId, messageType, templateName, to, campaignId, variantId, canvasId, nodeId, wabaId, senderId, contentSource, templateId, decisionId
message.delivered	Το μήνυμα έφτασε στη συσκευή του παραλήπτη	channel, messageId, status, recipientPhone, conversationId, campaignId, variantId, canvasId, nodeId, templateName, contentSource, templateId, decisionId
message.opened	Ο παραλήπτης διάβασε το μήνυμα. Η απόδειξη read του WhatsApp καταγράφεται ως message.opened	channel, messageId, status, recipientPhone, campaignId, variantId, canvasId, nodeId, templateName, contentSource, templateId, decisionId
message.failed	Η αποστολή του μηνύματος απέτυχε	channel, messageId, errorCode, errorMessage, reason, campaignId, variantId, canvasId, nodeId, contentSource, templateId, decisionId
message.clicked	Ο χρήστης έκανε κλικ σε κουμπί του μηνύματος	channel, campaignId, variantId, canvasId, clickType, buttonId, buttonTitle, replyToMessageId, contentSource, templateId, decisionId
Αυτά είναι τα ίδια ονόματα συμβάντων που χρησιμοποιεί κάθε κανάλι - δεν υπάρχει εξερχόμενο συμβάν με πρόθεμα whatsapp.. Οι εγγραφές του WhatsApp ξεχωρίζουν από την ιδιότητα channel, που είναι whatsapp και στα πέντε, οπότε μια αναφορά μόνο για WhatsApp είναι το message.sent φιλτραρισμένο σε channel = whatsapp.

Κάθε γραμμή του πίνακα φέρει και την ταυτότητα αποστολής: contentSource (template, campaign ή canvas), templateId όταν χρησιμοποιήθηκε αποθηκευμένο template, και decisionId όταν έναν κόμβο AI Decision, έναν κόμβο Experiment ή ένα μοντέλο εξατομικευμένης παραλλαγής επέλεξε το περιεχόμενο. Η ταυτότητα σφραγίζεται μία φορά στο message.sent και επαναλαμβάνεται στα επόμενα γεγονότα, ώστε μια παράδοση ή ένα κλικ να συνδέεται με το ακριβές περιεχόμενο και την απόφαση που τα παρήγαγαν. Η γραμμή αποστολής φέρει και την αναφορά περιεχομένου: contentKind (στατικό ή δυναμικό), contentHash (το περιεχόμενο όπως το αποθήκευσε ο marketer) και, για δυναμικό περιεχόμενο, contentTrace (ποια branches, content blocks, μοντέλα προτάσεων και παραγόμενο κείμενο επέλυσε η απόδοση, ως αναγνωριστικά) και contentKey (το κλειδί ταξινόμησης που προκύπτει από αυτά).

Δύο συμπεριφορές που αξίζει να γνωρίζετε:

• Η Meta στέλνει επίσης webhook κατάστασης sent για ένα μήνυμα που ο worker αποστολής έχει ήδη καταγράψει. Αυτή η κατάσταση παραλείπεται, ώστε μία αποστολή να είναι ένα message.sent.
• Μια απόδειξη κατάστασης για μήνυμα που δεν έστειλε αυτή η πλατφόρμα - μια απάντηση γραμμένη στην εφαρμογή WhatsApp Business ή ένα άλλο εργαλείο στον ίδιο αριθμό - αγνοείται αντί να μετρηθεί ως δική σας παράδοση.

Συμβάντα εισερχόμενων μηνυμάτων

Όταν χρήστες στέλνουν μηνύματα στον λογαριασμό WhatsApp Business σας:

Όνομα συμβάντος	Περιγραφή	Ιδιότητες
whatsapp.message.received	Λήφθηκε εισερχόμενο μήνυμα	channel, messageType, type, content, contentType, contentText, profile, phoneNumber, messageId, wabaId, accountName, toNumber, replyToMessageId

Αυτό είναι ειδικό για το WhatsApp: είναι το συμβάν που ακούει ένα εισερχόμενο trigger WhatsApp, μαζί με τα sms.message.received και viber.message.received.

Παρακολούθηση κλικ σε κουμπιά

Όταν χρήστες κάνουν κλικ σε κουμπιά στα μηνύματα προτύπων WhatsApp, το Joryio αυτόματα:

1. Συσχετίζει τα κλικ με καμπάνιες - Συνδέει το κλικ κουμπιού με το αρχικό εξερχόμενο μήνυμα
2. Καταγράφει το συμβάν - Καταγράφει συμβάν message.clicked με πλήρες πλαίσιο
3. Ενημερώνει τα αναλυτικά καμπάνιας - Αυξάνει τα πλήθη κλικ για τις αναφορές της καμπάνιας

Πώς λειτουργεί

1. You send a WhatsApp template with buttons
2. We store the message with campaign attribution (whatsapp_messages table)
3. User clicks a button → WhatsApp sends webhook
4. We look up the original message to get campaign context
5. We track message.clicked event with campaignId, variantId, buttonId

Παρακολουθούμενα δεδομένα κουμπιών

• buttonId - Το payload/ID του κουμπιού
• buttonTitle - Το κείμενο του κουμπιού
• campaignId - Η συσχετισμένη καμπάνια
• variantId - Η παραλλαγή δοκιμής A/B (αν εφαρμόζεται)
• messageId - Το ID μηνύματος WhatsApp

Παρακολούθηση κλικ σε συνδέσμους

Η παρακολούθηση συνδέσμων WhatsApp χρησιμοποιεί το δυναμικό επίθημα URL στο κουμπί URL ενός προτύπου - τη μοναδική υποδοχή URL ανά παραλήπτη που επιτρέπει η Meta. Το Joryio γεμίζει αυτό το επίθημα με ένα υπογεγραμμένο token που δείχνει στον τομέα παρακολούθησής σας· το πάτημα καταγράφεται και έπειτα ανακατευθύνεται στον πραγματικό προορισμό. Επειδή το βασικό URL του κουμπιού είναι μέρος του εγκεκριμένου προτύπου, τίποτα στο μήνυμα δεν ξαναγράφεται τη στιγμή της αποστολής - το πρότυπο παραμένει έγκυρο.

Ρύθμιση

1. Ρυθμίστε τον τομέα παρακολούθησής σας. Ορίστε τον μία φορά στο Ρυθμίσεις → Τομέας παρακολούθησης (π.χ. track.yourbrand.com). Δείτε τον Τομέα παρακολούθησης.

2. Συντάξτε το πρότυπο Meta με κουμπί URL στον τομέα παρακολούθησης. Δώστε στο κουμπί ένα δυναμικό URL με βάση τον τομέα παρακολούθησής σας:

Button URL: https://track.yourbrand.com/wa/{{1}}

Υποβάλετε το πρότυπο για έγκριση ως συνήθως. Η Meta το εγκρίνει μαζί με τον τομέα παρακολούθησής σας - το δυναμικό επίθημα {{1}} είναι το επιτρεπόμενο μεταβλητό μέρος.

3. Αντιστοιχίστε τον προορισμό στην καμπάνια. Όταν επιλέγετε το πρότυπο στον συνθέτη καμπάνιας, κάθε κουμπί URL με δυναμικό επίθημα εμφανίζει ένα πεδίο Σύνδεσμος κουμπιού - με σήμανση tracked όταν η βάση του είναι URL παρακολούθησης …/wa/{{1}}. Εισαγάγετε τον πραγματικό προορισμό, είτε ως σταθερό URL είτε ως έκφραση Liquid:

{{ user.custom.offerUrl }}

Αυτό ήταν - χωρίς κώδικα. Κατά την αποστολή, το Joryio:

1. Επιλύει τον προορισμό ανά παραλήπτη (Liquid, τροφοδοσίες καταλόγου και μπλοκ περιεχομένου λειτουργούν όλα).
2. Δημιουργεί ένα υπογεγραμμένο token παρακολούθησης που μεταφέρει τον προορισμό μαζί με την απόδοση (καμπάνια ή journey, παραλλαγή, χρήστης).
3. Στέλνει το token ως το δυναμικό επίθημα, οπότε ο παραλήπτης λαμβάνει https://track.yourbrand.com/wa/<token>.

Ροή παρακολούθησης

1. Template button (approved): https://track.yourbrand.com/wa/{{1}}
2. Send: suffix ← signed token { destination, org, user, campaign/canvas, variant }
3. Recipient taps → GET /wa/:token on your tracking domain
4. Token verified (HMAC) → message.clicked logged (channel = whatsapp) → 302 to the destination

Το token είναι υπογεγραμμένο με HMAC, οπότε ένα παραποιημένο ή πλαστό επίθημα απορρίπτεται, και ο προορισμός ταξιδεύει μέσα στο token - δεν χρειάζεται αναζήτηση σε βάση δεδομένων για την απόδοση του κλικ.

Κουμπιά που δεν βρίσκονται στον τομέα παρακολούθησής σας

Ένα κουμπί URL του οποίου η βάση δεν είναι ο τομέας παρακολούθησής σας (για παράδειγμα https://shop.com/{{1}}) αντιμετωπίζεται ως συνηθισμένο δυναμικό επίθημα της Meta: η τιμή που αντιστοιχίζετε στέλνεται ως έχει και το κλικ δεν τυλίγεται. Μόνο τα κουμπιά στον τομέα παρακολούθησης γίνονται παρακολουθούμενοι σύνδεσμοι - το Joryio δεν ξαναγράφει ποτέ ένα URL που δεν έχει εγκρίνει η Meta.

Εναύσματα μηνυμάτων WhatsApp για το Canvas

Μπορείτε να χρησιμοποιήσετε εισερχόμενα μηνύματα WhatsApp ως εναύσματα για ροές εργασίας του Canvas.

Ρύθμιση

Κατά τη δημιουργία ενός Canvas, επιλέξτε «WhatsApp Message» ως τύπο εναύσματος εισόδου.

Επιλογές εναύσματος

Επιλογή	Περιγραφή
Λογαριασμός WhatsApp	Συγκεκριμένο WABA προς ακρόαση (ή όλοι οι λογαριασμοί)
Τύποι μηνυμάτων	Φιλτράρισμα κατά τύπο μηνύματος (text, image, button_reply κ.λπ.)
Συνθήκες	Συνθήκες βάσει περιεχομένου (το κείμενο περιέχει, ισούται, regex)

Τύποι συνθηκών

Ιδιότητα	Περιγραφή	Παράδειγμα
content.text	Το κείμενο του μηνύματος	Περιέχει "support"
messageType	Ο τύπος του μηνύματος	Ισούται με "button_reply"
phoneNumber	Ο αριθμός τηλεφώνου του αποστολέα	Ξεκινά με "+1"

Τελεστές

• equals - Ακριβής αντιστοίχιση
• not equals - Όχι ακριβής αντιστοίχιση
• contains - Το κείμενο περιέχει την τιμή
• starts with - Το κείμενο ξεκινά με την τιμή
• ends with - Το κείμενο τελειώνει με την τιμή
• matches regex - Αντιστοίχιση με κανονική έκφραση

Μεταβλητές προτύπων στο Canvas

Όταν ένα μήνυμα WhatsApp ενεργοποιεί ένα canvas, μπορείτε να χρησιμοποιήσετε αυτές τις μεταβλητές στους επόμενους κόμβους:

{{ trigger.messageType }}      # 'text', 'image', 'button_reply', etc.
{{ trigger.content.text }}     # Message text content
{{ trigger.content.type }}     # Content type
{{ trigger.phoneNumber }}      # Sender's phone number
{{ trigger.messageId }}        # WhatsApp message ID
{{ trigger.timestamp }}        # When message was received
{{ trigger.wabaId }}           # WhatsApp Business Account ID
{{ trigger.context }}          # Reply context (if replying to a message)

Παράδειγμα: Canvas bot υποστήριξης

Entry Trigger: WhatsApp Message
  - Message Type: text
  - Condition: content.text contains "help" OR "support"

Flow:
  → Send WhatsApp Reply: "Hi {{ user.firstName }}, how can we help?"
  → Behavior Split: Wait for response (24h)
    → Responded: Route to support agent
    → No response: Send follow-up message

Dashboard αναλυτικών

Δείτε τα αναλυτικά WhatsApp σε:

1. Αναλυτικά καμπανιών - Μετρικές ανά καμπάνια

   • Μηνύματα που στάλθηκαν, παραδόθηκαν, αναγνώστηκαν
   • Ποσοστά κλικ σε κουμπιά
   • Ποσοστά μετατροπών

2. Αναλυτικά Canvas - Μετρικές σε επίπεδο journey

   • Χρήστες που ενεργοποιήθηκαν μέσω WhatsApp
   • Ποσοστά ολοκλήρωσης διαδρομών
   • Ποσοστά απόκρισης

3. Εξαγωγή συμβάντων / προσαρμοσμένα αναλυτικά - Χτίστε τις δικές σας αναφορές

   • Περιηγηθείτε στα ακατέργαστα συμβάντα (message.sent, message.delivered, message.opened, message.clicked, φιλτραρισμένα σε channel = whatsapp) στην Εξερεύνηση συμβάντων
   • Εξαγάγετε συμβάντα μέσω του API για να τροφοδοτήσετε προσαρμοσμένα dashboards

Καλές πρακτικές

1. Χρησιμοποιήστε πρότυπα με κουμπιά

• Τα κουμπιά έχουν υψηλότερη αλληλεπίδραση από το απλό κείμενο
• Τα κλικ σε κουμπιά παρακολουθούνται αυτόματα
• Χρησιμοποιήστε ουσιαστικό κείμενο κουμπιών για καλύτερα αναλυτικά

2. Ενεργοποιήστε την παρακολούθηση συνδέσμων

• Τυλίξτε τα URL στον τομέα παρακολούθησής σας
• Αποκτήστε πλήρη απόδοση για κλικ σε εξωτερικούς συνδέσμους
• Μετρήστε πραγματικά ποσοστά μετατροπών

3. Ρυθμίστε εναύσματα Canvas

• Αυτοματοποιήστε απαντήσεις σε συνηθισμένα ερωτήματα
• Δρομολογήστε τους χρήστες σε κατάλληλες ροές βάσει του περιεχομένου του μηνύματος
• Χρησιμοποιήστε μοτίβα regex για ευέλικτη αντιστοίχιση

4. Παρακολουθήστε τα ποσοστά παράδοσης

• Παρακολουθήστε την αναλογία delivered προς sent. Κάθε απόδειξη μετριέται μία φορά, όσες φορές και αν ξαναστείλει ο πάροχος το webhook, οπότε η αναλογία δεν μπορεί να ξεπεράσει το 100%
• Σημειώστε ότι το ποσοστό αποτυχίας υπολογίζεται επί των αποπειρών (απεσταλμένα + αποτυχίες): μια αποστολή που το WhatsApp απορρίπτει εξαρχής δεν εκπέμπει ποτέ sent για να διαιρεθεί
• Εντοπίστε ζητήματα ποιότητας αριθμών τηλεφώνου
• Παρακολουθήστε για αποτυχημένα μηνύματα

5. Αναλύστε τα μοτίβα απόκρισης

• Παρακολουθήστε τον χρόνο μεταξύ αποστολής μηνύματος και ενέργειας χρήστη
• Εντοπίστε τους βέλτιστους χρόνους αποστολής
• Μετρήστε την αξιοποίηση της 24ωρης συνεδρίας

Αντιμετώπιση προβλημάτων

Τα κλικ σε κουμπιά δεν παρακολουθούνται

1. Ελέγξτε τη ρύθμιση webhook - Βεβαιωθείτε ότι τα webhooks του WhatsApp είναι σωστά ρυθμισμένα
2. Επαληθεύστε την αποθήκευση μηνυμάτων - Το αρχικό μήνυμα πρέπει να υπάρχει στον πίνακα whatsapp_messages
3. Ελέγξτε την απόδοση καμπάνιας - Το μήνυμα πρέπει να έχει campaignId για πλήρη παρακολούθηση

Τα εισερχόμενα μηνύματα δεν ενεργοποιούν το Canvas

1. Επαληθεύστε ότι το canvas είναι ενεργό - Το canvas πρέπει να βρίσκεται σε κατάσταση «active»
2. Ελέγξτε τις συνθήκες εναύσματος - Βεβαιωθείτε ότι το μήνυμα ταιριάζει με τις ρυθμισμένες συνθήκες
3. Επαληθεύστε τη σύνδεση WABA - Ο λογαριασμός πρέπει να είναι ενεργός και συνδεδεμένος

Λείπουν δεδομένα αναλυτικών

1. Ελέγξτε την Εξερεύνηση συμβάντων - Επιβεβαιώστε ότι τα συμβάντα WhatsApp εξακολουθούν να φτάνουν· αν τα συμβάντα έχουν σταματήσει εντελώς, επικοινωνήστε με την υποστήριξη
2. Επαληθεύστε την εκπομπή συμβάντων - Ελέγξτε τα αρχεία καταγραφής backend για την καταγραφή συμβάντων
3. Ελέγξτε το χρονικό εύρος - Τα αναλυτικά έχουν καθυστέρηση επεξεργασίας

Σχετική τεκμηρίωση

• Δημιουργία καμπανιών WhatsApp
• Εναύσματα Canvas