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

AI agent SaaS mimarisi: müşterilerinizin müşterilerine WhatsApp, Instagram ve TikTok'tan ulaşmak

Müşterilerinizin müşterilerine ulaşan bir AI agent SaaS beş katmanda çalışır: bağlantılar, her müşterinin WhatsApp, Instagram, TikTok ve diğer kanallarını easyCoexistence'ın Partner API'si üzerinden bağladığı katman; olay alımı, webhook'ları doğrulayıp kuyruğa alan katman; size ait bir konuşma deposu; kendi modelinizi çalıştıran bir agent işçisi; ve giden mesajlar, yanıtları, gönderileri ve durum olaylarını her ağın resmi API'si üzerinden yöneten katman.

smb_message_echoes

Coexistence numarasında WhatsApp Business uygulamasından işletme tarafından gönderilen mesajı tanımlayan webhook.

7 days

Meta'nın, uç noktanızın kabul etmediği bir WhatsApp webhook'unu ne kadar süre yeniden denediği; bu, aynı mesajın iki kez gelmesine yol açabilir.

1 attempt

İletilen her Instagram, Facebook veya TikTok olayının teslimatları; yeniden deneme yok ve bir kopya tutulmaz.

24 hours

Bir kişinin mesajından sonra açılan WhatsApp müşteri hizmeti penceresi; bu pencerenin dışında işletme yalnızca onaylı şablon gönderir.

20 mps

WhatsApp Business uygulaması ve Cloud API ile birlikte kullanılan bir numaranın sabit işlem hacmi.

AI agent SaaS'ın katmanları nelerdir?

Beş katman vardır ve her birinin tek bir işi vardır; böylece yavaş bir model hiçbir mesajı kaybetmez, düşen bir hesap da ürünü çökertmez. easyCoexistence ilk ve son katmanda yer alır: hesapları bağlar ve çalışır durumda tutar, konuşma mantığı ve model ise sizin arka ucunuzda kalır.

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

Kiracıları, kanalları ve konuşmaları nasıl modellersiniz?

Üç tabloyla. Bir kiracı müşterinizdir ve id'si her bağlantı oturumunda external_ref olarak gönderilir; böylece her bağlantı ve durum olayı bu etiketle geri döner. Bir kanal satırı, WhatsApp numarasının connection_id'sini ya da sosyal hesabın channel_id'sini, ağı ve durumunu tutar. Bir konuşma, kanal ile kişinin o ağdaki kimliğine göre anahtarlanır: WhatsApp'ta from alanındaki numara, DM'de Instagram'a özgü kimlik veya TikTok'ta yorumun dizisi.

Gelen olaylar önce nereye düşmeli?

Herhangi bir model çalışmadan önce, dayanıklı bir kuyruğa. Alım uç noktası WhatsApp teslimatlarında URL yolundaki gizli anahtarı, iletilen sosyal olaylarda ise X-EC-Signature başlığını denetler, olayı kuyruğa yazar ve 2xx ile yanıt verir. İki kaynak farklı davranır: Meta bir WhatsApp webhook'unu en fazla 7 güne kadar yeniden dener, bu yüzden aynı mesaj iki kez gelebilir. İletilen bir Instagram, Facebook veya TikTok olayı ise bir kez gönderilir ve hiç saklanmaz; uç noktanızın düşürdüğü bir olay bu yüzden kaybolur. Çiftleri ağın kendi mesaj ya da yorum kimliğine göre tekilleştirin.

Yanıtları sırayla ve zamanında nasıl tutarsınız?

Her konuşma için bir işçi ve her gönderimden önce bir denetim. Agent çalışırken konuşmayı kilitleyin; böylece bir kişiden gelen iki mesaj sırayla yanıtlanır ve hiçbiri iki kez yanıtlanmaz. Bir WhatsApp yanıtı çıkmadan önce kişinin son mesajını 24 saatlik pencereyle karşılaştırın; pencere kapanmışsa onaylı bir şablona geçin. Her numaranın gönderimlerini saniyede en fazla 20 mesajla kuyruğa alın; bu, bir Coexistence numarasının sabit hızıdır. Ayrıca bir TikTok yanıtının herkese açık bir yorum olduğunu unutmayın.

Bir kişi agent'tan nasıl devralır?

Doğrudan kanal üzerinden. Coexistence ile müşterinizin çalışanları aynı numarada WhatsApp Business uygulamasını kullanmaya devam eder ve gönderdikleri her mesaj smb_message_echoes olarak webhook'unuza ulaşır. Bir echo'yu devir sinyali olarak ele alın: o konuşmada agent'ı duraklatın, çalışanın yanıtını model için bağlam olarak verin ve sessiz bir dönemden sonra ya da çalışan ürününüzde konuşmayı geri verdiğinde yeniden başlatın. Instagram da hesabın kendi DM'lerini echo olarak geri gönderir; bu yüzden aynı kural agent'ın kendi kendine yanıt vermesini önler.

Agent yalnızca yanıt mı versin, yoksa yayımlasın mı?

Aynı anahtarla yayımlayabilir. Agent gönderi taslakları hazırlar, arka ucunuz bunları Instagram, Facebook, TikTok ve LinkedIn için POST /channels/:id/posts ile kuyruğa alır; gönderiler 1 dakika ile 90 gün önceden planlanabilir ve post.published ile post.failed olayları konuşma deposuna geri bildirilir. LinkedIn gönderileri yalnızca her biri ürününüzde bir kişi tarafından onaylandıktan sonra çıkar, çünkü LinkedIn'in API Koşulları otomatik paylaşımı kısıtlar.

Bir bağlantı koptuğunda ürün nasıl tepki verir?

Kanal satırındaki bir durum üzerinden. Bir durum olayı satırı disconnected, removed veya suspended durumuna çeker, agent o kanalda göndermeyi durdurur ve arayüziniz kiracıdan yeni bir bağlantı oturumuyla yeniden bağlanmasını ister. connection.token_missing olayı bir numarayı alabilir ama gönderemez durumda bırakır; bu durumda agent yanıtları çalışanlar için taslak olarak hazırlar. connection.connected veya channel.connected olayı satırı yeniden active yapar ve işçi bir sonraki yanıttan önce taze kimlik bilgilerini alır.

Hangi verileri siz saklarsınız, easyCoexistence neyi saklar?

Konuşmaları ürününüz saklar. Bir WhatsApp numarasının mesajları Meta'dan doğrudan webhook'unuza gider; iletilen sosyal olaylar ise easyCoexistence'tan bir kopya tutulmadan geçer. easyCoexistence, bağlantıya hizmet etmek için gereken veriyi tutar: hesap kaydını, token'larını, sağlık geçmişini ve yayımladığı gönderileri. Hesabınız easyCoexistence'ın kendi otomasyonlarını da açmışsa, bu otomasyonların mesaj metinleri 7 gün, çalışma kayıtları ise 30 gün saklanır.

Yaygın hatalar

  • Konuşmaları yalnızca kişinin telefon numarasına göre anahtarlamak. Aynı kişi sizin iki kiracınıza yazabilir; bu yüzden her dizi kanal ve kişinin kimliğiyle birlikte anahtarlanmalıdır.
  • Aynı konuşmayı iki işçinin yanıtlamasına izin vermek. Paralel işçiler yanıtları sırasız ya da iki kez gönderebilir; bu yüzden agent çalışırken her diziyi kilitleyin.
  • Çalışan WhatsApp Business uygulamasından yanıt verdikten sonra agent'ı açık bırakmak. Echo, bir kişinin diziyi aldığını gösterir; devir kuralınız diziyi geri verene kadar agent'ı orada duraklatın.
  • Agent'ın LinkedIn taslaklarını bir zamanlayıcıyla yayımlamak. Her LinkedIn gönderisini bir kişi onaylar; bu taslakları kuyruğa ulaşmadan önce bir inceleme adımına yönlendirin.
Bunu EasyCoexistence'la yapmak

easyCoexistence, agent ürününüzün bağlantı katmanıdır: müşterilerinizin WhatsApp numaralarını ve Instagram, Facebook, TikTok, YouTube ve LinkedIn hesaplarını, diğer kanallarla birlikte, barındırılan bağlantı linkleriyle bağlar; taze kimlik bilgileri, webhook'lar, bir yayımlama kuyruğu ve imzalı durum olayları sunar ve her bağlantıyı 7/24 izler. Bağlantı başına aylık US$ 9'dan başlayıp US$ 0.75'e kadar düşen fiyat, bağlantı ekledikçe azalır; ilk 3 gün ücretsizdir.

Sık sorulan sorular

Müşterilerimin müşterilerinin bir şey kurması gerekiyor mu?

Hayır. Müşterileriniz işletmeye bugün yaptıkları gibi yazar: WhatsApp'tan, Instagram DM'lerinden, Messenger'dan ya da yorumlardan. Agent aynı kanaldan yanıt verir.

Müşterilerimin çalışanları elle yanıt vermeye devam edebilir mi?

Evet. Coexistence ile WhatsApp Business uygulaması aynı numarada çalışmaya devam eder ve çalışanların gönderdiği her mesaj bir echo olarak webhook'unuza ulaşır; böylece agent geri çekilebilir.

easyCoexistence modeli çalıştırıyor mu?

Hayır. Model, istemleri ve belleği sizin arka ucunuzda çalışır. easyCoexistence hesapları bağlar, olaylarını iletir ve erişimlerini çalışır durumda tutar.

easyCoexistence, bir agent SaaS'ın her müşterisi için ne kadar ücret alır?

Bağlanan her numara veya hesap ayda US$ 9'dan başlayıp US$ 0.75'e kadar düşen bir fiyatla ücretlendirilir; toplam sayınız arttıkça fiyat düşer. Bu yüzden WhatsApp ve Instagram'ı birlikte kullanan bir müşteri iki kez sayılır. İlk 3 gün ücretsizdir.

Okumaya devam edin

Müşterilerinizin WhatsApp, Instagram ve TikTok'unda AI ajanı ürünü nasıl geliştirilirPartner API, kendi modeliniz ve her ağın koyduğu kurallarla, müşterilerinizin WhatsApp, Instagram, Facebook ve TikTok'unda AI ajan ürünü geliştirin.Bir API üzerinde sosyal medya zamanlayıcısı nasıl oluşturulur: kuyruk, medya ve gönderi durumlarıeasyCoexistence'ın gönderi API'siyle zamanlayıcı kurun: publish_at 90 gün öncesine kadar, medya planlandığında kopyalanır, altı durum ve olaylar.SaaS'ınızda sosyal medya özelliklerini yeniden satmak: bağlantı başına US$ 9 ile US$ 0,75 arasında marjSosyal medya ve WhatsApp özelliklerini bağlantı başına US$ 9 ile US$ 0,75 arasında satan bir SaaS için hesaplanmış marjlar: sabit eklenti ve hesap başına.Ajanslar için sosyal medya API'si: müşterilerinizin hesaplarını kendi yazılımınızdan yönetinAjanslar için API ile müşteri hesaplarını bağlayın, müşteri kimliğiyle etiketleyin, onaylı gönderi yayımlayın, yanıtları yönlendirin ve rapor çıkarın.Müşterilerinizin WhatsApp mesajlarını ve sosyal medya yorumlarını webhook ile nasıl alırsınızHer bağlantı için ayrı webhook: WhatsApp mesajları doğrudan Meta'dan, URL'deki sırla doğrulanır; yorumlar ve DM'ler X-EC-Signature ile imzalanı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.

İ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