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

Müşterilerinizin WhatsApp, Instagram ve TikTok'unda AI ajanı ürünü nasıl geliştirilir

Müşterilerinizin kanallarında çalışan bir AI ajan ürünü üç parçaya dayanır: her müşterinin WhatsApp numarası ya da sosyal medya hesabı için barındırılan bir bağlanma bağlantısı; mesajlarını ve yorumlarını arka ucunuza ulaştıran webhook'lar; arka ucunuzda kendi modeliniz tarafından yazılan ve müşterinin token'ıyla her ağın resmi API'si üzerinden gönderilen yanıtlar; bir de düşen bağlantılar için durum olayları. Ajan, her ağın kurallarını korur; örneğin WhatsApp'ın 24 saatlik pencere kuralını.

easyCoexistence, ürününüzün AI ajanlarına müşterilerinizin WhatsApp numaralarında ve Instagram, Facebook, TikTok, YouTube ve LinkedIn hesaplarında ses verir; ve daha fazla kanal.

24 hours

WhatsApp'ta müşteri hizmeti penceresi, bir kullanıcının mesajından ya da aramasından sonra açılır; her yeni mesaj pencereyi yeniden başlatır.

Templates only

Müşteri hizmeti penceresi kapandıktan sonra bir WhatsApp işletmesinin gönderebildiği şey: önceden onaylanmış şablon mesajları.

Section 4.7

Meta'nın koşulları, AI sağlayıcılarının WhatsApp'ı, AI'yı tali değil asıl işlev olarak sunmak için kullanmasını yasaklar.

7 days

Bir Instagram hesabının bir yoruma verebileceği tek özel yanıt için süre, yorumun yapıldığı andan itibaren başlar.

20 mps

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

AI ajan ürünü, her müşterinin kanalından neye ihtiyaç duyar?

Dört şey: müşterinin bağlanabilmesi için bir yol, mesajlarının arka ucunuza ulaşması, yanıt vermek için bir token ve bağlantı durduğunda haber alma. Partner API bunların hepsini kapsar; model, istemler ve konuşma mantığı ise size aittir. easyCoexistence hesabı bağlar, erişimini yenilenmiş tutar ve izler; yanıtlarınız arka ucunuzdan doğrudan ağın API'sine gider.

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

Her müşteri nasıl bağlanır?

Arka ucunuz POST /connect-sessions ile bir bağlanma oturumu oluşturur; kanalı, redirect_url ve müşteriniz için bir external_ref belirtir, bir numara için de webhook_url ve webhook_verify_token ekler. Müşteri barındırılan bağlantıyı açar, Meta, TikTok, Google ya da LinkedIn ile oturum açar ve connection_id ya da channel_id ile uygulamanıza döner. easyCoexistence hesabı gerekmez, e-posta ya da kart da gerekmez; API anahtarınızla yapılan her bağlantı sizin hesabınıza aittir.

Mesajlar ve yorumlar modelinize nasıl ulaşır?

Webhook ile, bunları gönderen ağlarda. Meta, bir numaranın mesajlarını doğrudan webhook_url'ine iletir; işletmenin çalışanlarının WhatsApp Business uygulamasından gönderdikleri ise smb_message_echoes olarak oraya ulaşır. Instagram ve Facebook yorumları, etiketlemeleri ve DM'leri ile TikTok yorumları, her kanalın hedefine, kendi sırrıyla imzalanmış olarak iletilir. YouTube ve LinkedIn yorum olayı göndermez; bu yüzden ajan yeni yorumları API'leri üzerinden bir zamanlamaya göre okur. Her teslimata hemen 2xx ile yanıt verin ve modeli bir işçi süreç çağırsın.

Ajan nasıl yanıt verir?

Ağın kendi API'si üzerinden, arka ucunuzun aldığı kimlik bilgileriyle. Bir WhatsApp yanıtı, numaranın send_endpoint adresine müşterinin token'ıyla yapılan bir POST'tur; bir Instagram ya da Facebook DM'i hesabın messages edge'ine gider; bir TikTok yanıtı business/comment/reply/create/ ile yorumun altına yazılır. Aşağıdaki taslak WhatsApp mesajlarına yanıt verir: URL yolundaki sırrı denetler, gelen her mesajı kuyruğa alır ve modelinizin döndürdüğü metinle yanıt verir.

Python: a WhatsApp agent on your own model
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request

EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}  # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"]  # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {}  # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)

@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
    if not hmac.compare_digest(secret, PATH_SECRET):
        abort(404)
    if request.method == "GET":  # Meta's handshake when the destination is set
        if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
            abort(403)
        return request.args.get("hub.challenge", "")
    for entry in request.get_json().get("entry", []):
        for change in entry.get("changes", []):
            if change.get("field") == "messages":  # echoes and history are context, not prompts
                value = change["value"]
                for msg in value.get("messages", []):
                    jobs.put((value["metadata"]["phone_number_id"], msg))
    return "", 200  # answer at once; dedupe on msg["id"], since Meta can deliver twice

def worker() -> None:
    while True:
        phone_number_id, msg = jobs.get()
        conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
                            headers=KEY, params={"credentials": 1}).json()
        creds = conn["credentials"]
        if not creds["access_token"]:  # token_ready is false: a new connect session issues one
            continue
        reply = my_model(conn["external_ref"], msg)  # your model, your prompt, your memory
        requests.post(creds["send_endpoint"],  # a reply to a fresh message is inside the 24 hours
                      headers={"Authorization": f"Bearer {creds['access_token']}"},
                      json={"messaging_product": "whatsapp", "to": msg["from"],
                            "type": "text", "text": {"body": reply}})

threading.Thread(target=worker, daemon=True).start()

MCP sunucusu mu, Partner API mi: ajan hangisini kullanır?

Partner API; ajan sizin ürününüzse ve müşterileriniz kanalları getiriyorsa: arka ucunuz anahtarı tutar, olayları alır ve seçtiğiniz her modeli çalıştırır. https://easycoexistence.com/api/mcp adresindeki MCP sunucusu, Claude ya da ChatGPT gibi bir asistana uygundur; asistan, OAuth ile oturum açıldıktan sonra istek üzerine çağırdığı araçlarla kendi easyCoexistence hesabınızda çalışır. Anahtarınızla bağlanan numaralar ve kanallar da bu hesapta durur; böylece bir MCP oturumu, ekibinizin kendi işleri için bunlara erişebilir.

Partner APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools such as send_message and reply_to_comment

Ajanslar birçok müşteri için ajanları nasıl çalıştırır?

Tek bir hesapta, her müşteri etiketlenerek. Her bağlanma oturumuna müşterinin kimliğini external_ref olarak gönderin, ajansınızın adını barındırılan sayfada partner_name ile gösterin ve bir müşterinin bağlantılarını GET /connections?external_ref= ve GET /channels?external_ref= ile listeleyin. Her bağlantı ajansa, bağlantı eklendikçe düşen bir fiyatla, ayda bağlantı başına US$ 9 ile US$ 0.75 arasında faturalanır; Meta ise WhatsApp konuşma ücretlerini müşterinin kendi WhatsApp Business Account'una yansıtır. Coexistence ile müşterinin çalışanları, ajanın yanında WhatsApp Business uygulamasından yanıt vermeye devam eder.

Ajanın uyması gereken kurallar hangileri?

Ağların kendi kuralları; modelin yanıtı gönderilmeden önce kodunuzun bunları denetlemesi gerekir. Platformlar bu kuralları müşterileri adına tutar, çünkü Meta'nın yaptırımı müşterinin hesabına uygulanır:

  • WhatsApp: serbest metinli yanıtlar yalnızca müşterinin son mesajından itibaren 24 saat içinde; bundan sonra önceden onaylanmış bir şablon, API üzerinden gönderilir; çünkü WhatsApp Business uygulaması Coexistence'ta şablon gönderemez.
  • WhatsApp: Meta'nın koşulları AI'yı birincil işlev olarak sunmayı yasaklar; Partner API başvurusu bunu genel amaçlı AI botu yok diye ifade eder ve WhatsApp verileri üzerinde ince ayara yalnızca işletmenin münhasır kullanımı için izin verir.
  • Instagram ve Facebook: DM'ler kişinin son mesajından itibaren 24 saat içinde, her yorum için tek özel yanıt ise yorumdan itibaren 7 gün içinde.
  • TikTok: yorumlara yanıtlar herkese açıktır, çünkü bir TikTok bağlantısında DM yoktur.
  • Hacim: Coexistence numarası başına saniyede 20 mesaj; pazarlama şablonları ise müşterinin WhatsApp Business Account'unda bir ödeme yöntemi gerektirir.

Ajan bir kanalın çalışmayı durdurduğunu nasıl anlar?

Durum olaylarından. connection.disconnected ya da channel.disconnected, müşteri yeniden bağlanana kadar yanıtların başarısız olduğu anlamına gelir; bu nedenle o müşterinin ajanını duraklatın, müşteriye bildirin ve yeni bir bağlanma bağlantısı gönderin. connection.token_missing ise numaranın mesaj alabildiğini ama henüz gönderemediğini ifade eder. connection.connected ya da channel.connected yeniden geldiğinde taze kimlik bilgilerini alın ve devam edin. Her olay X-EC-Signature ile imzalanır ve yaklaşık 33 saat boyunca yeniden denenir.

Yaygın hatalar

  • Modelin 24 saatten eski bir WhatsApp mesajına serbest metinle yanıt vermesine izin vermek. Pencere kapanmıştır; bu yüzden müşterinin son gelen mesajının zamanını kontrol edin ve önceden onaylanmış bir şablona geçin.
  • Paylaşılan bir modeli müşterilerin WhatsApp konuşmaları üzerinde eğitmek. Meta'nın koşulları, WhatsApp Business Platform verileri üzerinde ince ayarı yalnızca işletmenin münhasır kullanımı için izin verir; diğer modelleri geliştirmek için asla.
  • smb_message_echoes'ı müşteri mesajı sanmak. Bunlar işletmenin çalışanlarının uygulamadan gönderdikleri mesajlardır; bunları modele yanıtlanacak mesajlar olarak değil, bağlam olarak verin.
  • Hesabın kendi yanıtlarına cevap vermek. Hesabın gönderdiği Instagram DM'leri yankı olarak geri gelir, TikTok yanıtları ise yorum olayı olarak; bu yüzden hesabın kendi yazdığı her şeyi atlayın, yoksa ajan kendi kendine yanıt verir.
Bunu EasyCoexistence'la yapmak

Her ağın resmi API'si üzerinde barındırılan bağlanma bağlantıları, taze kimlik bilgileri, webhook'lar ve imzalı durum olayları; her bağlantı 7/24 izlenir. Ayda bağlantı başına US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Kendi AI modelimi kullanabilir miyim?

Evet. Arka ucunuz mesajları alır, seçtiğiniz herhangi bir modeli çağırır ve müşterinin token'ıyla ağın API'si üzerinden yanıt verir. Bir WhatsApp numarasının mesajları Meta'dan doğrudan webhook'unuza gider, asla easyCoexistence üzerinden geçmez.

Meta'nın AI politikası bir WhatsApp ajanı için ne anlama gelir?

Meta'nın koşulları, AI sağlayıcılarının WhatsApp Business Platform'u, Meta'nın belirlediği üzere, tali ya da yardımcı değil, birincil işlev olarak AI teknolojisi sunmak için kullanmasını yasaklar. Müşterileriniz adına bu kurala, 24 saatlik pencereye ve onaylı şablonlara uyun.

Ajan TikTok, YouTube ya da LinkedIn'de DM gönderebilir mi?

Hayır. Bu ağlarda ajan yorumlar üzerinden çalışır: TikTok yanıtları herkese açıktır; YouTube ve LinkedIn yorumları API'leri üzerinden okunur ve yanıtlanır.

AI ajan ürünü için easyCoexistence ne kadara mal olur?

Bağlantı başına, her ağda aynı: ayda bağlantı başına US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme. Meta, WhatsApp konuşma ücretlerini her müşterinin kendi WhatsApp Business Account'una yansıtı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