Ajanslar için sosyal medya API'si: müşterilerinizin hesaplarını kendi yazılımınızdan yönetin
Ajanslar için sosyal medya API'si, ajansın kendi yazılımının her müşterinin hesaplarını bağlamasına, gönderi yayımlamasına, yanıt vermesine ve rapor çıkarmasına olanak tanır. easyCoexistence'ın Partner API'si sayesinde müşterinin WhatsApp numarası ile Instagram, Facebook, TikTok, YouTube ve LinkedIn hesapları, müşteri kimliğiyle etiketlenmiş barındırılan bağlantılar üzerinden ajansın hesabına katılır; tek bir API anahtarı bunların hepsini zamanlar, yönlendirir ve izler.
Bir bağlantı oturumunun kabul ettiği en uzun external_ref, yani ajansın müşteriye verdiği kendi kimliği; her bağlantıda tutulur.
Barındırılan bağlantı linkinin, onu açan müşteri için ne kadar süre çalıştığı.
Sahibi veya yöneticisi olmadığı Instagram profesyonel hesaplarına hizmet verebilmek için bir Meta uygulamasının neye ihtiyacı olduğu; App Review ve Business Verification sonrasında.
rw_organization_admin izni için bir üyenin sahip olması gereken LinkedIn Sayfası rolü; bu izin Sayfaları yönetir ve raporlarını okur.
Ajansın API üzerinden kaldırdığı bir müşteri bağlantısı için faturalandırmanın ne zaman duracağı.
API ajansın müşterilerini nasıl düzenler?
Müşteri kimliğinizle. Her bağlantı oturumunda external_ref olarak gönderin; bu değer oturumun oluşturduğu her numarada ve hesapta kalır ve her durum olayında geri döner. GET /channels?external_ref=client_118 o müşterinin sosyal hesaplarını listeler; tek bir ağa daraltmak için &channel=instagram ekleyin. GET /connections?external_ref=client_118 ise WhatsApp numaralarını listeler. Her müşteri ajansın tek hesabında, tek bir ec_live_ anahtarı altında yer alır; bu da tüm sayıyı tek bir fiyat bandında tutar.
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"Müşteri erişimi nasıl verir?
Ajansın gönderdiği bir bağlantı ile. channel olarak ağı, external_ref olarak müşterinin kimliğini ve partner_name olarak ajansın adını içeren POST /connect-sessions isteği bir url döndürür. Müşteri bu url'yi açar, ağın kendi onay ekranında oturum açar veya bir WhatsApp numarası için Meta'nın açılır penceresini çalıştırıp QR kodu tarar ve ajansın redirect_url adresine geri döner. Facebook veya LinkedIn girişi aynı anda birden fazla Sayfa getirebilir; her biri ayrı bir bağlantıdır, bu yüzden listeyi müşterinin talebiyle karşılaştırın.
Ajans müşteriler için nasıl yayımlar?
Kendi onay akışından. Ajansın yazılımı, müşteri onaylayana kadar taslakları tutar; onaylanan her gönderiyi, 90 gün öncesine kadar publish_at alanıyla birlikte POST /channels/:id/posts adresine gönderir. GET /channels/:id/posts tek bir hesabın takvimini verir, durum filtreli GET /posts ise müşteriler genelinde bekleyenleri gösterir; post.published ve post.failed olayları hesap yöneticisine ne olduğunu bildirir. LinkedIn gönderileri her zaman bir kişinin onayından geçer; ajansın onay adımı bunu zaten sağlar.
Ajans müşteriler için yorumlara ve DM'lere nasıl yanıt verir?
Hesaba göre yönlendiren tek bir gelen kutusundan. PUT /channels/:id/webhook her Instagram hesabı, Facebook Sayfası ve TikTok hesabı için bir hedef belirler; iletilen her yorum, etiketleme veya DM, müşteriye eşlenen account_id alanını taşır. Bir WhatsApp numarasının mesajları Meta'dan, o numara için ayarlanan webhook_url adresine gider. Yanıtlar, GET /channels/:id?credentials=1 ile alınan kimlik bilgileriyle her ağın API'si üzerinden gider; ajansın ekibi ayrıca aynı hesaptaki MCP bağlayıcısı üzerinden Claude veya ChatGPT içinde müşteriler arasında çalışabilir.
Ajans müşteri raporlarını nasıl oluşturur?
Her ağın kendi analitiğinden, müşteri hesabının kimlik bilgileriyle çağrılarak. Instagram ve Facebook içgörüleri Meta'nın Graph API'sinden, TikTok'unkiler API for Business'ından, YouTube'unkiler YouTube Analytics'ten gelir; YouTube için kimlik bilgileri bunun temel adresini de içerir. LinkedIn verileri ise istatistik uç noktalarından alınır. Ajansın rapor işi, her çalıştırmanın başında hesap başına taze kimlik bilgilerini alır, dönemin rakamlarını çeker ve bunları müşterinin external_ref kimliği altına kaydeder.
Ajans bir müşterinin hesabının dikkat gerektirdiğini nasıl anlar?
İmzalı durum olaylarından. channel.disconnected ve connection.disconnected olayları müşterinin external_ref kimliğini taşır; böylece ajansın yazılımı o müşterinin hesap yöneticisini uyarabilir ve müşteriye yeni bir bağlantı linki gönderebilir. Her bağlantı 7/24 izlenir ve bir bağlantı koptuğunda ajansın sahibine e-posta da gönderilir. Müşteri ağın ayarlarından erişimi geri alırsa bu da aynı şekilde görünür.
Müşteri ayrıldığında API'de ne olur?
Ajansın çıkış işi, müşterinin bağlantılarını external_ref ile listeler ve her biri için DELETE /channels/:id ile DELETE /connections/:id çağrısı yapar. Bunların faturalandırması dönem sonunda durur; kaldırılan bir kanaldaki planlı gönderiler iptal edilir ve kaldırılan sosyal hesabın token'ı silinir. Bir WhatsApp numarası, müşteri onu WhatsApp Business uygulamasında bağlantısını kesene kadar Cloud API'de kalır.
Yaygın hatalar
- Müşteri onaylamadan gönderileri kuyruğa almak. Kuyruğa alınmış bir gönderi, kendi zamanında başka bir kontrol olmadan yayımlanır; bu yüzden taslakları onay adımınızda tutun ve yalnızca onaylandıklarında gönderin.
- Partner API anahtarını bir müşteri portalının ön yüzüne koymak. Anahtar, hesaptaki her müşterinin kimlik bilgilerine erişir; bu yüzden onu ajansın sunucusunda tutun.
- Bir müşterinin YouTube kanalından ya da LinkedIn Sayfasından yorum olayları beklemek. easyCoexistence bunların hiçbirinden olay almaz; bu yüzden rapor veya gelen kutusu işi bunları her ağın API'si üzerinden okur.
easyCoexistence, ajansın kendi yazılımına müşterilerinin WhatsApp numaraları ile Instagram, Facebook, TikTok, YouTube ve LinkedIn hesapları için tek bir API sunar; daha fazla ağ da gelecek. Müşteri başına etiketlenmiş barındırılan bağlantı linkleri, bir yayın kuyruğu, iletilen yorumlar ve DM'ler, raporlar için taze kimlik bilgileri ve 7/24 izlenen her bağlantı bunun parçalarıdır. Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında, eklediğiniz bağlantı arttıkça düşer; ilk 3 gün ücretsiz deneme sunulur.
Sık sorulan sorular
Müşterilerin easyCoexistence hesabı olması gerekir mi?
Hayır. Müşteri barındırılan linki açar ve oturum açar; bağlantı ajansın hesabına katılır, orada faturalandırılır ve izlenir.
Ajans müşterileri ayrı API anahtarlarında tutabilir mi?
Bir hesap tek bir anahtar tutar. Ayrı anahtarlar ayrı easyCoexistence hesapları demektir; her biri ilk fiyat bandından itibaren faturalandırılır. Bu yüzden çoğu ajans müşterileri external_ref ile ayırır.
Müşteri bağlanırken ajansın adını görebilir mi?
Evet. Barındırılan sayfa, partner_name ile gönderilen adı gösterir. Ağın kendi onay ekranında ise erişim isteyen uygulama olarak easyCoexistence adı geçer.
easyCoexistence bir ajans için ne kadar tutar?
Müşteri bağlantısı başına aylık US$ 9 ile US$ 0,75 arasında; ajans müşteri ekledikçe düşer. Tüm ağlarda aynıdır ve ilk 3 gün ücretsiz deneme sunulur.
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