Καταγραφή μηνυμάτων WhatsApp στο HubSpot από αριθμό Coexistence

Πώς καταλήγει ένα μήνυμα WhatsApp σε μια επαφή του HubSpot;

Σε τρία βήματα. Η Meta παραδίδει το μήνυμα στον προορισμό webhook που ορίσατε για τον αριθμό, ο οποίος εδώ είναι ένας κόμβος Webhook του n8n. Το workflow αναζητά στο HubSpot μια επαφή με τον αριθμό τηλεφώνου του αποστολέα και δημιουργεί μία αν δεν βρεθεί αντιστοιχία. Στη συνέχεια δημιουργεί μια εγγραφή communication με το κείμενο του μηνύματος και τη συσχετίζει με την επαφή.

Το HubSpot έφτιαξε το αντικείμενο Communications ακριβώς για αυτή την περίπτωση. Εκπροσωπεί ένα μήνυμα στο WhatsApp, στο LinkedIn ή ένα SMS που στάλθηκε ή λήφθηκε εκτός HubSpot και εμφανίζεται στο χρονολόγιο της εγγραφής όπως μια καταγεγραμμένη κλήση ή ένα email. Οι απαιτούμενες ιδιότητες είναι ο τύπος καναλιού, το hs_communication_logged_from με τιμή CRM, το σώμα του μηνύματος, ένας ιδιοκτήτης και μια χρονική σήμανση.

Τίποτα από αυτά δεν απαιτεί εφαρμογή από το HubSpot marketplace. Ο κόμβος HTTP Request του n8n μπορεί να επαναχρησιμοποιήσει τα διαπιστευτήρια HubSpot που έχετε ήδη ρυθμίσει για τον κόμβο HubSpot, και η κλήση είναι ένα μόνο POST ανά μήνυμα.

{
  "properties": {
    "hs_communication_channel_type": "WHATS_APP",
    "hs_communication_logged_from": "CRM",
    "hs_communication_body": "do you have anything friday?",
    "hubspot_owner_id": "75480934",
    "hs_timestamp": "2026-10-11T14:20:00.000Z"
  }
}

Καταγράφονται και τα μηνύματα που πληκτρολογούνται στο κινητό;

Μπορούν να καταγραφούν, και αυτό είναι το κομμάτι που προσθέτει ένας αριθμός Coexistence. Όταν κάποιος από την ομάδα απαντά από την εφαρμογή WhatsApp Business, η Meta στέλνει μια ηχώ (echo) του εξερχόμενου μηνύματος στον ίδιο προορισμό webhook. Ένα workflow που χειρίζεται και τα εισερχόμενα μηνύματα και τις ηχώ γράφει και τις δύο πλευρές της συζήτησης στο χρονολόγιο, έτσι ώστε ένας πωλητής που ανοίγει την επαφή στο HubSpot να βλέπει τι ρώτησε ο πελάτης και τι απάντησε η επιχείρηση.

Διακλαδώστε με βάση το πεδίο του webhook. Τα εισερχόμενα μηνύματα φτάνουν στο messages και οι απαντήσεις από το κινητό φτάνουν στο smb_message_echoes. Καταγράψτε το πρώτο ως ληφθέν και το δεύτερο ως απεσταλμένο, και το χρονολόγιο θα διαβάζεται με τη σωστή σειρά.

Οι απαντήσεις που στέλνει το ίδιο το workflow μέσω του Cloud API του είναι ήδη γνωστές, οπότε καταγράψτε τις τη στιγμή της αποστολής αντί να περιμένετε ένα webhook.

Τι γίνεται με το δικό του κανάλι εισερχομένων WhatsApp του HubSpot;

Πρόκειται για διαφορετική ενσωμάτωση. Τα εισερχόμενα συζητήσεων του HubSpot συνδέουν έναν αριθμό WhatsApp με το ίδιο το HubSpot, και η βάση γνώσεων του αναφέρει ότι ο αριθμός δεν πρέπει να είναι συνδεδεμένος με άλλη ενσωμάτωση WhatsApp. Είναι διαθέσιμο στα Marketing Hub ή Service Hub Professional και Enterprise.

Ένας αριθμός συνδεδεμένος μέσω EasyCoexistence ακολουθεί την αντίθετη διαδρομή: η Meta δρομολογεί τα webhooks του σε ένα URL που σας ανήκει και το HubSpot λαμβάνει εγγραφές μέσω του API του. Η συζήτηση απαντάται από το κινητό ή από το workflow σας, και το HubSpot είναι το σύστημα καταγραφής που κρατά το ιστορικό πάνω στην επαφή, στη συμφωνία ή στο αίτημα υποστήριξης.

Η κλήση χρειάζεται δικαίωμα εγγραφής επαφών (contacts write scope) στην ιδιωτική εφαρμογή ή στα διαπιστευτήρια που την εκτελούν, το ίδιο δικαίωμα που χρειάζεται ήδη ένα workflow για να δημιουργήσει την επαφή εξαρχής.

Πώς πρέπει το workflow να αντιστοιχίζει έναν αποστολέα σε μια επαφή;

Με τον αριθμό τηλεφώνου, κανονικοποιημένο πριν από την αναζήτηση. Η Meta στέλνει τον αποστολέα ως ψηφία με τον κωδικό χώρας και χωρίς το σύμβολο συν, για παράδειγμα 14155550188. Οι επαφές του HubSpot πληκτρολογούνται με το χέρι, οπότε το ίδιο άτομο μπορεί να είναι αποθηκευμένο ως +1 415 555 0188 ή (415) 555-0188.

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

Όταν η αναζήτηση δεν επιστρέφει τίποτα, δημιουργήστε την επαφή με το όνομα προφίλ από το payload του webhook ως όνομα και τον αριθμό μόνο με ψηφία και στα δύο πεδία. Ένας άνθρωπος μπορεί να συγχωνεύσει ή να μετονομάσει αργότερα, και η συζήτηση είναι ήδη συνδεδεμένη.

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

• Καταγραφή μόνο των εισερχομένων μηνυμάτων. Το χρονολόγιο δείχνει τότε ερωτήσεις χωρίς απαντήσεις, επειδή οι απαντήσεις που πληκτρολογούνται στο κινητό φτάνουν ως γεγονότα smb_message_echoes.
• Το hs_communication_logged_from μένει χωρίς τιμή. Το HubSpot απαιτεί να είναι CRM όταν δημιουργείται ένα communication μέσω του API.
• Αναζήτηση επαφών στο ακατέργαστο πεδίο τηλεφώνου. Η μορφή μόνο με ψηφία της Meta σπάνια ταιριάζει με αυτό που πληκτρολόγησε ένας άνθρωπος, και κάθε αστοχία δημιουργεί διπλότυπη επαφή.

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

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