Kullanıcılarınızın WhatsApp, Instagram ve TikTok hesaplarını uygulamanıza nasıl bağlatırsınız
Kullanıcılarınızın WhatsApp, Instagram ve TikTok hesaplarını uygulamanıza bağlamak için, easyCoexistence'ın Partner API'sinde bir connect oturumu oluşturun ve kullanıcıyı barındırılan URL'sine gönderin. Orada WhatsApp numarasını Meta'nın Embedded Signup'ı üzerinden bağlarlar ya da Instagram, Facebook, TikTok, YouTube, LinkedIn ve diğer kanallarda oturum açarlar; ardından yeni bağlantı veya kanal kimliğiyle redirect_url adresinize geri dönerler. Linkler bir saat geçerlidir.
Connect linkinin ne kadar süre çalıştığı; süre dolunca oturum süresi doldu görünür ve yeni bir link gerekir.
Bir hesabın aynı anda açık tutabileceği connect oturumu sayısı; bunun yanında saatte 100 yeni oturum sınırı vardır.
Bir oturum; oluşturulmuş, açılmış, bağlanmış, iptal edilmiş veya süresi dolmuş olabilir; GET /connect-sessions/:id bunu bildirir.
Meta'nın bir WhatsApp numarasının mesaj webhook'larını başka bir yere yönlendirmek için kabul ettiği en uzun alternatif callback URL'si.
Connect linki nasıl çalışır?
Bir ödeme sayfası gibi. Backend'iniz bir oturum oluşturur, arayüzünüz müşteriyi onun URL'sine gönderir, müşteri easycoexistence.com'daki bir sayfada bağlanır ve tarayıcı redirect_url adresinize geri döner. Ardından backend'iniz sonucu doğrular ve yeni bağlantının kimlik bilgilerini alır; hepsi API anahtarınızla yapılır.
İsteğe ne konur?
https://easycoexistence.com/api/v1/connect-sessions adresine POST edilen bir JSON gövdesi; API anahtarınız Bearer token olarak gönderilir. Yalnızca redirect_url zorunludur:
redirect_url: müşterinin sonrasında geldiği bir https URL'si.- channel: varsayılan olan whatsapp, ya da hesabınıza açık bir sosyal ağın küçük harfli adı; örneğin instagram, tiktok veya youtube.
external_ref: bu müşteri için kendi kimliğiniz; en fazla 200 karakter.partner_name: barındırılan sayfada görünen ad, en fazla 80 karakter; varsayılan olarak hesap adınız.webhook_urlilewebhook_verify_token: yalnızca numaralar için ve her zaman birlikte. Meta, numaranın mesajlarını bağlandığı andan itibaren oraya iletir.
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"
}'Geriye ne döner?
201 yanıtı ile oturum döner. Müşteriyi url alanına gönderin ve cs_ ile başlayan id alanını saklayın; oturumu daha sonra bununla arayabilirsiniz. expires_at alanı, oturum oluşturulduktan bir saat sonrasını gösterir; müşteri bağlandığında oturumun kanalına göre connection_id veya channel_id alanı dolar. GET /connect-sessions/:id istediğiniz zaman aynı yapıyı döndürür.
{
"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"
}Oturum oluşturma hangi hataları döndürebilir?
Her hatanın gövdesi aynıdır: code ve message alanları olan bir nesne; message, neyi düzeltmeniz gerektiğini söyler. Oturum oluşturma şunları döndürebilir:
- 400
invalid_jsonveyainvalid_request: gövde bir JSON nesnesi değil ya da bir alan doğrulamayı geçemedi, örneğin https olmayan birredirect_url. - 400
channel_unavailable: kanal bu hesaba açık değil; message açık olanları listeler. - 401 unauthorized: API anahtarı eksik ya da geçersiz.
- 402
billing_required: hesabın henüz kartı yok; bu hesap üzerinden bağlanan her şey ona faturalandırılır. - 429
cap_reached: zaten 50 oturum açık; birkaçının bitmesini ya da süresinin dolmasını bekleyin. - 429
rate_limited: bu saat içinde 100'den fazla oturum; message ne kadar beklemeniz gerektiğini söyler.
Müşteri sonrasında nereye iner?
redirect_url adresinize, sonuç query string'e eklenmiş halde döner. Aynı sonuç oturumda da bulunur; backend'iniz bunu GET /connect-sessions/:id ile okur:
- session: cs_ ile başlayıp rastgele karakterlerden oluşan oturum kimliği.
- status: connected, ya da müşteri 'Cancel and go back' seçeneğini seçtiyse cancelled.
external_ref: oturum bunu taşıdıysa müşteri kimliğiniz.connection_id: yeni numaranın kimliği, /connections için.channel_id: yeni sosyal hesabın kimliği, /channels için.
https://app.example.com/connect/return?session=cs_…&status=connected&external_ref=customer_4821&connection_id=…Bir oturum hangi durumlarda olabilir?
Beş tane. GET /connect-sessions/:id güncel durumu, opened_at, finished_at ve last_error alanlarıyla bildirir; last_error son denemenin neden başarısız olduğunu söyler:
- created: backend'iniz tarafından oluşturulmuş, henüz açılmamış.
- opened: müşteri barındırılan sayfayı yükledi.
- connected: bir numara ya da sosyal hesap bağlandı ve kimliği oturumda yer alır.
- cancelled: müşteri 'Cancel and go back' ile ayrıldı.
- expired: oturum tamamlanmadan önce bir saat doldu.
Bir link ne kadar süre çalışır?
Oluşturulduktan bir saat sonrasına kadar. Bundan sonra barındırılan sayfa müşteriye linkin süresinin dolduğunu söyler; redirect_url adresinize dönmek için status=cancelled işaretli bir düğme bulunur ve oturum expired görünür. Bir hesap aynı anda 50 açık oturum tutabilir ve saatte 100 oturum oluşturabilir; çünkü Meta, ilk kez yapılan her onboarding'i tüm hesapların ortak kullandığı uygulama genelindeki bir limite karşı sayar.
external_ref ne işe yarar?
Her bağlantıyı müşterinize bağlar. Gönderdiğiniz değer, oturumun oluşturduğu numarada ya da kanalda saklanır, yönlendirmeye eklenir ve onunla ilgili her durum olayına dahil edilir; böylece GET /connections?external_ref=customer_4821 ve GET /channels?external_ref=customer_4821, o müşterinin bağlandığı her şeyi listeler. Facebook ya da LinkedIn girişi bir seferde birden fazla Sayfa getirebilir: yönlendirme ilkini belirtir, filtre kalanları listeler. Değişebilecek bir e-posta değil, kendi veritabanınızdan sabit bir kimlik kullanın.
Müşteri iptal ederse ya da giriş başarısız olursa ne olur?
Nerede olduğuna bağlıdır; oturum kaydı tutar:
- Meta'nın açılır penceresi başarısız olur ya da kapanırsa: müşteri link açıkken aynı sayfada yeniden Connect'e basar.
- Sosyal giriş iptal edilir ya da reddedilirse: müşteri nedenini görerek barındırılan sayfaya döner ve link süresi dolana kadar yeniden deneyebilir.
- Hesap zaten başka bir easyCoexistence hesabı üzerinden bağlıysa:
last_errorbunu söyler ve müşteri farklı bir hesapla giriş yapar. - Müşteri 'Cancel and go back' seçerse:
redirect_urlstatus=cancelled alır ve oturum kapanır; başka bir deneme için yeni oturum oluşturun. - Link süresi dolmuşsa: yeni bir oturum oluşturun.
Numara müşterinin token'ı olmadan bağlanırsa ne olur?
Meta, Embedded Signup'ı bazen müşterinin kendi işletme token'ını çıkarmadan tamamlar. Barındırılan sayfa bu durumda bir kez daha çalıştırmayı ister; bu birkaç saniye sürer. Müşteri atlarsa oturum connected görünür, token_ready değeri false olur ve olay URL'niz connection.token_missing olayını alır: numara mesaj alır, çünkü kimlikleri geçerlidir, ama yeni bir connect oturumu onu yeniden bağlayıp token'ı verene kadar mesaj gönderemez.
webhook_url Meta'nın kontrolünden geçemezse ne olur?
Numara yine de bağlanır. Meta, webhook_url alanını bir GET el sıkışmasıyla kontrol eder; uç noktanız hub.verify_token eşleştiğinde hub.challenge değerini geri yansıttığında bu kontrolü geçer. Geçmezse oturumdaki last_error alanı 'webhook_url was not applied' ile başlar ve Meta'nın nedenini verir; uç noktanız yanıt verdiğinde hedefi PUT /connections/:id/webhook ile belirleyin. Bağlandıktan sonraki 24 saat içinde ayarlanırsa, numara yine de kişilerin tek seferlik içe aktarımını ve müşteri paylaşmayı kabul ettiyse sohbet geçmişini alır.
Müşteri ne görür?
easycoexistence.com üzerinde, partner_name alanındaki adınızın yer aldığı bir sayfa; doldurulacak hesap, e-posta ya da kart yok. Bir WhatsApp numarası için kısa bir uygunluk kontrol listesi, ardından Meta'nın açılır penceresi ve WhatsApp Business uygulamasıyla taranacak bir QR kod gösterilir. Sosyal bir hesap için ise 'Continue with TikTok' gibi tek bir düğme görünür; bu düğme ağın kendi onay ekranını aynı sekmede açar, bu yüzden telefonlarda da çalışır.
Yaygın hatalar
- Yalnızca query string'e güvenmek. Herkes bir URL'ye status=connected yazabilir; bu yüzden müşteriyi bağlı olarak işaretlemeden önce backend'inizden GET /connect-sessions/:id ile doğrulayın.
- Linki bir iframe içine gömmek. Müşteriyi yönlendirme ya da yeni sekme ile gönderin; barındırılan sayfa ve açtığı girişler bu şekilde çalışacak şekilde tasarlandı.
- Linkleri önceden oluşturmak. Her link bir saat çalışır ve açık her link 50 sınırına dahil olur; bu yüzden oturumu müşteri bağlanmak üzereyken oluşturun.
- 200 karakterden uzun bir webhook_url göndermek. Meta en fazla 200 karakterlik alternatif callback URL'lerini kabul eder; daha uzunu uygulanmaz ve numara bunsuz bağlanır.
easyCoexistence, müşterilerinizin WhatsApp numaralarını ve Instagram, Facebook, TikTok, YouTube ile LinkedIn hesaplarını, ayrıca diğer kanalları, tek bir barındırılan link üzerinden yazılımınıza bağlar; ardından backend'inize her bağlantının kimlik bilgilerini, webhook'larını ve imzalı durum olaylarını verir. Bağlantı başına aylık US$ 9'dan US$ 0,75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Bir connect linki iki kez kullanılabilir mi?
Hayır. Bir link tek bir numara ya da tek bir sosyal hesap girişiyle tamamlanır; Facebook ya da LinkedIn ile bu birden fazla Sayfa getirebilir. Bundan sonra oturum connected görünür, bu yüzden bir sonraki bağlantı için yeni bir oturum oluşturun.
Linki e-posta ya da sohbetle gönderebilir miyim?
Evet, müşteri bir saat içinde açtığı sürece. URL'deki oturum kimliği sayfayı yetkilendirir; bu yüzden her linki yalnızca onun için oluşturulduğu müşteriye gönderin.
Barındırılan sayfa telefonlarda çalışır mı?
Sosyal girişler çalışır, çünkü aynı sekmede açılırlar. Bir WhatsApp numarası en iyi bilgisayardan bağlanır: telefonda Meta'nın açılır penceresi yeni bir sekmede açılır ve QR kodu taramak için yine telefon gerekir.
Müşterinin bağlandığını yoklama yapmadan nasıl öğrenirim?
Panelde Profile, Developers altında bir durum olayları URL'si ayarlayın. easyCoexistence, bağlantı kurulur kurulmaz imzalanmış ve external_ref değerinizi taşıyan connection.connected ya da channel.connected olayını gönderir.
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