Müşterilerinizin WhatsApp, Instagram ve TikTok API token'ları nasıl alınır
easyCoexistence'ın Partner API'si, bağlı bir müşterinin API token'ını ve kimliklerini ?credentials=1 parametreli tek bir GET isteğiyle döndürür. WhatsApp numarası için /connections/{id}, waba_id ve phone_number_id değerlerini, Graph API tabanını, gönderim uç noktasını ve müşterinin kendi işletme token'ını verir. Sosyal hesap için /channels/{id}, ağın API tabanını, hesabın o ağdaki kimliğini ve sizin için yenilenmiş bir erişim token'ını verir; bu nedenle bu bilgileri her işin başında alın.
WhatsApp numarası için GET /connections/{id}, sosyal hesap için GET /channels/{id} uç noktasına credentials ekler.
Bir YouTube kanalının API çağrılarında kullanılan türde Google kullanıcı erişim token'ının ömrü.
API for Business üzerinden alınan TikTok hesap erişim token'ının geçerlilik süresi; yenileme token'ı bir yıl boyunca geçerlidir.
Yenilenmiş uzun ömürlü Instagram token'ının, yenilendiği günden sayılarak ne kadar geçerli kaldığı.
Meta'nın uzun ömürlü Page erişim token'larının son kullanma tarihi yoktur, ancak bazı koşullar bunları geçersiz kılabilir.
Bir bağlantının kimlik bilgilerini hangi çağrı döndürür?
Kaynağın kendi GET isteği, ?credentials=1 parametresiyle, ec_live_ anahtarınızla bearer token olarak doğrulanır. WhatsApp numarası /connections/{id}, sosyal hesap /channels/{id} adresinde bulunur; her birinin kendi kimlik alanı vardır. Bağlanma yönlendirmesi numara için connection_id, sosyal hesap için channel_id değerini iletir. GET /connections ve GET /channels bunları listeler; ?external_ref= ile her iki listeyi tek bir müşteriye daraltabilirsiniz. Parametre olmadan aynı çağrılar, içinde token bulunmayan bağlantıyı döndürür.
# 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"Bir WhatsApp numarasının kimlik bilgisi çağrısı ne döndürür?
Bağlantının kendisi ve bir credentials nesnesi. waba_id ve phone_number_id, Meta'nın Graph API'sindeki WhatsApp Business Hesabını ve numarayı tanımlar; token_ready ise müşterinin token'ının kayıtlı olup olmadığını belirtir. credentials içinde graph_api_base ve send_endpoint zaten Graph API sürümünü taşır; access_token ise müşteri bağlanırken Meta'nın verdiği ve o müşteriye kapsamlı işletme token'ıdır. Gönderim, şablon yönetimi, medya yükleme ve işletme profilini düzenleme için arka ucunuz doğrudan Meta'yı çağırır.
- status: connected, degraded, disconnected, banned, suspended, removed veya unknown değerlerinden biri.
quality_ratingvemessaging_tier: Meta'nın derecelendirmesi, örneğin GREEN, ve numaranın kademesi, örneğinTIER_1K.webhook_url: Meta'nın numaranın mesajlarını gönderdiği webhook adresi ya da null.disconnected_reason,last_checked_at,last_event_atvecreated_at: Kayıtta varsa Meta'nın bağlantı kesilme nedeni ve ISO 8601 zaman damgaları.
{
"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. …"
}
}Her sosyal ağın kimlik bilgisi çağrısı ne döndürür?
Kanalın görünümü, GET /channels/{id} ile aynıdır: id, channel, external_ref, name, username, external_id, status ve token_ready, ayrıca bir credentials nesnesi. Her ağın credentials nesnesi platform, bir API tabanı, hesabın o ağdaki kimliği, access_token, token_expires_at, bir token_note ve örnek çağrılar içerir. Kimlik alanı ile ağın ihtiyaç duyduğu diğer ayrıntılar ağdan ağa farklılık gösterir:
Sosyal token neden saklamak yerine her iş için ayrıca alınır?
Çünkü bazı token'lar bir gün içinde değişir ve kimlik bilgisi çağrısı her zaman o anda geçerli bir token ile yanıt verir. YouTube'un Google token'ı bir saat, TikTok'unki bir gün geçerlidir ve easyCoexistence ikisini de dolmadan önce yeniler. Instagram'ınki 60 gün geçerlidir ve bundan önce yenilenir, bu da yeni bir token üretir. Bir Facebook Page token'ı, Page bağlı kaldığı sürece dolmaz. Her işin başında yapılan tek istek, kodunuzun süresi dolmuş bir token ile bir ağı çağırmasını engeller.
Bir WhatsApp numarasının token'ı saklanmalı mı?
Evet. Bu, Meta'nın Embedded Signup sürecinden gelen işletme token'ıdır; Meta bunu katılan müşteriye kapsamlar. Referans belgesi, panelde görünmediği için token'ı kendi tarafınızda saklamanızı ister. connection.connected olayından sonra her seferinde yeniden okuyun, çünkü yeniden bağlanma yeni bir token üretebilir. Askıya alınmış ya da kaldırılmış numaranın token'ı artık sunulmaz; numara yanıt vermeye devam ederken Meta'nın artık kabul etmediği bir müşteri token'ı devre dışı kalır ve bu da token_ready değerini false yapar.
token_ready ve token_missing ne anlama gelir?
token_ready, bir müşteri token'ı kayıtlıysa ve bağlantı canlıysa true olur. Bir numarada bağlandıktan hemen sonra false olabilir, çünkü Meta bazen Embedded Signup'ı müşterinin token'ını üretmeden tamamlar. Barındırılan sayfa bu durumda müşteriden bir kez daha işlem ister ve olay uç noktanız connection.token_missing olayını alır. Müşteri bunu atlarsa numara mesaj alır, çünkü kimlikleri geçerlidir, ama gönderemez. O müşteri için yeni bir bağlanma oturumu token'ı üretir ve çalışan bir token'ın yerini asla almaz. Sosyal kanallarda token_missing yoktur: oturum açmaları her zaman müşterinin kendi token'ını verir, bu nedenle token_ready, status değerini izler.
Bir bağlantının verecek token'ı olmadığında ne döner?
200 yanıtı döner; credentials içinde access_token null olur ve ne yapılacağını anlatan bir not bulunur. Bu durum, token_ready değeri false olan numarayı, askıya alınmış ya da kaldırılmış numarayı ve status değeri connected olmayan kanalı kapsar; not, bu durumda yeni bir bağlanma oturumu ister. 404 not_found, kimliğin hesabınızda bulunmadığı anlamına gelir; 502 credentials_unavailable ise o anda yeni bir sosyal token alınamadığı anlamına gelir. Yeniden deneyin ve tekrarlanırsa kanalın status değerine bakın.
Yaygın hatalar
- YouTube veya TikTok token'ını bir yapılandırma dosyasında saklamak. Bunlar sırasıyla bir saat ve bir gün içinde süresi dolar; bu yüzden her işin başında kimlik bilgisi uç noktasını çağırın ve yenilemeyi easyCoexistence'a bırakın.
- token_ready değeri false olan bir numaradan gönderim yapmak. Meta'yı çağırmak için müşteri token'ı yoktur; o müşteri için yeni bir bağlanma oturumu açın, bu bir token üretir.
- TikTok'u Authorization başlığıyla çağırmak. Business API token'ı Access-Token başlığında kabul eder ve her istekte hesabın business_id değerini içerir.
- LinkedIn'i yalnızca bearer token ile çağırmak. LinkedIn ayrıca required_headers içinde listelenen LinkedIn-Version ve X-Restli-Protocol-Version başlıklarını ister ve yollardaki URN'ler URL kodlu olmalıdır.
easyCoexistence, müşterilerinizin WhatsApp numaralarını ile Instagram, Facebook, TikTok, YouTube ve LinkedIn hesaplarını ve daha fazla kanalı bağlar; istek üzerine her bağlantının kimlik bilgilerini arka ucunuza iletir, sosyal token'ları yeniler ve her bağlantıyı 7/24 izler. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında değişir ve bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme sunulur.
Sık sorulan sorular
WhatsApp token'ı müşterinin kendisine mi ait?
Evet. Müşteri Embedded Signup üzerinden bağlandığında Meta'nın verdiği işletme token'ıdır ve o müşteriye kapsamlıdır. easyCoexistence'ın sistem token'ı hiçbir zaman açığa çıkmaz; çağrı yalnızca token_ready true olduğunda bir token döndürür.
Sosyal erişim token'ları ne kadar süre geçerli?
YouTube'unki bir saat, TikTok'unki bir gün, Instagram'ınki ise 60 güne kadar geçerlidir; Facebook Page token'ının süresi dolmaz. easyCoexistence değişen token'ları yeniler, bu nedenle her kimlik bilgisi çağrısı şu anda çalışan bir token döndürür.
Her ağda kendi geliştirici uygulamam gerekir mi?
Hayır. Müşteriler Meta, TikTok, Google ve LinkedIn'de easyCoexistence'ın kendi uygulamasıyla oturum açar; kimlik bilgisi çağrısı, ağın API'sini doğrudan çağırmak için token'ı arka ucunuza verir.
Claude veya ChatGPT gibi bir asistan aynı kimlik bilgilerini okuyabilir mi?
Evet. Hesabınızda MCP sunucusu üzerinden oturum açıldığında, bir numara için get_api_credentials, sosyal bir hesap için get_social_credentials çağırabilir; bu da Partner API ile aynı kimlik bilgilerini döndürür.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi