Πώς να επιτρέψετε στους χρήστες σας να συνδέσουν λογαριασμούς WhatsApp, Instagram και TikTok στην εφαρμογή σας
Για να επιτρέψετε στους χρήστες σας να συνδέσουν λογαριασμούς WhatsApp, Instagram και TikTok στην εφαρμογή σας, δημιουργήστε μια συνεδρία σύνδεσης μέσω του Partner API της easyCoexistence και στείλτε τον χρήστη στο φιλοξενούμενο URL της. Εκεί συνδέει έναν αριθμό WhatsApp μέσω του Embedded Signup της Meta ή συνδέεται στο Instagram, Facebook, TikTok, YouTube, LinkedIn και σε περισσότερα κανάλια, και επιστρέφει στο redirect_url σας με το νέο αναγνωριστικό σύνδεσης ή καναλιού. Οι σύνδεσμοι ισχύουν για μία ώρα.
Η διάρκεια ισχύος ενός συνδέσμου σύνδεσης· μετά από αυτή, η συνεδρία εμφανίζεται ως "expired" και απαιτείται νέα.
Οι συνεδρίες σύνδεσης που μπορεί να έχει ανοιχτές ταυτόχρονα ένας λογαριασμός, δίπλα στο όριο των 100 νέων συνεδριών την ώρα.
Μια συνεδρία δημιουργείται, ανοίγει, συνδέεται, ακυρώνεται ή λήγει, όπως δείχνει το GET /connect-sessions/:id.
Το μακρύτερο εναλλακτικό URL επανάκλησης που δέχεται η Meta για τη δρομολόγηση των webhooks μηνυμάτων ενός αριθμού WhatsApp σε άλλη διεύθυνση.
Πώς λειτουργεί ένας σύνδεσμος σύνδεσης;
Όπως μια σελίδα ολοκλήρωσης αγοράς. Ο backend σας δημιουργεί μια συνεδρία, η διεπαφή σας στέλνει τον πελάτη στο URL της, ο πελάτης συνδέεται σε μια σελίδα στο easycoexistence.com και το πρόγραμμα περιήγησης επιστρέφει στο redirect_url σας. Ο backend σας επιβεβαιώνει έπειτα το αποτέλεσμα και ανακτά τα στοιχεία πρόσβασης της νέας σύνδεσης, όλα με το API key σας.
Τι περιλαμβάνει το αίτημα;
Ένα σώμα JSON που αποστέλλεται στο https://easycoexistence.com/api/v1/connect-sessions, με το API key σας ως Bearer token. Μόνο το redirect_url είναι υποχρεωτικό:
redirect_url: ένα URL https όπου καταλήγει ο πελάτης στη συνέχεια.- channel: whatsapp, η προεπιλογή, ή ένα κοινωνικό δίκτυο ανοιχτό στον λογαριασμό σας, με το όνομά του με πεζά γράμματα, όπως instagram, tiktok ή youtube.
external_ref: το δικό σας αναγνωριστικό για τον πελάτη, έως 200 χαρακτήρες.partner_name: το όνομα που εμφανίζει η φιλοξενούμενη σελίδα, έως 80 χαρακτήρες, ως προεπιλογή το όνομα του λογαριασμού σας.webhook_urlμεwebhook_verify_token: μόνο για αριθμούς, και πάντα μαζί. Η Meta παραδίδει εκεί τα μηνύματα του αριθμού από τη στιγμή που συνδέεται.
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "whatsapp",
"redirect_url": "https://app.example.com/connect/return",
"external_ref": "customer_4821",
"partner_name": "ClinicApp",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"webhook_verify_token": "another-long-random-string"
}'Τι επιστρέφει;
Ένα 201 με τη συνεδρία. Στείλτε τον πελάτη στο url και κρατήστε το αναγνωριστικό, που ξεκινά με cs_, για να αναζητήσετε τη συνεδρία αργότερα. Το expires_at λήγει μία ώρα μετά τη δημιουργία, και το connection_id ή το channel_id συμπληρώνεται όταν ο πελάτης συνδεθεί, ανάλογα με το κανάλι της συνεδρίας. Το GET /connect-sessions/:id επιστρέφει την ίδια μορφή οποτεδήποτε.
{
"id": "cs_…",
"url": "https://easycoexistence.com/connect/cs_…",
"channel": "whatsapp",
"status": "created",
"external_ref": "customer_4821",
"connection_id": null,
"channel_id": null,
"token_ready": false,
"redirect_url": "https://app.example.com/connect/return",
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"last_error": null,
"expires_at": "2026-10-31T15:00:00.000Z",
"opened_at": null,
"finished_at": null,
"created_at": "2026-10-31T14:00:00.000Z"
}Ποια σφάλματα μπορεί να επιστρέψει η δημιουργία συνεδρίας;
Κάθε σφάλμα έχει το ίδιο σώμα, ένα αντικείμενο με τα πεδία code και message, και το message λέει τι πρέπει να διορθωθεί. Η δημιουργία συνεδρίας μπορεί να επιστρέψει:
- 400
invalid_jsonήinvalid_request: το σώμα δεν είναι αντικείμενο JSON, ή ένα πεδίο απέτυχε στην επικύρωση, όπως έναredirect_urlπου δεν είναι https. - 400
channel_unavailable: το κανάλι δεν είναι ανοιχτό σε αυτόν τον λογαριασμό· το message απαριθμεί όσα είναι. - 401 unauthorized: το API key λείπει ή δεν είναι έγκυρο.
- 402
billing_required: ο λογαριασμός δεν έχει ακόμη κάρτα, και όλες οι συνδέσεις που έγιναν μέσω αυτού χρεώνονται σε αυτόν. - 429
cap_reached: έχουν ήδη ανοιχτές 50 συνεδρίες· περιμένετε να ολοκληρωθούν ή να λήξουν. - 429
rate_limited: περισσότερες από 100 συνεδρίες μέσα σε αυτή την ώρα· το message λέει πόσο πρέπει να περιμένετε.
Πού καταλήγει ο πελάτης στη συνέχεια;
Στο redirect_url σας, με το αποτέλεσμα προστιθέμενο στο query string του. Το ίδιο αποτέλεσμα υπάρχει στη συνεδρία, την οποία ο backend σας διαβάζει με GET /connect-sessions/:id:
- session: το αναγνωριστικό συνεδρίας, cs_ ακολουθούμενο από τυχαίους χαρακτήρες.
- status: connected, ή cancelled όταν ο πελάτης επέλεξε «Cancel and go back».
external_ref: το αναγνωριστικό σας για τον πελάτη, όταν η συνεδρία το περιείχε.connection_id: το αναγνωριστικό του νέου αριθμού, για το /connections.channel_id: το αναγνωριστικό του νέου λογαριασμού κοινωνικού δικτύου, για το /channels.
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…Ποιες καταστάσεις μπορεί να έχει μια συνεδρία;
Πέντε. Το GET /connect-sessions/:id δείχνει την τρέχουσα κατάσταση, μαζί με τα opened_at, finished_at και last_error, το οποίο εξηγεί γιατί απέτυχε η τελευταία προσπάθεια:
- created: δημιουργήθηκε από τον backend σας και δεν έχει ανοιχτεί ακόμη.
- opened: ο πελάτης φόρτωσε τη φιλοξενούμενη σελίδα.
- connected: ένας αριθμός ή λογαριασμός κοινωνικού δικτύου συνδέθηκε, και το αναγνωριστικό του βρίσκεται στη συνεδρία.
- cancelled: ο πελάτης έφυγε μέσω του «Cancel and go back».
- expired: η ώρα τελείωσε πριν ολοκληρωθεί η συνεδρία.
Πόσο διαρκεί ένας σύνδεσμος;
Μία ώρα από τη δημιουργία. Έπειτα η φιλοξενούμενη σελίδα ενημερώνει τον πελάτη ότι ο σύνδεσμος έχει λήξει, με ένα κουμπί επιστροφής στο redirect_url σας με status=cancelled, και η συνεδρία εμφανίζεται ως expired. Ένας λογαριασμός μπορεί να έχει 50 ανοιχτές συνεδρίες και να δημιουργεί 100 την ώρα, επειδή η Meta μετρά κάθε πρώτη ένταξη σε ένα όριο για όλη την εφαρμογή, το οποίο μοιράζονται όλοι οι λογαριασμοί.
Τι κάνει το external_ref;
Συνδέει κάθε σύνδεση με τον πελάτη σας. Η τιμή που στέλνετε αποθηκεύεται στον αριθμό ή στο κανάλι που δημιουργεί η συνεδρία, προστίθεται στην ανακατεύθυνση και περιλαμβάνεται σε κάθε συμβάν κατάστασης γι' αυτό. Έτσι, τα GET /connections?external_ref=customer_4821 και GET /channels?external_ref=customer_4821 απαριθμούν όσα έχει συνδέσει εκείνος ο πελάτης. Μια σύνδεση με Facebook ή LinkedIn μπορεί να φέρει πολλές Pages ταυτόχρονα: η ανακατεύθυνση ονομάζει την πρώτη, και το φίλτρο απαριθμεί τις υπόλοιπες. Χρησιμοποιήστε ένα σταθερό αναγνωριστικό από τη δική σας βάση δεδομένων, όχι ένα email που μπορεί να αλλάξει.
Τι γίνεται αν ο πελάτης ακυρώσει ή αποτύχει μια σύνδεση;
Εξαρτάται από το πού συνέβη, και η συνεδρία κρατά την καταγραφή:
- Το παράθυρο της Meta αποτυγχάνει ή κλείνει: ο πελάτης πατά ξανά «Connect» στην ίδια σελίδα, όσο ο σύνδεσμος είναι ανοιχτός.
- Η σύνδεση σε κοινωνικό δίκτυο ακυρώνεται ή απορρίπτεται: ο πελάτης επιστρέφει στη φιλοξενούμενη σελίδα με την αιτία και μπορεί να δοκιμάσει ξανά έως ότου λήξει ο σύνδεσμος.
- Ο λογαριασμός είναι ήδη συνδεδεμένος μέσω άλλου λογαριασμού της easyCoexistence: το
last_errorτο αναφέρει, και ο πελάτης συνδέεται με διαφορετικό λογαριασμό. - Ο πελάτης επιλέγει «Cancel and go back»: το
redirect_urlσας λαμβάνει status=cancelled και η συνεδρία κλείνει, οπότε δημιουργήστε νέα για μια ακόμη προσπάθεια. - Ο σύνδεσμος έληξε: δημιουργήστε νέα συνεδρία.
Τι γίνεται αν ένας αριθμός συνδεθεί χωρίς το token του πελάτη;
Η Meta μερικές φορές ολοκληρώνει το Embedded Signup χωρίς να εκδώσει το δικό της token επιχείρησης για τον πελάτη. Η φιλοξενούμενη σελίδα τότε ζητά μία ακόμη εκτέλεση, που διαρκεί μερικά δευτερόλεπτα. Αν ο πελάτης την παραλείψει, η συνεδρία εμφανίζεται ως connected με token_ready false και το URL συμβάντων σας λαμβάνει connection.token_missing. Ο αριθμός λαμβάνει μηνύματα, αφού τα αναγνωριστικά του είναι έγκυρα, αλλά δεν μπορεί να στείλει έως ότου μια νέα συνεδρία σύνδεσης τον επανασυνδέσει και εκδώσει το token.
Τι γίνεται αν το webhook_url αποτύχει στον έλεγχο της Meta;
Ο αριθμός συνδέεται παρόλα αυτά. Η Meta ελέγχει ένα webhook_url με μια χειραψία GET, την οποία το endpoint σας περνά επιστρέφοντας το hub.challenge όταν το hub.verify_token ταιριάζει. Αν αποτύχει, το last_error της συνεδρίας αρχίζει με webhook_url was not applied και δίνει την αιτιολογία της Meta, ενώ το PUT /connections/:id/webhook ορίζει τον προορισμό αφού το endpoint απαντήσει. Αν οριστεί εντός 24 ωρών από τη σύνδεση, εξακολουθεί να λαμβάνει την εφάπαξ εισαγωγή των επαφών και, αν ο πελάτης συναίνεσε να τη μοιραστεί, το ιστορικό συνομιλιών.
Τι βλέπει ο πελάτης;
Μια σελίδα στο easycoexistence.com με το όνομά σας από το partner_name, χωρίς λογαριασμό, email ή κάρτα για συμπλήρωση. Για έναν αριθμό WhatsApp εμφανίζει μια σύντομη λίστα ελέγχου επιλεξιμότητας, έπειτα το παράθυρο της Meta και έναν κωδικό QR για σάρωση με την εφαρμογή WhatsApp Business. Για λογαριασμό κοινωνικού δικτύου εμφανίζει ένα κουμπί, όπως «Continue with TikTok», που ανοίγει την ίδια οθόνη συναίνεσης του δικτύου στην ίδια καρτέλα, ώστε να λειτουργεί και στα κινητά.
Συνηθισμένα λάθη
- Εμπιστεύεστε μόνο το query string. Όποιος μπορεί να γράψει status=connected σε ένα URL, γι' αυτό επιβεβαιώστε με GET /connect-sessions/:id από τον backend σας πριν σημειώσετε τον πελάτη ως συνδεδεμένο.
- Ενσωματώνετε τον σύνδεσμο σε iframe. Στείλτε τον πελάτη σε αυτόν με ανακατεύθυνση ή νέα καρτέλα, που είναι ο τρόπος λειτουργίας της φιλοξενούμενης σελίδας και των συνδέσεων που ανοίγει.
- Δημιουργείτε συνδέσμους εκ των προτέρων. Κάθε σύνδεσμος ισχύει μία ώρα και κάθε ανοιχτός μετρά προς το όριο των 50, οπότε δημιουργήστε τη συνεδρία όταν ο πελάτης είναι έτοιμος να συνδεθεί.
- Στέλνετε webhook_url μακρύτερο από 200 χαρακτήρες. Η Meta δέχεται εναλλακτικά URL επανάκλησης έως 200 χαρακτήρες, οπότε ένα μακρύτερο δεν εφαρμόζεται και ο αριθμός συνδέεται χωρίς αυτό.
Η easyCoexistence συνδέει τους αριθμούς WhatsApp των πελατών σας και τους λογαριασμούς τους σε Instagram, Facebook, TikTok, YouTube και LinkedIn, καθώς και σε περισσότερα κανάλια, με το λογισμικό σας μέσω ενός φιλοξενούμενου συνδέσμου. Έπειτα δίνει στον backend σας τα στοιχεία πρόσβασης, τα webhooks και τα υπογεγραμμένα συμβάντα κατάστασης κάθε σύνδεσης. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, με τις πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Μπορεί να χρησιμοποιηθεί ένας σύνδεσμος δύο φορές;
Όχι. Ένας σύνδεσμος ολοκληρώνεται με έναν αριθμό ή με μία σύνδεση κοινωνικού δικτύου, η οποία στο Facebook ή στο LinkedIn μπορεί να φέρει πολλές Pages. Έπειτα εμφανίζεται ως connected, οπότε δημιουργήστε νέα συνεδρία για την επόμενη σύνδεση.
Μπορώ να στείλω τον σύνδεσμο με email ή chat;
Ναι, αρκεί ο πελάτης να τον ανοίξει εντός της ώρας. Το αναγνωριστικό συνεδρίας στο URL είναι αυτό που εξουσιοδοτεί τη σελίδα, γι' αυτό στέλνετε κάθε σύνδεσμο μόνο στον πελάτη για τον οποίο δημιουργήθηκε.
Λειτουργεί η φιλοξενούμενη σελίδα στα κινητά;
Οι συνδέσεις σε κοινωνικά δίκτυα λειτουργούν, αφού ανοίγουν στην ίδια καρτέλα. Ένας αριθμός WhatsApp συνδέεται καλύτερα από υπολογιστή: σε κινητό το παράθυρο της Meta ανοίγει ως νέα καρτέλα, και το ίδιο το κινητό χρειάζεται για να σαρώσει τον κωδικό QR.
Πώς μαθαίνω ότι ένας πελάτης συνδέθηκε χωρίς να ελέγχω διαρκώς;
Ορίστε ένα URL συμβάντων κατάστασης στον πίνακα ελέγχου, στο Profile, Developers. Η easyCoexistence τότε στέλνει connection.connected ή channel.connected, υπογεγραμμένο και με το external_ref σας, μόλις ολοκληρωθεί η σύνδεση.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις