ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Πώς να προσθέσετε το WhatsApp στο SaaS σας με Embedded Signup και Coexistence

Ένα SaaS προσθέτει το WhatsApp συνδέοντας τον υπάρχοντα αριθμό κάθε πελάτη μέσω του Embedded Signup της Meta με Coexistence, ώστε ο αριθμός να συνεχίζει να λειτουργεί στην εφαρμογή WhatsApp Business. Με το Partner API της easyCoexistence, μία συνεδρία σύνδεσης ανά πελάτη εκτελεί αυτή τη ροή σε φιλοξενούμενη σελίδα, η Meta στέλνει τα μηνύματα του αριθμού στο webhook_url σας, και το backend σας απαντά μέσω του Cloud API με το token του πελάτη.

20 mps

Σταθερός ρυθμός αριθμού που χρησιμοποιείται και με την εφαρμογή WhatsApp Business και με το Cloud API.

2.24.17

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

180 days

Μέχρι πότε πίσω μπορεί η Meta να μοιραστεί το ιστορικό συνομιλιών κατά την εγγραφή· πρέπει να συγχρονιστεί εντός 24 ωρών.

24 hours

Το παράθυρο υπηρεσίας πελατών του WhatsApp μετά από μήνυμα ή κλήση του χρήστη· κάθε νέο μήνυμα το επαναφέρει.

October 15, 2026

Η ημερομηνία κατά την οποία η Meta απέσυρε το Embedded Signup v2 και v3, με τις ενσωματώσεις να έχουν μεταφερθεί στο v4.

Ποια είναι τα μέρη μιας ενσωμάτωσης WhatsApp;

Πέντε, και η easyCoexistence αναλαμβάνει το πρώτο και το τελευταίο. Το προϊόν σας κρατά τη λογική των συνομιλιών, τα εισερχόμενα και ό,τι γράφουν το μοντέλο σας ή το προσωπικό των πελατών σας, ενώ η Meta μεταφέρει τα μηνύματα ανάμεσα στον αριθμό και τον server σας:

1ConnectEmbedded Signup with Coexistence on a hosted page
2Routewebhook_url set on the number as it connects
3ReceiveMeta posts messages and echoes to your server
4ReplyCloud API calls with the customer's token
5WatchStatus events when the number drops or returns

Τι αλλάζει το 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.
Reply inside the customer service window
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

Η 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 κάθε πελάτη.

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

Ενοποιημένο API κοινωνικών δικτύων για SaaS: μία ενσωμάτωση για WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn και άλλα κανάλιαΜία ενσωμάτωση για WhatsApp, Instagram, Facebook, TikTok, YouTube και LinkedIn των πελατών σας: τι ενοποιείται, τι αποφασίζει κάθε δίκτυο και οι κλήσεις.Πώς να προσθέσετε δημοσιεύσεις στο TikTok στο SaaS σαςΠροσθέστε ανάρτηση στο TikTok στο SaaS σας: συνδέστε το TikTok κάθε πελάτη και δημοσιεύστε βίντεο ή φωτογραφίες με μία κλήση, τώρα ή αργότερα.API για social media πολλών πελατών: ένα API key, οι λογαριασμοί όλων των πελατών σαςΈνα API key για λογαριασμούς WhatsApp και social πολλών πελατών: ετικέτα external_ref, χωριστά tokens, τα webhooks και τα events ανά πελάτη.WhatsApp Embedded Signup για τους πελάτες σας: η δική σας εφαρμογή Tech Provider ή μια φιλοξενούμενη σελίδαΠώς μια SaaS συνδέει τους αριθμούς WhatsApp των πελατών της με το Coexistence: τι απαιτεί η Meta από τον Tech Provider και τι αναλαμβάνει η hosted σελίδα.Πώς να εισάγετε το ιστορικό συνομιλιών και τις επαφές της εφαρμογής WhatsApp Business μέσω του APIΕισαγωγή επαφών και έως 180 ημερών συνομιλιών από εφαρμογή WhatsApp Business μέσω Coexistence: history webhooks, chunk_order, progress και 2593109.Το 24ωρο παράθυρο εξυπηρέτησης πελατώνΤι είναι το παράθυρο εξυπηρέτησης, πότε ανοίγει και κλείνει, τι στέλνετε μέσα ή έξω από αυτό και γιατί οι απαντήσεις δεν χρεώνονται.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις