Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Çok kiracılı sosyal medya API'si: tek API anahtarı, çok sayıda müşteri hesabı

easyCoexistence Partner API'si tasarımı gereği çok kiracılıdır: hesabınızdaki tek ec_live_ anahtarı, çok sayıda müşterinin WhatsApp numaralarını ve sosyal hesaplarını bağlar ve yönetir. Her bağlantı, müşterinizin kimliğini external_ref olarak taşır, o müşterinin kendi token'ını tutar, kendi webhook hedefini alır ve imzalı durum olaylarında görünür. Bu sayede GET /channels?external_ref= isteği tek bir müşterinin hesaplarını listeler.

200 characters

Bağlantı oturumunun alabileceği en uzun external_ref: oluşturduğu bağlantıda saklanan, müşteri için kendi kimliğiniz.

1 key

Bir easyCoexistence hesabının aynı anda sahip olabildiği API anahtarı sayısı; ayrı anahtarlar ayrı hesaplar ve ayrı faturalar demektir.

50 open

Bir hesabın aynı anda açık tutabildiği bağlantı oturumu sayısı; saatte 100 yeni oturum sınırının yanında.

5 minutes

İmzalı bir olayın zaman damgasının reddedilmesi gereken yaş; HMAC sabit sürede karşılaştırılır.

Tek bir hesap çok sayıda müşteriye nasıl hizmet verir?

easyCoexistence hesabınız ürününüzü temsil eder ve her müşteri, getirdikleri bağlantılara eklenen bir etikettir. Müşterilerin kendi hesapları yoktur, sizin anahtarınızı hiç görmezler ve faturalandırılmaları easyCoexistence tarafından değil, sizin tarafınızdan yapılır:

Your accountOne ec_live_ key, one bill, one status events URL
Your customerYour own id, sent as external_ref
NumberA WhatsApp number at /connections
ChannelA social account at /channels
DestinationA webhook per number or channel

Her bağlantıyı müşterinizle nasıl etiketlersiniz?

Bağlantı oturumunda external_ref gönderin. Değer, oturumun oluşturduğu numaraya veya kanala kaydedilir, yönlendirme adresine eklenir ve durum olaylarına dahil edilir. Birden fazla Sayfa getiren bir Facebook veya LinkedIn girişi, her birini etiketler. Bir müşterinin hesaplarını görmek için iki listeden birini filtreleyin:

One customer's social accounts and numbers
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
  -H "Authorization: Bearer $EC_API_KEY"

Müşterilerin token'ları birbirinden nasıl ayrı tutulur?

Her bağlantı, kendi müşterisinin token'ını tutar. Bir WhatsApp numarasının token'ı, Embedded Signup sırasında Meta'nın verdiği, o müşterinin varlıklarıyla sınırlı işletme token'ıdır; bir sosyal hesabın token'ı ise hesap sahibinin verdiği yetkidir. Kimlik bilgileri yalnızca anahtarınızla ve sizin arka uç sisteminizden alınır; hesabınızda bulunmayan bir kimlik 404 not_found yanıtı verir. Bir token almadan önce, işin ait olduğu müşterinin bağlantısını bulun; böylece bir kiracının işi hiçbir zaman başka bir hesapta çalışmaz.

Webhook'lar müşteri bazında nasıl çalışır?

Hesap başına bir hedef, sizin seçiminizle. Kanalları tek bir URL'ye yönlendirip gövdedeki account_id ile yönlendirme yapabilirsiniz ya da her müşteriye kendi URL'sini verebilirsiniz. Her kanal, PUT /channels/{id}/webhook isteğiyle ayarlanan kendi sırrıyla imzalar; bu nedenle account_id, doğrulamada hangi sırrın kullanılacağını gösterir. Bir numaranın mesajları Meta'dan, WhatsApp Business Hesabı üzerinde ayarlanan webhook_url'ye gider; bunları phone_number_id ile yönlendirin.

Durum olayları hangi müşteriyle ilgili olduğunu nasıl bildirir?

Kendi external_ref değerini taşıyarak. Hesap başına bir olay URL'si, connection.* ve channel.* olaylarını alır; her olayın içinde bağlantı veya kanal görünümü, external_ref dahil, yer alır. post.published ve post.failed olayları gönderiyi ve onun kanalını taşır. Olaylar, hesabın kendi sırrıyla X-EC-Signature başlığında imzalanır ve uç noktanız başarısız olduğunda yeniden gönderilir; bu yüzden her teslimat kimliğini bir kez işleyin.

Çok sayıda müşteriyi ne kadar hızlı ekleyebilirsiniz?

Hesap başına 50 açık bağlantı oturumu ve saatte 100 yeni oturum. Meta, ilk kez yapılan her WhatsApp kurulumunu, easyCoexistence'ın tüm hesaplarının paylaştığı uygulama genelindeki bir sınıra karşı sayar; sınırlar da tek bir platformun toplu içe aktarımının bu kotayı tüketmesini önler. Her oturumu, müşteri bağlanmak üzereyken oluşturun; sınıra ulaşılırsa 429 cap_reached veya rate_limited yanıtı döner.

Bir müşterinin hesabı başka yerde zaten bağlıysa ne olur?

Oturum açma reddedilir. Bir sosyal hesap aynı anda yalnızca bir easyCoexistence hesabına bağlanabilir; easyCoexistence'ı kullanan başka bir hizmet hesabı tutuyorsa, oturumun last_error alanı bunu belirtir ve müşteri hesabı orada kaldırır ya da farklı bir hesapla oturum açar. Kendi hesabınızın içinde ise bir müşteri ihtiyacı kadar hesap bağlayabilir; hepsi aynı external_ref ile etiketlenir.

Bir müşteriyi hesaptan nasıl çıkarırsınız?

Bağlantılarını ve kanallarını external_ref ile listeleyin ve her birini DELETE ile silin. Bir numarayı kaldırmak, easyCoexistence'ın Meta'daki erişimini iptal eder ve izlemeyi durdurur; bir kanalı kaldırmak ise ağ tarafındaki erişimi iptal eder ve sırada bekleyen gönderileri iptal eder. Her biri için faturalandırma döngünün sonunda durur; müşterinin diğer bağlantıları ise diğer kiracılarınkiler gibi etkilenmez.

Yaygın hatalar

  • external_ref olarak e-posta kullanmak. E-postalar değişir ve değer her bağlantıda saklandığı için kendi veritabanınızdaki sabit kimliği kullanın.
  • İletilen olayları yanlış kiracının sırrıyla doğrulamak. Sırrı gövdedeki account_id ile arayın, çünkü her kanal kendi sırrıyla imzalar.
  • Bağlanma bağlantılarını tüm müşteri tabanınıza aynı anda göndermek. Hesap başına yalnızca 50 oturum açık olabilir; müşterileri bu yüzden dalgalar halinde davet edin.
  • Müşteriyi yalnızca kendi veritabanınızdan silmek. Bağlantıları hesabınızda ve faturanızda kalmaya devam eder; her biri API üzerinden kaldırılana kadar.
Bunu EasyCoexistence'la yapmak

easyCoexistence, tek bir API anahtarının tüm müşteri tabanınıza hizmet vermesini sağlar: WhatsApp numaraları ile Instagram, Facebook, TikTok, YouTube ve LinkedIn hesapları ve daha fazla kanal. Her biri müşteri kimliğinizle etiketlenmiş, kendi token'ı, webhook'u ve imzalı olaylarıyla gelir ve her bağlantı 24/7 izlenir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; bağlantı ekledikçe düşer. İlk 3 gün ücretsiz deneme.

Sık sorulan sorular

Her müşteri için ayrı bir easyCoexistence hesabı gerekir mi?

Hayır. Tek bir hesap ve onun anahtarı, external_ref ile ayırt edilen birçok müşterinin bağlantılarını tutabilir. Ayrı hesaplar yalnızca ayrı faturalar istediğinizde gerekir.

Müşterilerim birbirlerinin hesaplarını görebilir mi?

easyCoexistence üzerinden hayır. Anahtarınızı hiç görmezler ve yalnızca kendi bağlanma bağlantılarını açarlar. Her müşterinin ürününüzün içinde ne göreceği ise kodunuzla belirlenir.

Her müşteriye farklı bir webhook URL'si verebilir miyim?

Evet. Her numara ve her kanal kendi hedefini alır; müşteriye özel bir URL de çalışır, account_id ile yönlendirilen tek bir ortak URL de.

Çok kiracılı bir hesap nasıl faturalandırılır?

Tüm müşterileriniz genelinde bağlantı başına: toplam sayınızın bandına göre, bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; ilk 3 gün ücretsiz deneme.

Okumaya devam edin

Beyaz etiketli sosyal medya API'si: gönderi, yorum ve DM'leri markanız altında SaaS ürününüze ekleyinGönderi, yorum yanıtı ve DM'leri SaaS ürününüze ekleyin: müşterinizin gördükleri, easyCoexistence adının hâlâ göründüğü yerler ve arkadaki API çağrıları.Müşterilerinizin Instagram'ı uygulamanıza nasıl bağlamasına izin verirsinizMüşterilerinizin Instagram hesapları için barındırılan bağlantı: oturum çağrısı, token ve uygulamanızın yorum ve DM yanıtları.Embedded Signup ve Coexistence ile SaaS ürününüze WhatsApp nasıl eklenirSaaS ürününüze WhatsApp ekleyin: müşteri numaralarını Embedded Signup ve Coexistence ile bağlayın, mesaj alın, 24 saatlik pencerede yanıtlayın, şablon gönderin.Partner API kimlik doğrulama: Bearer ec_live_ anahtarları, döndürme ve 401 hatalarıPartner API istekleri şöyle doğrulanır: hesap başına bir ec_live_ anahtarı, bir kez gösterilir, anında döndürülür; eksik ya da hatalı anahtar 401 döndürür.Bir müşterinin WhatsApp veya sosyal medya bağlantısı koptuğunda nasıl öğrenilirconnection.* ve channel.* durum olayları: payload'lar, PRIMARY_INACTIVITY nedeni, X-EC-Signature, 33 saatlik yeniden deneme ve id ile tekilleştirme.Kullanıcılarınızın WhatsApp, Instagram ve TikTok hesaplarını uygulamanıza nasıl bağlatırsınızMüşterilerinizin WhatsApp numaraları ve sosyal hesapları için barındırılan connect linkleri: oturum isteği, yönlendirme, durum, süre ve yeniden denemeler.

İ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