Jak pobrać tokeny API klientów dla WhatsApp, Instagram i TikTok
Partner API easyCoexistence zwraca token API połączonego klienta oraz jego identyfikatory jednym żądaniem GET z ?credentials=1. Dla numeru WhatsApp /connections/{id} podaje waba_id, phone_number_id, bazowy adres Graph API, endpoint wysyłania oraz własny token firmy klienta. Dla konta społecznościowego /channels/{id} podaje bazowy adres API sieci, identyfikator konta w tej sieci oraz token dostępu odnawiany za Ciebie, dlatego pobieraj go na początku każdego zadania.
Dodaje credentials do GET /connections/{id} dla numeru WhatsApp oraz do GET /channels/{id} dla konta społecznościowego.
Czas życia tokenu dostępu użytkownika Google, jakiego używają wywołania API kanału YouTube.
Ważność tokenu dostępu konta TikTok z API for Business; jego token odświeżania jest ważny przez rok.
Jak długo odświeżony długotrwały token Instagram pozostaje ważny, liczone od dnia jego odświeżenia.
Długotrwałe tokeny dostępu do Page w Meta nie mają daty wygaśnięcia, choć określone warunki mogą je unieważnić.
Które wywołanie zwraca dane dostępowe połączenia?
GET samego zasobu z ?credentials=1, uwierzytelniony kluczem ec_live_ jako token bearer. Numer WhatsApp jest pod /connections/{id}, a konto społecznościowe pod /channels/{id}, każde z własną przestrzenią identyfikatorów: przekierowanie po połączeniu zwraca connection_id dla numeru i channel_id dla konta społecznościowego. GET /connections i GET /channels wyświetlają listy, a ?external_ref= zawęża każdą z nich do jednego klienta. Bez tego parametru te same wywołania zwracają połączenie bez tokenu.
# 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"Co zwraca wywołanie danych dostępowych numeru WhatsApp?
Samo połączenie oraz obiekt credentials. waba_id i phone_number_id identyfikują konto WhatsApp Business oraz numer w Graph API Meta, a token_ready informuje, czy token klienta jest zapisany. Wewnątrz credentials pola graph_api_base i send_endpoint już zawierają wersję Graph API, a access_token to token firmy wydany przez Meta podczas połączenia klienta, ograniczony do tego klienta. Twój backend wywołuje potem Meta bezpośrednio, by wysyłać wiadomości, zarządzać szablonami, przesyłać multimedia i edytować profil firmy.
- status: connected, degraded, disconnected, banned, suspended, removed lub unknown.
quality_ratingimessaging_tier: ocena jakości Meta, na przykład GREEN, oraz poziom numeru, na przykładTIER_1K.webhook_url: adres, pod który Meta wysyła wiadomości z numeru, albo null.disconnected_reason,last_checked_at,last_event_aticreated_at: powód rozłączenia podany przez Meta, jeśli jest zapisany, oraz znaczniki czasu w formacie 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. …"
}
}Co zwraca wywołanie danych dostępowych każdej sieci społecznościowej?
Widok kanału, taki jak GET /channels/{id}, z polami id, channel, external_ref, name, username, external_id, status i token_ready oraz obiektem credentials. Dane dostępowe każdej sieci zawierają platform, bazowy adres API, identyfikator konta w tej sieci, access_token, token_expires_at, token_note oraz przykładowe wywołania. Pole identyfikatora i inne wymagania poszczególnych sieci różnią się:
Dlaczego pobierać token społecznościowy przy każdym zadaniu zamiast go zapisywać?
Bo niektóre tokeny odnawiają się w ciągu doby, a wywołanie danych dostępowych zawsze zwraca token ważny w danym momencie. Token Google dla YouTube jest ważny godzinę, a token TikTok dobę, a easyCoexistence odnawia oba, zanim wygasną. Token Instagram jest ważny 60 dni i odnawia się znacznie wcześniej, wystawiając nowy token. Token strony na Facebooku nie wygasa, dopóki strona pozostaje połączona. Jedno żądanie na początku każdego zadania sprawia, że Twój kod nigdy nie wywoła sieci z wygasłym tokenem.
Czy zapisać token numeru WhatsApp?
Tak. To token firmy z Embedded Signup Meta, który Meta ogranicza do tego wdrożonego klienta, a dokumentacja prosi o zapisanie go po Twojej stronie, bo panel go nie pokazuje. Odczytuj go ponownie po każdym zdarzeniu connection.connected, ponieważ ponowne połączenie może wystawić nowy. Token numeru zawieszonego lub usuniętego nie jest już udostępniany, a token klienta, który Meta przestaje akceptować, mimo że numer nadal odpowiada, zostaje wycofany, co ustawia token_ready na false.
Co oznaczają token_ready i token_missing?
token_ready ma wartość true, gdy token klienta jest zapisany, a połączenie działa. W przypadku numeru może być false zaraz po połączeniu, ponieważ Meta czasem kończy Embedded Signup bez wydania tokenu klienta. Hostowana strona prosi wtedy klienta o jeszcze jedno przejście, a endpoint zdarzeń otrzymuje connection.token_missing. Jeśli klient to pominie, numer odbiera wiadomości, bo jego identyfikatory są poprawne, ale nie może wysyłać. Nowa sesja połączenia dla tego klienta wystawia token i nigdy nie zastępuje działającego. Kanały społecznościowe nie mają token_missing: logowanie zawsze daje własny token klienta, więc token_ready zależy od statusu.
Co zwraca się, gdy połączenie nie ma tokenu do wydania?
Odpowiedź 200, w której credentials ma access_token null i notatkę z instrukcją, zamiast błędu. Dotyczy to numeru z token_ready false, zawieszonego lub usuniętego numeru oraz kanału, którego status nie jest connected; wtedy notatka prosi o nową sesję połączenia. 404 not_found oznacza, że identyfikator nie znajduje się na Twoim koncie, a 502 credentials_unavailable, że nie udało się uzyskać świeżego tokenu społecznościowego w tym momencie. Ponów żądanie, a jeśli się powtarza, sprawdź status kanału.
Typowe błędy
- Zapisywanie tokenu YouTube lub TikTok w pliku konfiguracyjnym. Wygasają one w ciągu godziny i doby, więc wywołuj endpoint danych dostępowych na początku każdego zadania i zostaw odnawianie easyCoexistence.
- Wysyłanie z numeru, którego token_ready ma wartość false. Nie ma wtedy tokenu klienta, którym można wywołać Meta; otwórz nową sesję połączenia dla tego klienta, która go wystawi.
- Wywoływanie TikToka z nagłówkiem Authorization. Jego Business API przyjmuje token w nagłówku Access-Token, a business_id konta podaje się w każdym żądaniu.
- Wywoływanie LinkedIn samym tokenem bearer. LinkedIn wymaga też nagłówków LinkedIn-Version i X-Restli-Protocol-Version wymienionych w required_headers, a URN-y w ścieżkach należy kodować w formacie URL.
easyCoexistence łączy numery WhatsApp Twoich klientów oraz ich konta na Instagramie, Facebooku, TikToku, YouTube i LinkedIn, a także kolejne kanały. Na żądanie przekazuje Twojemu backendowi dane dostępowe każdego połączenia, z odnawianymi tokenami społecznościowymi, a każde połączenie jest monitorowane 24/7. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, z każdym kolejnym połączeniem taniej, a pierwsze 3 dni są bezpłatne.
Najczęściej zadawane pytania
Czy token WhatsApp należy do klienta?
Tak. To token firmy, który Meta wystawia, gdy klient łączy się przez Embedded Signup, ograniczony do tego klienta. Systemowy token easyCoexistence nigdy nie jest udostępniany, a wywołanie zwraca token tylko wtedy, gdy token_ready ma wartość true.
Jak długo ważne są społecznościowe tokeny dostępu?
Token YouTube jest ważny godzinę, token TikTok dobę, a token Instagram do 60 dni, natomiast token strony na Facebooku nie wygasa. easyCoexistence odnawia te, które się zmieniają, więc każde wywołanie danych dostępowych zwraca token działający od razu.
Czy potrzebuję własnej aplikacji deweloperskiej w każdej sieci?
Nie. Klienci logują się przez własną aplikację easyCoexistence w Meta, TikToku, Google i LinkedIn, a wywołanie danych dostępowych przekazuje Twojemu backendowi token do bezpośredniego wywoływania API danej sieci.
Czy asystent taki jak Claude lub ChatGPT może odczytać te same dane dostępowe?
Tak. Zalogowany na Twoje konto przez serwer MCP może wywołać get_api_credentials dla numeru i get_social_credentials dla konta społecznościowego, a zwraca to samo co Partner API.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w