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

Bir müşterinin WhatsApp veya sosyal medya bağlantısı koptuğunda nasıl öğrenilir

easyCoexistence, bir müşterinin bağlantısı bağlandığında, koptuğunda, kaldırıldığında veya askıya alındığında platformunuza imzalı durum olayları gönderir. Bir WhatsApp numarası connection.connected, Meta'nın nedeniyle birlikte connection.disconnected, connection.removed, connection.suspended veya connection.token_missing gönderir; bir sosyal hesap ise token_missing hariç channel.* karşılıklarını gönderir. Her biri X-EC-Signature ile imzalanmış bir JSON POST isteğidir ve uç noktanız 2xx yanıtı verene kadar artan aralıklarla yaklaşık 33 saat boyunca yeniden denenir.

~14 days

PRIMARY_INACTIVITY: Birincil cihaz yaklaşık 14 gün hareketsiz kaldığında Coexistence numarasının bağlantısını kesen Meta nedeni.

~30 days

COMPANION_INACTIVITY: Eşlik eden cihaz yaklaşık 30 gün hareketsiz kaldığında Meta'nın verdiği neden.

account_update

Bağlantı kesilmesini bildiren webhook. Meta bunu her zaman uygulamanın varsayılan geri çağırma URL'sine gönderir, asla geçersiz kılınmış bir adrese göndermez.

7 attempts

2xx dışında bir yanıt alındığında durum olayının yeniden denenme sıklığı: 1 dakika ile 24 saat arasındaki aralıklarla, yaklaşık 33 saat boyunca.

5 minutes

Uç noktanın bir durum olayında kabul etmesi gereken en eski imzalı zaman damgası t. HMAC'i sabit sürede karşılaştırın.

Hangi durum olayları var?

Dokuz tane var; bunlar aynı uç noktayı ve aynı imza sırrını paylaşan iki ailede toplanır. Numaralar connection.*, sosyal hesaplar channel.* kullanır; bu yüzden yalnızca numaraları işleyen bir alıcı channel olaylarını ada göre atlayabilir. Uç noktayı panelde Profile, ardından Developers altından veya set_partner_events_url MCP aracıyla ayarlayın; imza sırrı URL kaydedildiğinde yalnızca bir kez gösterilir.

connection.connectedA number connected, came back after a drop, or got its customer token on a second run.
connection.disconnectedMeta dropped the link; reason carries Meta's code when known.
connection.removedRemoved with DELETE /connections/{id} or from the dashboard.
connection.suspendedYour subscription lapsed; reason names its state.
connection.token_missingConnected without a customer token: it receives, but cannot send yet.
channel.connectedA social account connected, one event per Page when a sign-in brings several.
channel.disconnectedThe network refused the token, or the owner withdrew access.
channel.removedRemoved with DELETE /channels/{id} or from the dashboard, or the owner removed the app on Meta.
channel.suspendedYour subscription lapsed.

Bir bağlantı olayı neleri taşır?

Teslimatın id'sini (bir UUID), olay adını, ISO 8601 biçimindeki occurred_at değerini ve id, external_ref, connect_session_id, phone, name, waba_id, phone_number_id, status ve token_ready alanlarına sahip bir connection nesnesini taşır. Bazı olaylar üst düzeyde ek bir alan ekler: connection.disconnected ve connection.suspended üzerinde reason; olayı Meta'nın webhook'u yerine easyCoexistence'ın kendi periyodik kontrolü bulduğunda detected_by alanı health_check olarak ayarlanır; olayı bir bağlantı oturumu ürettiğinde ise connect_session_id.

connection.disconnected
{
  "id": "5c2a9e70-…",
  "event": "connection.disconnected",
  "occurred_at": "2026-10-31T10:15:02.114Z",
  "connection": {
    "id": "<CONNECTION_ID>",
    "external_ref": "customer_4821",
    "connect_session_id": "cs_…",
    "phone": "+55 11 9…",
    "name": "Clínica Sorriso",
    "waba_id": "<WABA_ID>",
    "phone_number_id": "<PHONE_NUMBER_ID>",
    "status": "disconnected",
    "token_ready": true
  },
  "reason": "PRIMARY_INACTIVITY"
}

Bir kanal olayı neleri taşır?

Bağlantı nesnesinin yerine channel nesnesi bulunan aynı yapıyı taşır. Bu nesne GET /channels/{id} görünümüdür: id, channel (ağ), external_ref, connect_session_id, name, username, external_id, status, token_ready, webhook_url, disconnected_reason, last_checked_at ve created_at. Kanallarda token_missing yoktur, çünkü sosyal girişler her zaman müşterinin kendi token'ını verir; bir bağlantı oturumundan gelen channel.connected olayı ise connect_session_id'yi üst düzeyde de taşır.

channel.disconnected
{
  "id": "0b7e41d2-…",
  "event": "channel.disconnected",
  "occurred_at": "2026-10-31T10:15:02.114Z",
  "channel": {
    "id": "<CHANNEL_ID>",
    "channel": "tiktok",
    "external_ref": "customer_4821",
    "connect_session_id": "cs_…",
    "name": "Clínica Sorriso",
    "username": "clinicasorriso",
    "external_id": "<TIKTOK_OPEN_ID>",
    "status": "disconnected",
    "token_ready": false,
    "webhook_url": "https://hooks.example.com/social",
    "disconnected_reason": "<THE_NETWORK'S_MESSAGE>",
    "last_checked_at": "2026-10-31T10:15:02.000Z",
    "created_at": "2026-10-28T16:40:09.000Z"
  }
}

Bağlantı kopma nedenleri ne anlama gelir?

connection.disconnected üzerindeki reason, Meta'nın account_update webhook'unun disconnection_info alanına koyduğu koddur; Meta bunu hem WhatsApp Business uygulamasındaki hem de Cloud API'deki numaralar için ekler. Meta neden vermediğinde değer null olur. Meta'nın referansındaki kodlar şunlardır:

  • PRIMARY_INACTIVITY: WhatsApp Business uygulamasını çalıştıran telefon yaklaşık 14 gün hareketsiz kaldı; bu 14 günlük kuralıdır. Yeni bir bağlantı oturumu numarayı yeniden bağlar.
  • ACCOUNT_DISCONNECTED: Hesabın bağlantısı Meta'nın yaptırımıyla veya müşteri tarafından kesildi; müşteri erişimi kaldırmış ya da hesabı silmiş olabilir.
  • COMPANION_INACTIVITY: Eşlik eden cihaz yaklaşık 30 gün hareketsiz kaldı.
  • BUSINESS_DOWNGRADE: Numara tüketici WhatsApp uygulamasıyla kaydedilmişti.
  • CHANGE_NUMBER ve USER_RE_REGISTERED: Müşteri numarayı değiştirdi ya da yeni bir cihazda numarayı yeniden kaydetti.

Bir durum olayı hangi başlıklarla gelir?

Her denemede beş başlık gelir: Content-Type application/json, User-Agent easyCoexistence-webhooks/1, olay adıyla X-EC-Event, gövdedeki id ile aynı olan X-EC-Delivery ve X-EC-Signature. İmza t=<unix>,v1=<hex> biçimindedir; burada v1, t'nin, bir noktanın ve ham gövdenin HMAC-SHA256 değeridir ve hesabınızın whsec_ ile başlayan imza sırrıyla anahtarlanır. Her deneme yeniden imzalanır; yani yeniden deneme aynı gövde üzerinde yeni bir t taşır.

Python: verify, then handle each id once
import hashlib, hmac, json, os, time

SECRET = os.environ["EC_EVENTS_SECRET"].encode()  # whsec_..., shown once in Profile > Developers

def verify(raw: bytes, header: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, v1 = parts.get("t", ""), parts.get("v1", "")
    if not t.isdigit() or abs(time.time() - int(t)) > 300:
        return False  # missing, or more than 5 minutes off
    mac = hmac.new(SECRET, t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, v1)

def handle(raw: bytes, headers) -> int:
    if not verify(raw, headers.get("X-EC-Signature", "")):
        return 401
    event = json.loads(raw)
    if already_processed(event["id"]):  # the X-EC-Delivery id, the same on every retry
        return 200
    enqueue(event)  # act on event["event"]; the latest occurred_at wins
    return 200

Başarısız teslimatlar nasıl yeniden denenir?

İlk deneme olay gerçekleştiği anda gönderilir. 2xx dışında bir yanıt, 10 saniye içinde yanıt verilmemesi, bir ağ hatası veya bir yönlendirme başarısızlık sayılır ve olay, 1 dakikadan 24 saate kadar artan aralıklarla yeniden denenir; bu, yaklaşık 33 saat boyunca toplam yedi denemedir. Bundan sonra olay bırakılır. Teslimatlar yalnızca genel bir IP adresine çözümlenen bir HTTPS adresine gönderilir. Uç nokta ayarlıyken gerçekleşen olay asla kuyruğa alınmaz; uç noktayı kaldırmak ise bekleyen her şeyi durdurur.

Neden her id'yi bir kez işleyip occurred_at değerini kontrol etmelisiniz?

Çünkü bir yeniden deneme teslimatı birebir aynı şekilde tekrarlar; gövdedeki ve X-EC-Delivery içindeki id aynı kalır ve yeniden denenen bir olay, daha yeni bir olaydan sonra ulaşabilir. İşlediğiniz id'leri saklayın ve tekrarları atlayın. Ardından occurred_at değerini, o bağlantı için kaydettiğiniz son durumla karşılaştırın; ya da eski olabilecek bir olaya göre işlem yapmadan önce GET /connections/{id} veya GET /channels/{id} uç noktasını okuyun.

Bir numara koptuğunda platform ne yapmalı?

Nedene göre hareket edin. PRIMARY_INACTIVITY'den sonra müşteriden WhatsApp Business uygulamasını açmasını isteyin ve aynı numara için yeni bir bağlantı oturumu gönderin. Numarayı aynı WhatsApp Business Hesabında yeniden bağlamak bağlantı kimliğini korur, webhook hedefinizi yeniden ayarlar ve connection.connected gönderir; bundan sonra kimlik bilgilerini yeniden okuyun. connection.token_missing ise Meta'nın bu çalışmada token vermediği anlamına gelir. Kopmanın ardındaki account_update webhook'unu Meta yalnızca uygulamanın kendi geri çağırma adresine gönderir, sizin URL'nize asla göndermez; dolayısıyla platformunuz bundan bu olay sayesinde haberdar olur.

Bir sosyal hesap koptuğunda platform ne yapmalı?

channel.disconnected olayında, aynı kanal kimliğiyle yeni bir bağlantı oturumu hesabı yeniden oturum açtırır. channel.removed, erişimin kalmadığı anlamına gelir: token unutulur ve varsa webhook hedefi temizlenir; bu yüzden müşteri yeniden bağlanırsa hedefi yeniden ayarlayın. Askıya alınan bir numara veya kanal, aboneliğiniz yeniden etkin olduğunda yeniden bağlanarak geri döner.

Yaygın hatalar

  • Yeniden denemeyi yeni bir olay gibi ele almak. Gövdedeki ve X-EC-Delivery içindeki id aynıdır; bu yüzden işlenen id'leri kaydedin, aksi halde tek bir kopma müşteriye iki kez uyarı gönderebilir.
  • Olayları gelme sırasına göre uygulamak. Yeniden denenen bir olay daha yeni bir olaydan sonra ulaşabilir; bu yüzden işlem yapmadan önce occurred_at değerini karşılaştırın veya bağlantıyı okuyun.
  • Yazım hatasını düzeltmek için olay URL'sini arka ucu güncellemeden yeniden kaydetmek. Kaydetmek yeni bir imza sırrı üretir ve uç noktanız bunu kullanana kadar her teslimat doğrulamada başarısız olur.
  • İşi yanıt vermeden önce yapmak. 10 saniyeden uzun süren bir işleyici başarısız sayılır ve olay geri gelir; bu yüzden önce 2xx yanıtı verin, işlemi sonra yapın.
Bunu EasyCoexistence'la yapmak

easyCoexistence, WhatsApp numaralarınızı ve sosyal hesaplarınızı kesintisiz izler; bir müşterinin numarası bağlandığında, koptuğunda, kaldırıldığında veya askıya alındığında platformunuza imzalı bir olay gönderir ve kopan numaralarda Meta'nın nedenini bildirir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında fiyatlandırılır ve bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.

Sık sorulan sorular

PRIMARY_INACTIVITY ne anlama gelir?

Bu, birincil cihazında WhatsApp Business uygulaması yaklaşık 14 gün kullanılmadığında Coexistence numarasının bağlantısının kesilmesinin Meta'nın nedenidir. Bu müşteri için yeni bir bağlantı oturumu numarayı yeniden bağlar.

Durum olayları mesajları içerir mi?

Hayır. Bunlar bir bağlantının durumunu kapsar. Bir numaranın mesajları Meta'dan kendi webhook hedefine iletilir; sosyal yorumlar ve DM'ler ise her kanalın hedefine iletilir.

Olay URL'sini nerede ayarlarım?

Panelde Profile, ardından Developers altında veya set_partner_events_url MCP aracıyla. İmza sırrı yalnızca bir kez gösterilir; URL'yi yeniden kaydetmek yenisini üretir.

Yalnızca numaraları işliyorsam kanal olaylarını yok sayabilir miyim?

Evet. channel.* olayları kendi adlarına sahiptir ve bağlantı yerine bir kanal nesnesi taşır; bu yüzden bir alıcı, adı connection ile başlamayan her olayı atlayabilir.

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