Πώς να προσθέσετε το WhatsApp στο SaaS σας με Embedded Signup και Coexistence
Ένα SaaS προσθέτει το WhatsApp συνδέοντας τον υπάρχοντα αριθμό κάθε πελάτη μέσω του Embedded Signup της Meta με Coexistence, ώστε ο αριθμός να συνεχίζει να λειτουργεί στην εφαρμογή WhatsApp Business. Με το Partner API της easyCoexistence, μία συνεδρία σύνδεσης ανά πελάτη εκτελεί αυτή τη ροή σε φιλοξενούμενη σελίδα, η Meta στέλνει τα μηνύματα του αριθμού στο webhook_url σας, και το backend σας απαντά μέσω του Cloud API με το token του πελάτη.
Σταθερός ρυθμός αριθμού που χρησιμοποιείται και με την εφαρμογή WhatsApp Business και με το Cloud API.
Η παλαιότερη έκδοση της εφαρμογής WhatsApp Business με την οποία μπορεί να συνδεθεί ο αριθμός ενός πελάτη μέσω του Coexistence.
Μέχρι πότε πίσω μπορεί η Meta να μοιραστεί το ιστορικό συνομιλιών κατά την εγγραφή· πρέπει να συγχρονιστεί εντός 24 ωρών.
Το παράθυρο υπηρεσίας πελατών του WhatsApp μετά από μήνυμα ή κλήση του χρήστη· κάθε νέο μήνυμα το επαναφέρει.
Η ημερομηνία κατά την οποία η Meta απέσυρε το Embedded Signup v2 και v3, με τις ενσωματώσεις να έχουν μεταφερθεί στο v4.
Ποια είναι τα μέρη μιας ενσωμάτωσης WhatsApp;
Πέντε, και η easyCoexistence αναλαμβάνει το πρώτο και το τελευταίο. Το προϊόν σας κρατά τη λογική των συνομιλιών, τα εισερχόμενα και ό,τι γράφουν το μοντέλο σας ή το προσωπικό των πελατών σας, ενώ η Meta μεταφέρει τα μηνύματα ανάμεσα στον αριθμό και τον server σας:
Τι αλλάζει το Coexistence για τους πελάτες σας;
Διατηρούν τον αριθμό και το τηλέφωνό τους. Η εφαρμογή WhatsApp Business συνεχίζει να λειτουργεί δίπλα στο Cloud API, έτσι το προσωπικό απαντά από το τηλέφωνο ενώ το προϊόν σας απαντά μέσω του API, και ό,τι στέλνουν από την εφαρμογή φτάνει στο webhook σας ως smb_message_echoes. Με αυτό έρχονται τρεις περιορισμοί: ο αριθμός στέλνει σε σταθερό ρυθμό 20 μηνυμάτων ανά δευτερόλεπτο, μόνο το API μπορεί να στείλει templates, και η Meta αποσυνδέει τον αριθμό όταν το τηλέφωνο μένει ανενεργό για περίπου 14 ημέρες.
Πώς φαίνεται το βήμα σύνδεσης στο προϊόν σας;
Ένα κουμπί Connect WhatsApp που καλεί το POST /connect-sessions από το backend σας με redirect_url, το id του πελάτη σας ως external_ref και webhook_url με webhook_verify_token, ώστε η Meta να δρομολογεί τον αριθμό προς εσάς από το πρώτο λεπτό. Ο πελάτης επιβεβαιώνει μια σύντομη λίστα ελέγχου στη φιλοξενούμενη σελίδα, ανοίγει το αναδυόμενο παράθυρο της Meta, σαρώνει έναν κωδικό QR με την εφαρμογή WhatsApp Business και επιστρέφει σε εσάς με ένα connection_id. Αν θα εκτελέσετε το Embedded Signup από τη δική σας εφαρμογή Tech Provider, αυτό εξετάζεται στον οδηγό του Embedded Signup.
Πώς φτάνουν τα μηνύματα στο backend σας;
Από τη Meta, απευθείας στο webhook_url, χωρίς να περνούν από την easyCoexistence και χωρίς να κρατείται αντίγραφο. Το πεδίο messages μεταφέρει όσα στέλνουν οι πελάτες και την κατάσταση όσων στέλνετε εσείς, ενώ το smb_message_echoes μεταφέρει όσα στέλνει το προσωπικό από την εφαρμογή. Η Meta υπογράφει κάθε αποστολή με το app secret της easyCoexistence, που δεν μοιράζεται ποτέ, οπότε ένα μακρύ τυχαίο μυστικό στη διαδρομή του URL το πιστοποιεί. Δύο αριθμοί στο ίδιο WhatsApp Business Account μοιράζονται έναν προορισμό: δρομολογήστε με βάση το value.metadata.phone_number_id.
Πώς απαντά το backend σας και στέλνει templates;
Με το Graph API της Meta και το token του πελάτη από το GET /connections/{id}?credentials=1, που επιστρέφει και το send_endpoint. Το ελεύθερο κείμενο στέλνεται εντός 24 ωρών από το τελευταίο μήνυμα του ατόμου. Μετά από αυτό, μόνο ένα template που έχει εγκρίνει η Meta:
- Απάντηση: POST /<
PHONE_NUMBER_ID>/messages με type text, εντός του παραθύρου. - Template: η ίδια κλήση με type template, όνομα template και τον κωδικό γλώσσας του.
- Δημιουργία template: POST /<
WABA_ID>/message_templates, και στη συνέχεια έλεγχος της κατάστασής του, αφού τα αποτελέσματα της έγκρισης δεν φτάνουν στοwebhook_url. - Πολυμέσα: POST /<
PHONE_NUMBER_ID>/media για ανέβασμα· τα εισερχόμενα πολυμέσα έρχονται ως ID που ανακτάται με το ίδιο token.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'Μπορεί το προϊόν σας να εισάγει τις υπάρχουσες συνομιλίες του πελάτη;
Μία φορά, κατά τη σύνδεση. Όταν έχει οριστεί webhook_url στη συνεδρία, η easyCoexistence ζητά από τη Meta να στείλει τις επαφές του αριθμού και, αν ο πελάτης συμφωνήσει στην εφαρμογή, έως 180 ημέρες συνομιλιών, που φτάνουν ως smb_app_state_sync και webhooks ιστορικού. Η Meta το επιτρέπει μόνο εντός 24 ωρών από τη σύνδεση, οπότε το endpoint πρέπει να απαντά πριν σταλεί ο σύνδεσμος. Ο οδηγός ιστορικού συνομιλιών περιγράφει τα payloads.
Ποιος πληρώνει τη Meta για τα μηνύματα;
Ο πελάτης σας. Η Meta χρεώνει τα μηνύματα που στέλνει το backend σας μέσω του API στο δικό του WhatsApp Business Account, με μέθοδο πληρωμής που προσθέτει εκεί, και μια επιχείρηση χωρίς καμία δεν μπορεί να στείλει marketing templates. Η easyCoexistence χρεώνει τον λογαριασμό σας ανά συνδεδεμένο αριθμό και δεν χρεώνει ποτέ για μηνύματα ούτε προσθέτει περιθώριο στις τιμές της Meta.
Τι συμβαίνει όταν αποσυνδεθεί ένας αριθμός;
Το events URL σας λαμβάνει το connection.disconnected με τον λόγο της Meta, όταν είναι γνωστός. Το PRIMARY_INACTIVITY είναι ο κανόνας των 14 ημερών, και μια νέα συνεδρία σύνδεσης για αυτόν τον πελάτη επαναφέρει τον ίδιο αριθμό. Το connection.token_missing σημαίνει ότι ο αριθμός συνδέθηκε χωρίς το token του πελάτη· έτσι λαμβάνει μηνύματα αλλά δεν μπορεί να στείλει, έως ότου μια νέα συνεδρία τον επανασυνδέσει.
Συνηθισμένα λάθη
- Αποστολή του συνδέσμου σύνδεσης πριν απαντά το endpoint του webhook σας. Η εισαγωγή ιστορικού εκτελείται μία φορά, εντός 24 ωρών από τη σύνδεση, και ό,τι σταλεί πριν λειτουργήσει το URL σας χάνεται.
- Απάντηση με ελεύθερο κείμενο μετά το κλείσιμο του παραθύρου. Μόλις περάσουν 24 ώρες από το τελευταίο μήνυμα του ατόμου, περνά μόνο ένα εγκεκριμένο template.
- Εκκίνηση καμπάνιας από έναν αριθμό με πλήρη ταχύτητα. Ένας αριθμός Coexistence στέλνει με 20 μηνύματα ανά δευτερόλεπτο, οπότε βάλτε σε ουρά τις αποστολές κάθε αριθμού με αυτόν τον ρυθμό.
- Προσδοκία ότι το προσωπικό θα στέλνει templates από το τηλέφωνο. Στο Coexistence μόνο το API τα στέλνει, οπότε οι αποστολές templates πρέπει να βρίσκονται στο προϊόν σας.
Η easyCoexistence προσθέτει το WhatsApp στο SaaS σας με το Embedded Signup και το Coexistence της Meta, σε φιλοξενούμενη σελίδα που εμφανίζει το όνομά σας: οι πελάτες σας διατηρούν τον αριθμό τους και την εφαρμογή WhatsApp Business, και η Meta παραδίδει τα μηνύματα στον server σας ως υπογεγραμμένα συμβάντα. Το ίδιο API συνδέει το Instagram, το Facebook, το TikTok, το YouTube, το LinkedIn και άλλα κανάλια που έρχονται. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Μπορεί ένας πελάτης να συνδέσει έναν αριθμό που βρίσκεται σε άλλον πάροχο WhatsApp API;
Όχι, όσο παραμένει εκεί. Η φιλοξενούμενη λίστα ελέγχου ζητά έναν αριθμό χωρίς άλλον πάροχο API ή εργαλείο αυτοματισμού, οπότε ο πελάτης τον αποσυνδέει πρώτα από αυτόν τον πάροχο.
Μπορεί το SaaS μου να στέλνει templates WhatsApp για τους πελάτες του;
Ναι, μέσω του Cloud API με το token κάθε πελάτη: δημιουργήστε το template στο WhatsApp Business Account του πελάτη, περιμένετε την έγκριση της Meta και μετά στείλτε το.
Διαβάζει η easyCoexistence τα μηνύματα WhatsApp των πελατών μου;
Όχι. Η Meta στέλνει τα μηνύματα ενός αριθμού απευθείας στο webhook_url που ορίζετε. Ένας αριθμός χωρίς webhook_url επιστρέφει στο callback της easyCoexistence, όπου τα μηνύματα απορρίπτονται χωρίς να αποθηκεύονται.
Πόσο κοστίζει η easyCoexistence ανά αριθμό WhatsApp;
US$ 9 έως US$ 0,75 ανά αριθμό τον μήνα, ανάλογα με την κλίμακα του συνολικού αριθμού των συνδέσεών σας, με τις πρώτες 3 ημέρες δωρεάν. Οι χρεώσεις μηνυμάτων της Meta πηγαίνουν στο WhatsApp Business Account κάθε πελάτη.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις