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

Πώς να επιτρέψετε στους χρήστες σας να συνδέσουν λογαριασμούς WhatsApp, Instagram και TikTok στην εφαρμογή σας

Για να επιτρέψετε στους χρήστες σας να συνδέσουν λογαριασμούς WhatsApp, Instagram και TikTok στην εφαρμογή σας, δημιουργήστε μια συνεδρία σύνδεσης μέσω του Partner API της easyCoexistence και στείλτε τον χρήστη στο φιλοξενούμενο URL της. Εκεί συνδέει έναν αριθμό WhatsApp μέσω του Embedded Signup της Meta ή συνδέεται στο Instagram, Facebook, TikTok, YouTube, LinkedIn και σε περισσότερα κανάλια, και επιστρέφει στο redirect_url σας με το νέο αναγνωριστικό σύνδεσης ή καναλιού. Οι σύνδεσμοι ισχύουν για μία ώρα.

1 hour

Η διάρκεια ισχύος ενός συνδέσμου σύνδεσης· μετά από αυτή, η συνεδρία εμφανίζεται ως "expired" και απαιτείται νέα.

50 open

Οι συνεδρίες σύνδεσης που μπορεί να έχει ανοιχτές ταυτόχρονα ένας λογαριασμός, δίπλα στο όριο των 100 νέων συνεδριών την ώρα.

5 statuses

Μια συνεδρία δημιουργείται, ανοίγει, συνδέεται, ακυρώνεται ή λήγει, όπως δείχνει το GET /connect-sessions/:id.

200 characters

Το μακρύτερο εναλλακτικό URL επανάκλησης που δέχεται η Meta για τη δρομολόγηση των webhooks μηνυμάτων ενός αριθμού WhatsApp σε άλλη διεύθυνση.

Πώς λειτουργεί ένας σύνδεσμος σύνδεσης;

Όπως μια σελίδα ολοκλήρωσης αγοράς. Ο backend σας δημιουργεί μια συνεδρία, η διεπαφή σας στέλνει τον πελάτη στο URL της, ο πελάτης συνδέεται σε μια σελίδα στο easycoexistence.com και το πρόγραμμα περιήγησης επιστρέφει στο redirect_url σας. Ο backend σας επιβεβαιώνει έπειτα το αποτέλεσμα και ανακτά τα στοιχεία πρόσβασης της νέας σύνδεσης, όλα με το API key σας.

1CreatePOST /connect-sessions from your backend
2SendA redirect or a new tab to the session's url
3ConnectMeta's Embedded Signup, or the network's own sign-in
4ReturnYour redirect_url, with the session, status and new id
5ConfirmGET /connect-sessions/:id, then the credentials

Τι περιλαμβάνει το αίτημα;

Ένα σώμα 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 παραδίδει εκεί τα μηνύματα του αριθμού από τη στιγμή που συνδέεται.
Create a session for a WhatsApp number
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 επιστρέφει την ίδια μορφή οποτεδήποτε.

201 Created
{
  "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.
A number connected
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

Η 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 Embedded Signup για τους πελάτες σας: η δική σας εφαρμογή Tech Provider ή μια φιλοξενούμενη σελίδαΠώς μια SaaS συνδέει τους αριθμούς WhatsApp των πελατών της με το Coexistence: τι απαιτεί η Meta από τον Tech Provider και τι αναλαμβάνει η hosted σελίδα.Ταυτοποίηση Partner API: κλειδιά Bearer ec_live_, εναλλαγή και σφάλματα 401Πώς ταυτοποιούνται τα αιτήματα Partner API: ένα κλειδί ec_live_ ανά λογαριασμό, που εμφανίζεται μία φορά και αντικαθίσταται αμέσως.Όρια και κανόνες του Partner API: οι πολιτικές της Meta, τα 20 μηνύματα το δευτερόλεπτο και ο κανόνας των 14 ημερώνΚανόνες της Meta για το WhatsApp: 20 μηνύματα το δευτερόλεπτο ανά αριθμό Coexistence, ο κανόνας των 14 ημερών και τι τερματίζει ένα κλειδί API.Σύνδεση ενός αριθμού, βήμα προς βήμαΤι συμβαίνει όταν συνδέετε έναν αριθμό μέσω του Coexistence, τι κάνει ο ιδιοκτήτης και τι αποφασίζεται οριστικά.Ποιοι αριθμοί είναι επιλέξιμοι για το CoexistenceΗ έκδοση της εφαρμογής, ο τύπος λογαριασμού, η πρόσβαση στο portfolio και τι κάνει τη Meta να απορρίψει έναν αριθμό στο onboarding του Coexistence.API κοινωνικών δικτύων για AI agents: δημοσίευση, προγραμματισμός, απαντήσεις και μέτρησηΈνα API και MCP server για AI agents: δημοσίευση, προγραμματισμός, απαντήσεις και αναλυτικά σε κοινωνικά δίκτυα μέσω επίσημων API.

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

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

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

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