Πώς να πάρετε τα API tokens των πελατών σας για WhatsApp, Instagram και TikTok
Το Partner API της easyCoexistence επιστρέφει το API token και τα IDs ενός συνδεδεμένου πελάτη με ένα GET και ?credentials=1. Για έναν αριθμό WhatsApp, το /connections/{id} δίνει τα waba_id, phone_number_id, τη βάση του Graph API, το send endpoint και το token της επιχείρησης του πελάτη. Για έναν λογαριασμό social, το /channels/{id} δίνει τη βάση του API του δικτύου, το ID του λογαριασμού εκεί και ένα access token που ανανεώνεται για εσάς, γι' αυτό το ζητάτε στην αρχή κάθε εργασίας.
Προσθέτει τα διαπιστευτήρια στο GET /connections/{id} για έναν αριθμό WhatsApp και στο GET /channels/{id} για έναν λογαριασμό social.
Διάρκεια ισχύος ενός Google user access token, του τύπου που φέρουν οι κλήσεις του καναλιού YouTube.
Ισχύς του access token λογαριασμού TikTok από το API for Business, ενώ το refresh token του ισχύει για ένα χρόνο.
Πόσο παραμένει σε ισχύ ένα ανανεωμένο long-lived token Instagram, μετρώντας από την ημέρα ανανέωσης.
Τα long-lived Page access tokens της Meta δεν έχουν ημερομηνία λήξης, αν και ορισμένες συνθήκες μπορούν να τα ακυρώσουν.
Ποια κλήση επιστρέφει τα διαπιστευτήρια μιας σύνδεσης;
Το ίδιο GET του πόρου με ?credentials=1, με πιστοποίηση μέσω του κλειδιού σας ec_live_ ως bearer token. Ένας αριθμός WhatsApp βρίσκεται στο /connections/{id} και ένας λογαριασμός social στο /channels/{id}, με τον καθένα να έχει τον δικό του χώρο ID: η ανακατεύθυνση σύνδεσης σας δίνει connection_id για αριθμό και channel_id για λογαριασμό social. Τα GET /connections και GET /channels τα απαριθμούν, και το ?external_ref= περιορίζει οποιαδήποτε λίστα σε έναν πελάτη. Χωρίς την παράμετρο, οι ίδιες κλήσεις επιστρέφουν τη σύνδεση χωρίς token μέσα της.
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"Τι επιστρέφει η κλήση διαπιστευτηρίων ενός αριθμού WhatsApp;
Η ίδια η σύνδεση, συν ένα αντικείμενο credentials. Τα waba_id και phone_number_id προσδιορίζουν τον λογαριασμό WhatsApp Business και τον αριθμό στο Graph API της Meta, και το token_ready δηλώνει αν υπάρχει αποθηκευμένο token πελάτη. Μέσα στα credentials, τα graph_api_base και send_endpoint περιλαμβάνουν ήδη την έκδοση του Graph API, και το access_token είναι το token της επιχείρησης που εξέδωσε η Meta όταν συνδέθηκε ο πελάτης, περιορισμένο σε αυτόν τον πελάτη. Το backend σας καλεί στη συνέχεια απευθείας τη Meta για να στείλει μηνύματα, να διαχειριστεί πρότυπα μηνυμάτων, να ανεβάσει πολυμέσα και να επεξεργαστεί το προφίλ της επιχείρησης.
- status: connected, degraded, disconnected, banned, suspended, removed ή unknown.
quality_ratingκαιmessaging_tier: η βαθμολογία της Meta, όπως GREEN, και το επίπεδο του αριθμού, όπωςTIER_1K.webhook_url: όπου η Meta στέλνει τα μηνύματα του αριθμού, ή null.disconnected_reason,last_checked_at,last_event_atκαιcreated_at: ο λόγος αποσύνδεσης της Meta, όταν υπάρχει καταγεγραμμένος, και χρονικές σημάνσεις ISO 8601.
{
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "connected",
"quality_rating": "GREEN",
"messaging_tier": "TIER_1K",
"platform_type": "…",
"token_ready": true,
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"disconnected_reason": null,
"last_checked_at": "2026-10-31T09:00:00.000Z",
"last_event_at": "2026-10-31T08:41:12.000Z",
"created_at": "2026-10-20T14:03:55.000Z",
"credentials": {
"graph_api_base": "https://graph.facebook.com/v25.0",
"send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
"access_token": "EAAG…",
"note": "The customer's own business token, scoped to their assets. …"
}
}Τι επιστρέφει η κλήση διαπιστευτηρίων κάθε δικτύου social;
Η προβολή του καναλιού, ίδια με το GET /channels/{id}, με id, channel, external_ref, name, username, external_id, status και token_ready, συν ένα αντικείμενο credentials. Τα διαπιστευτήρια κάθε δικτύου περιέχουν platform, μια βάση API, το ID του λογαριασμού στο δίκτυο, access_token, token_expires_at, ένα token_note και παραδείγματα κλήσεων. Το πεδίο ID, καθώς και ό,τι άλλο χρειάζεται ένα δίκτυο, διαφέρει:
Γιατί να ζητάτε το token ενός δικτύου σε κάθε εργασία αντί να το αποθηκεύετε;
Επειδή ορισμένα ανανεώνονται μέσα σε μία ημέρα, και η κλήση διαπιστευτηρίων απαντά πάντα με token που ισχύει εκείνη τη στιγμή. Το token της Google για το YouTube λήγει σε μία ώρα και του TikTok σε μία ημέρα, και το easyCoexistence ανανεώνει και τα δύο πριν τελειώσουν. Του Instagram ισχύει 60 ημέρες και ανανεώνεται αρκετά νωρίτερα, οπότε εκδίδεται νέο token. Το token σελίδας του Facebook δεν λήγει όσο η σελίδα παραμένει συνδεδεμένη. Ένα αίτημα στην αρχή κάθε εργασίας εμποδίζει τον κώδικά σας να καλέσει ποτέ ένα δίκτυο με token που έχει λήξει.
Πρέπει να αποθηκεύσετε το token ενός αριθμού WhatsApp;
Ναι. Είναι το token της επιχείρησης από το Embedded Signup της Meta, που η Meta το περιορίζει στον πελάτη που έχει ενταχθεί, και η τεκμηρίωση ζητά να το αποθηκεύσετε από την πλευρά σας, αφού ο πίνακας ελέγχου δεν το εμφανίζει. Διαβάστε το ξανά μετά από κάθε γεγονός connection.connected, επειδή μια επανασύνδεση μπορεί να εκδώσει νέο. Το token ενός ανασταλμένου ή αφαιρεμένου αριθμού δεν επιστρέφεται πια, και ένα token πελάτη που η Meta σταματά να δέχεται, ενώ ο αριθμός εξακολουθεί να απαντά, αποσύρεται, κάτι που κάνει το token_ready false.
Τι σημαίνουν τα token_ready και token_missing;
Το token_ready είναι true όταν υπάρχει αποθηκευμένο token πελάτη και η σύνδεση είναι ενεργή. Σε έναν αριθμό μπορεί να είναι false αμέσως μετά τη σύνδεση, επειδή η Meta μερικές φορές ολοκληρώνει το Embedded Signup χωρίς να εκδώσει το token του πελάτη. Η σελίδα που φιλοξενείται τότε ζητά από τον πελάτη μία ακόμη εκτέλεση, και το endpoint γεγονότων σας λαμβάνει το connection.token_missing. Αν την παραλείψει, ο αριθμός λαμβάνει μηνύματα, αφού τα IDs του είναι έγκυρα, αλλά δεν μπορεί να στείλει. Μια νέα συνεδρία σύνδεσης για τον πελάτη εκδίδει το token και δεν αντικαθιστά ποτέ εκείνο που ήδη λειτουργεί. Τα κανάλια social δεν έχουν token_missing: η σύνδεσή τους δίνει πάντα το δικό τους token πελάτη, οπότε το token_ready ακολουθεί το status.
Τι επιστρέφεται όταν μια σύνδεση δεν έχει token να δώσει;
Ένα 200 του οποίου το credentials έχει access_token null και μια σημείωση για το τι πρέπει να γίνει, αντί για σφάλμα. Αυτό καλύπτει έναν αριθμό με token_ready false, έναν ανασταλμένο ή αφαιρεμένο αριθμό, και ένα κανάλι του οποίου το status δεν είναι connected, όπου η σημείωση ζητά νέα συνεδρία σύνδεσης. Το 404 not_found σημαίνει ότι το ID δεν βρίσκεται στον λογαριασμό σας, και το 502 credentials_unavailable σημαίνει ότι δεν ήταν δυνατό να ληφθεί νέο token social εκείνη τη στιγμή. Επαναλάβετε το αίτημα, και ελέγξτε την κατάσταση του καναλιού αν το σφάλμα επαναληφθεί.
Συνηθισμένα λάθη
- Αποθήκευση token του YouTube ή του TikTok σε αρχείο ρυθμίσεων. Λήγουν μέσα σε μία ώρα και μία ημέρα, οπότε καλέστε το endpoint διαπιστευτηρίων στην αρχή κάθε εργασίας και αφήστε την ανανέωση στο easyCoexistence.
- Αποστολή από αριθμό με token_ready false. Δεν υπάρχει token πελάτη με το οποίο να καλέσετε τη Meta. Ανοίξτε νέα συνεδρία σύνδεσης για τον πελάτη, που θα εκδώσει ένα.
- Κλήση του TikTok με header Authorization. Το Business API θέλει το token σε header Access-Token, με το business_id του λογαριασμού σε κάθε αίτημα.
- Κλήση του LinkedIn μόνο με το bearer token. Το LinkedIn θέλει επίσης τις κεφαλίδες LinkedIn-Version και X-Restli-Protocol-Version που αναγράφονται στο required_headers, και τα URN στα paths κωδικοποιημένα με URL.
Το easyCoexistence συνδέει τους αριθμούς WhatsApp των πελατών σας και τους λογαριασμούς τους σε Instagram, Facebook, TikTok, YouTube και LinkedIn, καθώς και περισσότερα κανάλια. Στη συνέχεια δίνει στο backend σας τα διαπιστευτήρια κάθε σύνδεσης όταν τα ζητήσετε, με ανανεωμένα tokens social και κάθε σύνδεση παρακολουθούμενη 24/7. US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Είναι το token WhatsApp του πελάτη δικό του;
Ναι. Είναι το token της επιχείρησης που εκδίδει η Meta όταν ο πελάτης συνδέεται μέσω του Embedded Signup, περιορισμένο σε αυτόν τον πελάτη. Το token συστήματος του easyCoexistence δεν εκτίθεται ποτέ, και η κλήση επιστρέφει token μόνο όταν το token_ready είναι true.
Πόσο διαρκούν τα access tokens των social;
Του YouTube ισχύει μία ώρα, του TikTok μία ημέρα και του Instagram έως 60 ημέρες, ενώ το token σελίδας Facebook δεν λήγει. Το easyCoexistence ανανεώνει όσα λήγουν, οπότε κάθε κλήση διαπιστευτηρίων επιστρέφει token που λειτουργεί τώρα.
Χρειάζομαι δική μου εφαρμογή προγραμματιστή σε κάθε δίκτυο;
Όχι. Οι πελάτες συνδέονται μέσω της δικής της εφαρμογής του easyCoexistence στη Meta, στο TikTok, στη Google και στο LinkedIn, και η κλήση διαπιστευτηρίων δίνει στο backend σας το token για να καλεί απευθείας το API εκείνου του δικτύου.
Μπορεί ένας βοηθός όπως το Claude ή το ChatGPT να διαβάσει τα ίδια διαπιστευτήρια;
Ναι. Συνδεδεμένος στον λογαριασμό σας μέσω του MCP server, μπορεί να καλέσει το get_api_credentials για έναν αριθμό και το get_social_credentials για έναν λογαριασμό social, που επιστρέφει τα ίδια διαπιστευτήρια με το Partner API.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις