Αποστολή συνομιλιών WhatsApp στο CRM σας αυτόματα
Για να στέλνετε αυτόματα συνομιλίες WhatsApp σε CRM, ορίστε τα εισερχόμενα μηνύματα να παραδίδονται ως υπογεγραμμένα webhooks στο backend σας ή σε εργαλείο ροής εργασιών, βρείτε ή δημιουργήστε την επαφή με βάση τον αριθμό τηλεφώνου και καταγράψτε το μήνυμα ως δραστηριότητα σε αυτή την επαφή. Χρησιμοποιήστε το αναγνωριστικό μηνύματος WhatsApp ως μοναδικό κλειδί της δραστηριότητας, ώστε μια επαναληπτική παράδοση να ενημερώνει την ίδια εγγραφή αντί να δημιουργεί δεύτερη.
Το easyCoexistence συνδέει τον αριθμό WhatsApp Business που κρατάτε στην εφαρμογή με το Cloud API της Meta μέσω του Coexistence.
Κεφαλίδα σε προωθημένο POST που φέρει το αναγνωριστικό παράδοσης, πανομοιότυπη σε κάθε επανάληψη της ίδιας παράδοσης.
Διάρκεια των 7 προσπαθειών προώθησης, μετά από περίπου 1, 5, 30, 120, 360 και 1,440 λεπτά.
Ένα βήμα Call my webhook καλεί το URL σας μία φορά· ένα χρονικό όριο ή σφάλμα κάνει την εκτέλεση αποτυχημένη και σας στέλνει email.
Αναγνωριστικό χρήστη με εύρος επιχείρησης, όπως US.13491208655302741918, που αποστέλλεται στα user_id και from_user_id δίπλα στον αριθμό τηλεφώνου ή στη θέση του.
Η διάρκεια διατήρησης του αρχείου καταγραφής εκτέλεσης του αυτοματισμού, που κρατά το μήνυμα ενεργοποίησης, την απάντηση και κάθε βήμα.
Ποια συμβάντα πρέπει να φτάνουν στο CRM;
Τρία είδη μηνυμάτων αποτελούν μια συνομιλία σε έναν αριθμό Coexistence, και δύο διαδρομές τα μεταφέρουν. Το Forward URL, ορισμένο ανά αριθμό, στέλνει όσα γράφουν οι πελάτες και όσα πληκτρολογεί η ομάδα σας στην εφαρμογή WhatsApp Business, ως τα αρχικά συμβάντα της Meta, με επαναλήψεις μέχρι να απαντήσει το CRM σας. Οι απαντήσεις που στέλνουν οι αυτοματισμοί περνούν από το API προς τη Meta, το οποίο τις αναφέρει μόνο ως καταστάσεις παράδοσης χωρίς κείμενο. Για να καταγράψετε τις λέξεις τους, τερματίστε τον αυτοματισμό με βήμα Call my webhook, του οποίου το ιστορικό περιλαμβάνει την απάντηση που μόλις στάλθηκε. Ένα endpoint μπορεί να δεχτεί και τα δύο: η κεφαλίδα X-EC-Event δίνει automation.step για το βήμα και το όνομα πεδίου της Meta για τις προωθήσεις.
Πώς αντιστοιχίζετε έναν αποστολέα WhatsApp σε μια επαφή CRM;
Με τον αριθμό τηλεφώνου, κανονικοποιημένο. Το WhatsApp στέλνει ψηφία με τον κωδικό χώρας και χωρίς σύμβολο συν, όπως 5511987654321, στο messages[].from των προωθήσεων και στο contact.wa_id του βήματος webhook. Οι εγγραφές CRM που πληκτρολογούν άνθρωποι περιέχουν +55 11 98765-4321 ή (11) 98765-4321, γι' αυτό διατηρήστε ιδιαίτερο πεδίο με τη μορφή μόνο ψηφίων και κάντε αναζήτηση σε αυτό. Όταν δεν βρεθεί αντιστοιχία, δημιουργήστε την επαφή με το όνομα προφίλ WhatsApp και τον αριθμό.
Αποθηκεύστε και το αναγνωριστικό χρήστη με εύρος επιχείρησης. Ένας χρήστης με όνομα χρήστη WhatsApp που δεν έχει επικοινωνήσει με τον αριθμό σας για 30 ημέρες μπορεί να φτάσει μόνο με το BSUID στα from_user_id και contacts[].user_id. Οι προωθήσεις το φέρουν, ενώ το βήμα webhook φέρει τον αριθμό τηλεφώνου.
Τι πρέπει να περιέχει κάθε εγγραφή CRM;
Μια επαφή με τα αναγνωριστικά, και μία δραστηριότητα ανά μήνυμα με κατεύθυνση, κείμενο, ώρα και μοναδικό κλειδί. Ο χάρτης παρακάτω δείχνει πού βρίσκεται κάθε τιμή σε καθεμία από τις δύο διαδρομές. Οι ώρες των μηνυμάτων στις προωθήσεις είναι δευτερόλεπτα Unix από τη Meta, ενώ το βήμα webhook στέλνει ημερομηνίες ISO. Τα πολυμέσα φτάνουν ως τύπος και αναγνωριστικό στις προωθήσεις, και ως σύμβολα κράτησης θέσης όπως [image] με τη λεζάντα στο βήμα webhook, οπότε καταγράψτε μια σύντομη ετικέτα αντί να προσπαθήσετε να αποθηκεύσετε το αρχείο.
| Forwarded event (value is Meta's) | Call my webhook step | |
|---|---|---|
| Contact phone | messages[].from | contact.wa_id |
| Contact name | contacts[].profile.name | contact.name |
| BSUID | contacts[].user_id, messages[].from_user_id | Not sent |
| Activity text | text.body, or the media type | message.text and history[].text |
| Direction | messages = in, smb_message_echoes = out | history[].direction: in, out or echo |
| Time | timestamp, Unix seconds | message.at and history[].at, ISO 8601 |
| Unique key | messages[].id (wamid) | message.id; run_id for history entries |
Πώς αποφεύγετε τα διπλότυπα από τις επαναλήψεις;
Απαντήστε γρήγορα και μετά βάλτε κλειδί σε όλα. Μια προώθηση που δεν λαμβάνει 2xx μέσα σε 10 δευτερόλεπτα επαναλαμβάνεται με το ίδιο X-EC-Delivery, έως 7 προσπάθειες. Μια κλήση στο CRM που διαρκεί 12 δευτερόλεπτα εκτελείται άρα δύο φορές, εκτός αν η δραστηριότητα γίνεται upsert στο wamid. Απαντήστε 200 πρώτα και κάντε τη δουλειά του CRM σε ουρά ή σε εργασία παρασκηνίου.
Το βήμα webhook δεν επαναλαμβάνεται, και οι δικές επαναλαμβανόμενες παραδόσεις της Meta φιλτράρονται πριν εκτελεστεί ένας αυτοματισμός, οπότε καλεί το σύστημά σας το πολύ μία φορά ανά μήνυμα. Οι καταχωρίσεις ιστορικού δεν έχουν αναγνωριστικό μηνύματος. Κλειδώστε τις αυτόματες απαντήσεις με run_id συν τη θέση τους. Οι δοκιμές από το Try it φτάνουν με dry_run true και το δείγμα επαφής 15550000000. Παραλείψτε τις, ώστε οι δοκιμαστικές εκτελέσεις να μην δημιουργούν ποτέ εγγραφές CRM.
Πώς φαίνεται ο παραλήπτης σε Node.js;
Μία διαδρομή Express δέχεται και τα δύο είδη συμβάντων. Διαβάζει το ακατέργαστο σώμα, επιλέγει το μυστικό με βάση την κεφαλίδα X-EC-Event, επαληθεύει το X-EC-Signature, απαντά 200 αμέσως και παραδίδει τη δουλειά σε συνάρτηση παρασκηνίου. Το αντικείμενο crm αντιπροσωπεύει τον πελάτη API του CRM σας: ένα upsert της επαφής με βάση τον αριθμό μόνο με ψηφία, και ένα upsert της δραστηριότητας με βάση το μοναδικό κλειδί της. Η ίδια δομή λειτουργεί και για ροή εργασιών n8n, με έναν κόμβο Code για την υπογραφή και τους κόμβους του CRM σας μετά από αυτόν.
import express from "express";
import crypto from "node:crypto";
const FORWARD_SECRET = process.env.EC_FORWARD_SECRET; // the number's, shown once with the Forward URL
const STEP_SECRET = process.env.EC_STEP_SECRET; // the automation's Signing secret
function signed(req, secret) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
const mac = crypto.createHmac("sha256", secret).update(m[1] + "." + req.body).digest();
return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}
const app = express();
app.post("/whatsapp/crm", express.text({ type: "application/json" }), (req, res) => {
const kind = req.get("X-EC-Event"); // automation.step, or Meta's field name for a forward
if (!signed(req, kind === "automation.step" ? STEP_SECRET : FORWARD_SECRET)) return res.status(401).end();
res.json({}); // no reply field: nothing is sent to the customer
handle(kind, JSON.parse(req.body)).catch(console.error);
});
async function handle(kind, body) {
if (kind === "messages") {
for (const m of body.value.messages ?? []) { // statuses are skipped
const c = (body.value.contacts ?? []).find((x) => x.wa_id === m.from);
const contact = await crm.upsertContact({ phone: m.from, bsuid: m.from_user_id, name: c?.profile?.name });
await crm.upsertActivity({ key: m.id, contact, direction: "in", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "smb_message_echoes") {
for (const m of body.value.message_echoes ?? []) {
const contact = await crm.upsertContact({ phone: m.to, bsuid: m.to_user_id });
await crm.upsertActivity({ key: m.id, contact, direction: "out", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "automation.step" && !body.dry_run) {
const contact = await crm.upsertContact({ phone: body.contact.wa_id, name: body.contact.name });
const sentAfter = body.history.filter((h) => h.direction === "out" && h.at >= body.message.at);
for (const [i, h] of sentAfter.entries()) {
await crm.upsertActivity({ key: body.run_id + ":" + i, contact, direction: "out", text: h.text, at: new Date(h.at) });
}
}
}
app.listen(3000);Μπορεί το CRM να ενημερώνει το lead με όσα έμαθε η AI;
Ναι, στη ροή εργασιών σας. Η συνομιλία που φτάνει με βήμα Call my webhook περιέχει τις ερωτήσεις που έκανε η AI σας και τις απαντήσεις του πελάτη, οπότε ένας κόμβος μοντέλου στο n8n ή μια κλήση στο backend σας μπορεί να εξάγει ανάγκη, προϋπολογισμό, χρονισμό ή τοποθεσία, να τα γράψει στα πεδία του lead και μετά να μετακινήσει το στάδιό του. Μην επιστρέφετε απάντηση, αφού ο πελάτης έχει ήδη το μήνυμα της AI. Όταν η ροή αποφασίσει ότι ένα lead αξίζει κλήση, μπορεί να δημιουργήσει εργασία για έναν πωλητή ή να ειδοποιήσει την ομάδα. Ή αφήστε το easyCoexistence να κάνει την εξαγωγή: ένας πράκτορας ή ένα βήμα AI saves details γράφει ανάγκη, προϋπολογισμό και χρονισμό στα πεδία της επαφής, και ένα βήμα Call an API μπορεί να τα στείλει στο CRM σας με tokens τύπου {{contact.budget}} στο σώμα του. Η σελίδα αξιολόγησης υποψηφίων περιέχει τις οδηγίες συνέντευξης και το payload για αυτή τη ρύθμιση.
Πώς να το ρυθμίσετε
- Send the number's messages through easyCoexistenceOn the number's page, the Where incoming messages go card must be set to Through easyCoexistence; choose it if it shows Straight to your system.
- Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
- Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
- Log automated repliesIn each automation that replies, add Call my webhook as the last step with the same URL, save, and copy that automation's Signing secret.
- Check one real conversationWrite to the number from another phone, let the automation answer, reply from the app, and confirm three activities on the contact: in, automated out and phone out.
Συνηθισμένα λάθη
- Αναζήτηση στο CRM στο πεδίο τηλεφώνου ελεύθερου κειμένου. Η μορφή μόνο ψηφίων του WhatsApp σπάνια ταιριάζει με αυτό που πληκτρολόγησε ένα άτομο, και κάθε αποτυχία δημιουργεί διπλότυπη επαφή. Αναζητήστε σε κανονικοποιημένο πεδίο μόνο ψηφίων.
- Κλήση του CRM πριν απαντήσετε στην προώθηση. Ένα CRM που χρειάζεται πάνω από 10 δευτερόλεπτα κάνει το easyCoexistence να επαναλάβει, και χωρίς upsert στο wamid η δραστηριότητα καταγράφεται δύο φορές.
- Καταγραφή μόνο της προώθησης με την προσδοκία ότι οι αυτόματες απαντήσεις θα υπάρχουν μέσα. Τα μηνύματα του API επιστρέφουν ως καταστάσεις χωρίς κείμενο. Ένα βήμα Call my webhook μετά την απάντηση φέρει τις λέξεις.
- Να αφήνετε τις δοκιμές να φτάνουν στο CRM. Το Try it καλεί πραγματικά το URL σας με dry_run true και το δείγμα επαφής 15550000000. Αφαιρέστε αυτά τα συμβάντα πριν από οποιοδήποτε upsert.
Το Forward URL του περνά τα μηνύματα των πελατών και τις απαντήσεις από το τηλέφωνο στο CRM σας ως τα αρχικά συμβάντα της Meta, υπογεγραμμένα ανά αριθμό και με επαναλήψεις για περίπου 33 ώρες όταν το CRM είναι εκτός λειτουργίας. Ένα βήμα Call my webhook προσθέτει τις αυτόματες απαντήσεις. Η προώθηση και οι αυτοματισμοί περιλαμβάνονται στο πλάνο. Από US$ 9 έως US$ 0.75 ανά αριθμό τον μήνα, με μείωση όσο προσθέτετε αριθμούς, και με δωρεάν δοκιμή 3 ημερών.
Συχνές ερωτήσεις
Με ποια CRM λειτουργεί αυτό;
Με κάθε CRM που έχει API, είτε μέσω του δικού σας backend είτε μέσω ενός εργαλείου ροής εργασιών όπως n8n, Make ή Zapier που έχει κόμβους γι' αυτό. Η HubSpot έχει ένα αντικείμενο Communications με τύπο καναλιού WhatsApp, φτιαγμένο για την καταγραφή αυτών των μηνυμάτων. Η σελίδα της HubSpot δείχνει την κλήση.
Μπορεί η ομάδα μου να απαντά στους πελάτες από το CRM;
Μόνο αν το CRM στέλνει μέσω του Cloud API της Meta, με το endpoint αποστολής και το token του αριθμού από το get_api_credentials. Ελεύθερο κείμενο επιτρέπεται εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη, και μετά από αυτό ένα εγκεκριμένο πρότυπο μηνύματος. Αυτά τα μηνύματα εμφανίζονται επίσης στο νήμα συνομιλίας της εφαρμογής στο τηλέφωνο.
Μπορούν να φορτωθούν παλιές συνομιλίες στο CRM;
Μόνο μέσω της εισαγωγής ιστορικού της Meta, η οποία στέλνει έως 6 μήνες ατομικών συνομιλιών σε προορισμό άμεσου webhook που έχει αποθηκευτεί εντός 24 ωρών από τη σύνδεση, μία φορά ανά σύνδεση. Ένας αριθμός ρυθμισμένος σε Through easyCoexistence καταγράφει από τη στιγμή που ξεκινά η προώθηση.
Τι κρατά το easyCoexistence στην πορεία;
Οι προωθημένες αλλαγές μπαίνουν σε ουρά για επαναλήψεις και αφαιρούνται μετά από 7 ημέρες. Σε αριθμό που περνά μέσω του easyCoexistence, το κείμενο των μηνυμάτων παραμένει επίσης για τις Συνομιλίες και ως πλαίσιο για την AI για το διάστημα που επιλέγετε, 30, 90 ή 365 ημέρες, και τα αρχεία καταγραφής εκτελέσεων διατηρούνται 30 ημέρες. Η μόνιμη εγγραφή βρίσκεται στο CRM.
Συνεχίστε την ανάγνωση
Έτοιμοι να ξεκινήσετε;
Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.
Ξεκινήστε δωρεάν δοκιμήΕπαληθεύτηκε στις