ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
Meta Tech Provider

Ένας αριθμός.Η εφαρμογή και το API, ταυτόχρονα.

Το Coexistence είναι η επίσημη λειτουργία της Meta για ταυτόχρονη χρήση της εφαρμογής WhatsApp Business και του Cloud API στον ίδιο αριθμό. Η ομάδα συνεχίζει να απαντά από το τηλέφωνο, με τις ίδιες συνομιλίες και το ίδιο ιστορικό, ενώ το λογισμικό στέλνει και λαμβάνει μηνύματα από την ίδια γραμμή.

Το EasyCoexistence συνδέει τον αριθμό και στη συνέχεια παρακολουθεί τη σύνδεση.

Ξεκινήστε δωρεάν δοκιμή3 ημέρες δωρεάν. Δεν χρεώνεται τίποτα μέχρι να λήξει η δοκιμή.
+1 415 555 0188
Εφαρμογή WhatsApp BusinessΗ ομάδα απαντά από το τηλέφωνο, όπως πριν
Cloud APIΤα συστήματά σας ή ένας βοηθός AI, στην ίδια γραμμή
Και οι δύο πλευρές βλέπουν την ίδια συνομιλία. Ό,τι στέλνει το API εμφανίζεται στην εφαρμογή, και ό,τι πληκτρολογεί η ομάδα στην εφαρμογή φτάνει ως συμβάν smb_message_echoes, οπότε το λογισμικό δεν απαντά ποτέ πάνω από έναν άνθρωπο που έχει ήδη απαντήσει.
Μηνύματα δεν αποθηκεύονται εξ ορισμούBusiness App + Cloud APIMCP για Claude και ChatGPTΈτοιμο σε 2 λεπτά

Η επιλογή που υπήρχε κάποτε και δεν υπάρχει πια

Το Coexistence δεν είναι ένα νέο API. Είναι η κατάργηση ενός διχασμού που εμπόδιζε σχεδόν κάθε μικρή επιχείρηση να αυτοματοποιήσει οτιδήποτε.

ΠρινΈνας αριθμός, μία επιλογή
Διατήρηση της εφαρμογής

Η ομάδα απαντά από το τηλέφωνο. Τίποτα δεν μπορεί να αυτοματοποιηθεί, να συνδεθεί ή να μετρηθεί.

Χωρίς API
Μετάβαση στο API

Το λογισμικό έχει πρόσβαση στον αριθμό. Η εφαρμογή Business σταματά να λειτουργεί σε αυτόν και η ομάδα αλλάζει εργαλεία.

Χωρίς εφαρμογή
ΤώραΈνας αριθμός, και τα δύο
Ένας αριθμός
Εφαρμογή WhatsApp BusinessCloud API

Η Meta συνδέει το Cloud API με έναν αριθμό που εξακολουθεί να χρησιμοποιεί η εφαρμογή WhatsApp Business. Και οι δύο πλευρές είναι ενεργές στην ίδια γραμμή, και η καθεμία βλέπει τι στέλνει η άλλη.

Ποιοι χρησιμοποιούν έναν αριθμό με αυτόν τον τρόπο

Δύο ομάδες που θέλουν αντίθετα πράγματα από την ίδια λειτουργία, και γι' αυτό η σύνδεση μετράει περισσότερο από οποιοδήποτε dashboard χτίζεται από πάνω της.

Κρατά το τηλέφωνοΜια επιχείρηση με έναν αριθμό

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

Πολλοί αριθμοί, ένας λογαριασμόςΈνα πρακτορείο, μια συμβουλευτική εταιρεία ή ένας developer

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

Πώς ένας αριθμός λειτουργεί και στα δύο, και πού πηγαίνουν τα συμβάντα μηνυμάτων

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

  1. Έχετε έτοιμο το endpoint πριν ξεκινήσει η ενεργοποίηση

    Η Meta επαληθεύει έναν προορισμό πριν παραδώσει οτιδήποτε σε αυτόν. Καλεί το URL σας με ένα GET που περιέχει hub.mode=subscribe, το hub.verify_token σας και ένα hub.challenge, και το endpoint σας πρέπει να επιστρέψει το challenge αυτούσιο.

    Ο προορισμός πρέπει να είναι HTTPS, και το verify token είναι υποχρεωτικό. Ελέγχουμε και τα δύο πριν γίνει η κλήση, ώστε ένα λανθασμένο URL να απορρίπτεται σε εμάς αντί να φαίνεται συνδεδεμένο και να μην παραδίδει τίποτα.

    Απαιτείται
    Ένα HTTPS endpoint που επιστρέφει το hub.challenge στο GET της Meta
    Χρόνος
    Περίπου ένα λεπτό
    Τι παίρνετε
    Έναν προορισμό που η Meta μπορεί να επαληθεύσει τη στιγμή που συνδέεται ο αριθμός
    Τίποτα δεν έχει συνδεθεί ακόμη. Αυτό καθορίζει πού θα καταλήγουν τα μηνύματα.
    Πάροχος στη διαδρομήΑποθηκεύονται στους servers του
    Meta
    Η πλατφόρμα τουΛαμβάνει και αποθηκεύει μηνύματα
    ΕσείςΈνα αντίγραφο, στον δικό του χρόνο
    EasyCoexistenceΜόνο ρύθμιση
    Meta
    Το endpoint σαςΔεν έχει επαληθευτεί ακόμη
    ΕμείςΟρίζουμε τη διαδρομή, δεν βρισκόμαστε πάνω της
  2. Εκτελέστε το Embedded Signup της Meta και κάντε σάρωση στην εφαρμογή

    Ανοίγει το αναδυόμενο παράθυρο της ίδιας της Meta. Επιλέγετε το Business Portfolio, το WhatsApp Business Account και τον αριθμό που είναι ήδη καταχωρισμένος στην εφαρμογή WhatsApp Business, και στη συνέχεια εγκρίνετε τη σύνδεση στο τηλέφωνο σαρώνοντας έναν κωδικό.

    Εδώ επιλέγετε επίσης αν θα κοινοποιήσετε το υπάρχον ιστορικό συνομιλιών. Είναι μια απόφαση που παίρνεται μία φορά κατά την ενεργοποίηση και δεν μπορεί να αλλάξει αργότερα. Η εφαρμογή Business συνεχίζει να λειτουργεί μόλις ολοκληρωθεί η σάρωση.

    Απαιτείται
    Πρόσβαση στο Business Portfolio και το τηλέφωνο με τον αριθμό
    Χρόνος
    Δύο έως τρία λεπτά
    Τι παίρνετε
    Το Cloud API συνδεδεμένο σε έναν αριθμό που η εφαρμογή χρησιμοποιεί ακόμη
    Εμφανίζεται η δεύτερη πλευρά. Η πρώτη δεν αφαιρείται.
    Μετά από μετεγκατάστασηΜία πλευρά
    Ο αριθμός
    Μόνο Cloud APIΗ εφαρμογή Business δεν λειτουργεί πια σε αυτόν τον αριθμό
    Μετά το CoexistenceΔύο πλευρές
    Ο αριθμός
    Εφαρμογή WhatsApp BusinessΊδιες συνομιλίες και ιστορικό
    Cloud APIΣτην ίδια γραμμή
  3. Στρέψτε τα συμβάντα μηνυμάτων στο δικό σας σύστημα

    Η Meta επιτρέπει σε μια εφαρμογή να αλλάξει το πού παραδίδονται τα webhooks ενός συγκεκριμένου WhatsApp Business Account. Ορίζουμε αυτό το override στο URL σας, κάτι που μεταφέρει τα δύο πεδία της διαδρομής μηνυμάτων, messages και smb_message_echoes, απευθείας από τη Meta σε εσάς.

    Κρατάμε τα λειτουργικά πεδία, επειδή από αυτά αποτελείται η παρακολούθηση: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update και phone_number_name_update. Έτσι ο πίνακας ελέγχου παραμένει χρήσιμος, ενώ το περιεχόμενο των συνομιλιών δεν περνά ποτέ από εμάς.

    Απαιτείται
    Το endpoint από το πρώτο βήμα, πλέον επαληθευμένο από τη Meta
    Χρόνος
    Εφαρμόζεται μόλις ολοκληρωθεί η ενεργοποίηση
    Τι παίρνετε
    Μηνύματα που παραδίδονται από τη Meta σε εσάς, χωρίς εμάς στη διαδρομή των μηνυμάτων
    Ποια συμβάντα πηγαίνουν πού μόλις ενεργοποιηθεί το override.
    Λειτουργικά συμβάνταΠαραδίδονται σε εμάς
    account_updateΑλλαγές στην κατάσταση της σύνδεσης
    phone_number_quality_updateΠοιότητα και throughput
    account_review_updateΑποτελέσματα ελέγχου
    Διαδρομή μηνυμάτωνΠαραδίδονται σε εσάς
    messagesΌ,τι στέλνει ένας πελάτης
    smb_message_echoesΌ,τι στέλνει η ομάδα από την εφαρμογή
    Ο server σαςΑπευθείας, ποτέ μέσω εμάς
  4. Κρατήστε τη σύνδεση ζωντανή και αντέξτε μια επανασύνδεση

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

    Αυτό που παγιδεύει τους περισσότερους είναι τι κάνει η αποσύνδεση στη διαδρομή. Η Meta αποθηκεύει τον προορισμό ως override στη συνδρομή της εφαρμογής μας στον λογαριασμό, οπότε ένα PARTNER_REMOVED απεγκαθιστά την εφαρμογή και παίρνει μαζί του το override. Η επανασύνδεση επαναφέρει την αποστολή και την παρακολούθηση, αλλά όχι τον προορισμό σας. Τον επαναφέρουμε αυτόματα, επειδή ο πρώτος αριθμός που έπεσε σε αυτόν τον κανόνα επανασυνδέθηκε κανονικά και σταμάτησε σιωπηλά να παραδίδει στον server του πελάτη.

    Απαιτείται
    Η εφαρμογή να ανοίγει κατά διαστήματα στην κύρια συσκευή
    Χρόνος
    Συνεχώς
    Τι παίρνετε
    Μια σύνδεση που παρακολουθείται και μια διαδρομή που αντέχει μια επανασύνδεση
    Τι επαναφέρει μόνη της μια επανασύνδεση, και τι πρέπει να ξαναοριστεί.
    Επαναφέρονται από τη MetaΑυτόματα
    ΑποστολήΤο Cloud API λειτουργεί ξανά
    Λειτουργικά συμβάνταΗ παρακολούθηση συνεχίζεται
    Χάνονται μαζί με την εφαρμογήΠρέπει να ξαναοριστούν
    Το override του webhook σαςΑπεγκαθίσταται μαζί με την εφαρμογή
    Η παράδοση μηνυμάτων σε εσάςΣταματά σιωπηλά
    Το επαναφέρουμε εμείςΣε κάθε επανασύνδεση

Γιατί οι ομάδες χρησιμοποιούν έναν αριθμό με αυτόν τον τρόπο

  • Διατηρείτε τον αριθμό που είναι ήδη τυπωμένος σε οχήματα, αποδείξεις και στον ιστότοπο, μαζί με τον τρόπο εργασίας από το κινητό γύρω του.
  • Προσθέτετε αποστολή μέσω API, επεξεργασία webhooks και templates χωρίς να μεταφέρετε κανέναν σε νέο εργαλείο.
  • Κρατάτε την κίνηση των μηνυμάτων έξω από τα κοινόχρηστα εισερχόμενα ενός παρόχου, ώστε οι συνομιλίες να μη βρίσκονται στην πλατφόρμα κάποιου άλλου.
  • Δίνετε σε ένα πρακτορείο τη δυνατότητα να διατηρεί τους αριθμούς πολλών πελατών σε έναν λογαριασμό, ο καθένας συνδεδεμένος στο Business Portfolio του ίδιου του πελάτη.

Προϋποθέσεις και πρακτικά όρια

  • Ο αριθμός πρέπει να είναι ήδη ενεργός στην εφαρμογή WhatsApp Business. Ένας αριθμός στην απλή εφαρμογή WhatsApp πρέπει πρώτα να μεταφερθεί εκεί.
  • Η κοινοποίηση του υπάρχοντος ιστορικού συνομιλιών είναι μια εφάπαξ επιλογή κατά την ενεργοποίηση και δεν μπορεί να αλλάξει αργότερα.
  • Οι ομαδικές συνομιλίες εξαιρούνται από το API στους αριθμούς Coexistence, σε κάθε πάροχο.
  • Η κύρια συσκευή χρειάζεται περιοδική δραστηριότητα. Η Meta αποσυνδέει τη σύνδεση μετά από περίπου δεκατέσσερις ημέρες χωρίς αυτήν.
  • Οι διαδικασίες επαλήθευσης και σήματος της Meta διαφέρουν για τους αριθμούς Coexistence, και η διαθεσιμότητα ανά περιοχή αλλάζει με την πολιτική της Meta.
Ελεύθερο κείμενο0 έως 24 ώρες μετά το τελευταίο τους μήνυμαΜόνο templateμετά από αυτό, μέχρι να γράψουν ξανά
Το ρολόι ξεκινά από την αρχή κάθε φορά που ο πελάτης στέλνει κάτι. Αυτός είναι ο κανόνας που χαλάει τις ενσωματώσεις στην παραγωγή, επειδή οι δοκιμές γίνονται πάντα λίγα δευτερόλεπτα μετά από ένα μήνυμα, όταν το ελεύθερο κείμενο λειτουργεί ακόμα.

Τι δρομολογούμε σε εσάς και τι κρατάμε

Η Meta επιτρέπει σε μια εφαρμογή να αλλάξει το πού παραδίδει τα webhooks του ένα WhatsApp Business Account. Ορίζουμε αυτό το override στο URL σας, κάτι που χωρίζει τα συμβάντα στα δύο.

Παραδίδονται απευθείας στο endpoint σαςΗ διαδρομή των μηνυμάτων. Από προεπιλογή, δεν περνά ποτέ από εμάς.
  • messagesΌ,τι στέλνει ένας πελάτης στον αριθμό
  • smb_message_echoesΌ,τι στέλνει η ομάδα σας από την εφαρμογή WhatsApp Business
Παραδίδονται σε εμάςΗ λειτουργική διαδρομή. Από αυτά αποτελείται η παρακολούθηση.
  • account_updateΚατάσταση σύνδεσης: αφαιρέθηκε, offboarded, επανασυνδέθηκε, περιορίστηκε
  • phone_number_quality_updateΑλλαγές στη βαθμολογία ποιότητας και στο throughput
  • account_alertsΕιδοποιήσεις που εκδίδει η Meta για τον λογαριασμό
  • account_review_updateΑποτελέσματα ενός ελέγχου της Meta
  • business_capability_updateΑλλαγές στο όριο μηνυμάτων και στις δυνατότητες
  • phone_number_name_updateΕγκρίσεις και απορρίψεις του εμφανιζόμενου ονόματος

Αν ένας αριθμός δεν έχει ορισμένο override, τα συμβάντα μηνυμάτων του καταλήγουν στο προεπιλεγμένο μας callback, όπου ο handler τα απορρίπτει χωρίς να τα αποθηκεύσει. Αυτό επιβάλλεται στον κώδικα και δεν είναι απλώς υπόσχεση σε μια πολιτική: δεν υπάρχει διαδρομή αποθήκευσης για το περιεχόμενο των συνομιλιών.

Ο κανόνας των δεκατεσσάρων ημερών, και αυτό που χαλάει χωρίς να το αναφέρει κανείς

Η Meta αποσυνδέει μια σύνδεση Coexistence μετά από περίπου δεκατέσσερις ημέρες χωρίς δραστηριότητα στην κύρια συσκευή. Μπορεί να επανασυνδεθεί, γι' αυτό την καταγράφουμε ως ξεχωριστή κατάσταση και όχι ως πελάτη που έφυγε.

Η συνέπεια που κοστίζει έρχεται μετά. Ο προορισμός των μηνυμάτων σας δεν είναι ρύθμιση του αριθμού, είναι ένα override στη συνδρομή της εφαρμογής μας στο WhatsApp Business Account. Μια αποσύνδεση απεγκαθιστά την εφαρμογή, και το override φεύγει μαζί της. Επανασυνδέεστε, η αποστολή λειτουργεί, η παρακολούθηση λειτουργεί, και τα μηνύματα σταματούν να φτάνουν στον server σας χωρίς να αναφέρεται κανένα σφάλμα.

Επαναφέρουμε το override σε κάθε επανασύνδεση. Αυτή η συμπεριφορά υπάρχει επειδή συνέβη: ένας αριθμός έπεσε σε αυτόν τον κανόνα, επανασυνδέθηκε κανονικά και σταμάτησε σιωπηλά να παραδίδει μηνύματα.

Ένα αποτυχημένο handshake εκείνη τη στιγμή, επειδή ο server σας ήταν εκτός λειτουργίας ή άλλαξε το token, καταγράφεται στο χρονολόγιο της σύνδεσης και ο προορισμός διατηρείται αντί να απορριφθεί, οπότε αρκεί να τον αποθηκεύσετε ξανά για να διορθωθεί.

Τι χαλάει αθόρυβα, και πώς το μαθαίνουμε

Η εφαρμογή WhatsApp Business συνεχίζει να λειτουργεί σχεδόν σε κάθε μία από τις παρακάτω βλάβες, και γι' αυτό κανείς δεν τις προσέχει. Αυτές είναι όσες ελέγχουμε, και ο τρόπος.

Ο αριθμός αποσυνδέθηκεWebhook, έγκυρη πηγή

Εντοπίζεται από το webhook account_update της Meta, συγκεκριμένα το PARTNER_REMOVED, αντί να συνάγεται από ένα πεδίο που γίνεται false. Σκόπιμα δεν διαβάζουμε το is_on_biz_app γι' αυτό, επειδή είναι νόμιμα false σε αριθμούς που δεν είναι Coexistence και προκαλούσε ψευδείς αποσυνδέσεις.

Η σύνδεση έμεινε αδρανής για δεκατέσσερις ημέρεςΞεχωριστή κατάσταση

Ο κανόνας της Meta για την αδράνεια της κύριας συσκευής. Μπορεί να επανασυνδεθεί, γι' αυτό καταγράφεται ως ξεχωριστή κατάσταση και όχι ως πελάτης που έφυγε, και η επανασύνδεση επαναφέρει την αποστολή και την παρακολούθηση.

Η διαδρομή του webhook σας χάθηκε σε μια επανασύνδεσηΕπαναφέρεται αυτόματα

Ο προορισμός υπάρχει ως override στη συνδρομή της εφαρμογής μας στον λογαριασμό, οπότε μια αποσύνδεση τον απεγκαθιστά. Η αποστολή επανέρχεται με την επανασύνδεση, η παράδοση στον server σας όχι. Επαναφέρουμε το override κάθε φορά, επειδή ένας αριθμός στον οποίο συνέβη αυτό επανασυνδέθηκε κανονικά και σταμάτησε σιωπηλά να παραδίδει μηνύματα.

Το token πρόσβασης σταμάτησε να λειτουργείΔύο tokens, μία απάντηση

Διατηρούμε το token του πελάτη και το δικό μας System User token για τον ίδιο λογαριασμό. Όταν το ένα απορρίπτεται, το άλλο διαβάζει τον λογαριασμό και ξεκαθαρίζει ποιο από τα δύο χάλασε πραγματικά, ώστε ένα ανακληθέν token να μη μοιάζει πια με χαμένο αριθμό.

Η ποιότητα έπεσεΠεριοδικός έλεγχος

Ελέγχεται από τη Meta σε τακτά διαστήματα. Μια βαθμολογία RED σημειώνει τη σύνδεση ως υποβαθμισμένη, και η ποιότητα, το επίπεδο μηνυμάτων και το επίπεδο throughput αποθηκεύονται σε κάθε έλεγχο, ώστε μια πτώση να φαίνεται πριν κοστίσει μια αποστολή.

Η σύνδεση ενός αριθμού και η επίβλεψη ενός αριθμού είναι διαφορετικά προϊόντα. Το δεύτερο είναι ο λόγος που υπάρχει αυτό.

2 minutes

Ο συνήθης χρόνος σύνδεσης ενός αριθμού, με σάρωση κωδικού από την εφαρμογή WhatsApp Business.

24 hours

Για πόσο διάστημα μια απάντηση πελάτη διατηρεί ανοιχτή τη συνεδρία για απαντήσεις ελεύθερου κειμένου.

20 msg/s

Η ταχύτητα αποστολής για έναν αριθμό Coexistence, την οποία καθορίζει η Meta και δεν μπορείτε να αυξήσετε.

6 months

Πόσο ιστορικό συνομιλιών συγχρονίζει η Meta στο API όταν συνδέεται για πρώτη φορά ένας αριθμός.

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

Πρέπει η ομάδα μου να σταματήσει να χρησιμοποιεί το τηλέφωνο;

Όχι. Αυτός είναι ολόκληρος ο σκοπός του Coexistence. Η εφαρμογή WhatsApp Business συνεχίζει να λειτουργεί στον ίδιο αριθμό, με τις ίδιες συνομιλίες, ενώ το API λειτουργεί παράλληλα.

Θα χάσω τις υπάρχουσες συνομιλίες μου;

Όχι. Παραμένουν στην εφαρμογή και η Meta συγχρονίζει περίπου έξι μήνες ιστορικού στο API όταν συνδέεται ο αριθμός, ώστε το λογισμικό να έχει πλαίσιο και να μην ξεκινά από το μηδέν.

Μπορώ να το αναιρέσω;

Ναι. Ένας αριθμός μπορεί να αποσυνδεθεί και η εφαρμογή συνεχίζει όπως πάντα. Η σύνδεση δεν αλλάζει μόνιμα τίποτα στον ίδιο τον αριθμό.

Είναι αυτό το ίδιο με τα ανεπίσημα WhatsApp API;

Όχι, και η διαφορά καθορίζει αν ο αριθμός θα παραμείνει ενεργός. Το Coexistence είναι επίσημη λειτουργία της Meta στο Cloud API. Οι ανεπίσημες πύλες χειρίζονται το WhatsApp Web ως συνδεδεμένη συσκευή, κάτι που παραβιάζει τους όρους και οδηγεί σε αποκλεισμό αριθμών.

Έτοιμοι να ξεκινήσετε;

Ρυθμίστε το WhatsApp Coexistence σε λίγα λεπτά, όχι σε μήνες. Η εφαρμογή συνεχίζει να λειτουργεί στο τηλέφωνο.

Ξεκινήστε δωρεάν δοκιμή3 ημέρες δωρεάν. Δεν χρεώνεται τίποτα μέχρι να λήξει η δοκιμή.

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