Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

Tek numara.Uygulama ve API, aynı anda.

Coexistence, WhatsApp Business uygulaması ile Cloud API'yi tek bir numarada aynı anda çalıştırmaya yarayan Meta'nın resmi modudur. Ekip aynı sohbetler ve aynı geçmişle telefondan yanıt vermeyi sürdürürken yazılım aynı hat üzerinden mesaj gönderip alır.

EasyCoexistence numarayı bağlar ve bağlantıyı izler.

Ücretsiz Denemeyi Başlatın3 gün ücretsiz. Deneme bitene kadar hiçbir ücret alınmaz.
+1 415 555 0188
WhatsApp Business uygulamasıEkip eskisi gibi telefondan yanıt verir
Cloud APISistemleriniz ya da bir yapay zekâ asistanı, aynı hatta
İki taraf da aynı konuşmayı görür. API'nin gönderdiği mesajlar uygulamada görünür, ekibin uygulamada yazdıkları da smb_message_echoes olayı olarak gelir. Böylece yazılım, zaten yanıt vermiş bir insanın üzerine asla yanıt vermez.
Varsayılan olarak mesaj saklama yokBusiness App + Cloud APIClaude ve ChatGPT için MCP2 dakikada hazır

Eskiden yapılması gereken, artık gerekmeyen seçim

Coexistence yeni bir API değildir. Neredeyse her küçük işletmenin hiçbir şeyi otomatikleştirememesine yol açan bir yol ayrımının ortadan kalkmasıdır.

ÖnceTek numara, tek seçim
Uygulamada kalmak

Ekip telefondan yanıt verir. Hiçbir şey otomatikleştirilemez, entegre edilemez ya da ölçülemez.

API yok
API'ye geçmek

Yazılım numaraya erişebilir. Business uygulaması o numarada çalışmayı bırakır ve ekip araç değiştirir.

Uygulama yok
ŞimdiTek numara, ikisi birden
Tek numara
WhatsApp Business uygulamasıCloud API

Meta, Cloud API'yi WhatsApp Business uygulamasının hâlâ kullandığı bir numaraya bağlar. İki taraf da aynı hatta etkin olur ve her biri diğerinin gönderdiğini görür.

Bir numarayı bu şekilde kimler kullanır

Aynı özellikten birbirinin tersini isteyen iki grup. Bu yüzden bağlantı, üzerine kurulan her panelden daha önemlidir.

Telefon kalırTek numarası olan bir işletme

Küçük bir ekip, bir kamyonetin ya da vitrinin üzerinde yazan bir numara ve aynı dört soruyu yanıtlayarak geçen akşamlar. Kimsenin yerini almıyorlar. Onaylar, hatırlatmalar ve mesai sonrası ilk yanıtın bir insan olmadan gitmesini, telefonun da geri kalan her şey için çalışmaya devam etmesini istiyorlar.

Çok numara, tek hesapBir ajans, danışmanlık firması ya da geliştirici

Her birinin kimsenin taşıyamayacağı veya dokunamayacağı bir numarası olan çok sayıda müşteri. Bu numaraların kurdukları sistemlerden erişilebilir olması ve bir sonrakini satış görüşmesi yapmadan ekleyebilmeleri gerekir. Coexistence, müşterinin çalışanlarının hâlâ elle yanıtladığı bir numaraya ulaşmanın tek resmi yoludur.

Bir numara nasıl iki tarafa birden ulaşır ve mesaj olayları nereye gider

Dört adım. Telefona dokunan tek adım bir tarama, mimarinizi belirleyen adım ise ilki.

  1. Kurulum başlamadan önce uç noktanızı hazır edin

    Meta, bir hedefe teslimat yapmadan önce onu doğrular. URL'nize hub.mode=subscribe, sizin hub.verify_token değeriniz ve bir hub.challenge içeren bir GET isteği gönderir, uç noktanızın da challenge değerini olduğu gibi geri döndürmesi gerekir.

    Hedef HTTPS olmalıdır ve doğrulama token'ı zorunludur. İkisini de çağrı yapılmadan önce kontrol ederiz. Böylece hatalı bir URL, bağlıymış gibi görünüp hiçbir şey iletmemek yerine daha bizim kapımızda başarısız olur.

    Gerekenler
    Meta'nın GET isteğine hub.challenge değerini geri döndüren bir HTTPS uç noktası
    Süre
    Yaklaşık bir dakika
    Elde ettiğiniz
    Numara bağlandığı anda Meta'nın doğrulayabileceği bir hedef
    Henüz hiçbir şey bağlı değil. Mesajların nereye ulaşacağını bu belirler.
    Arada bir sağlayıcıOnların sunucularında saklanır
    Meta
    Onların platformuMesajları alır ve saklar
    SizBir kopya, onların takvimine göre
    EasyCoexistenceYalnızca yapılandırma
    Meta
    Uç noktanızHenüz doğrulanmadı
    BizRotayı biz ayarlarız, üzerinde biz yokuz
  2. Meta'nın Embedded Signup akışını çalıştırın ve uygulamada tarayın

    Meta'nın kendi açılır penceresi açılır. Business Portfolio'yu, WhatsApp Business Hesabını ve WhatsApp Business uygulamasında zaten kayıtlı olan numarayı seçersiniz, ardından bir kodu tarayarak bağlantıyı telefondan onaylarsınız.

    Mevcut sohbet geçmişini paylaşıp paylaşmayacağınızı da burada seçersiniz. Bu, kurulum sırasında bir kez verilen bir karardır ve sonradan değiştirilemez. Business uygulaması, tarama tamamlandığı anda da çalışmaya devam eder.

    Gerekenler
    Business Portfolio erişimi ve numaranın bulunduğu telefon
    Süre
    İki ila üç dakika
    Elde ettiğiniz
    Uygulamanın hâlâ kullandığı bir numaraya bağlanmış Cloud API
    İkinci taraf ortaya çıkar. Birincisi kaldırılmaz.
    Taşıma sonrasıTek taraf
    Numara
    Yalnızca Cloud APIBusiness uygulaması bu numarada artık çalışmaz
    Coexistence sonrasıİki taraf
    Numara
    WhatsApp Business uygulamasıAynı sohbetler ve aynı geçmiş
    Cloud APIAynı hatta
  3. Mesaj olaylarını kendi sisteminize yönlendirin

    Meta, bir uygulamanın belirli bir WhatsApp Business Hesabının webhook'larının nereye iletileceğini geçersiz kılmasına izin verir. Bu geçersiz kılmayı sizin URL'nize ayarlarız. Böylece mesaj yolundaki iki alan, messages ve smb_message_echoes, doğrudan Meta'dan size gider.

    Operasyonel alanları kendimizde tutarız, çünkü izleme bunlardan oluşur: account_update, phone_number_quality_update, account_alerts, account_review_update, business_capability_update ve phone_number_name_update. Böylece panel işe yarar kalır, konuşma içeriği ise asla bize uğramaz.

    Gerekenler
    Birinci adımdaki uç nokta, artık Meta tarafından doğrulanmış olarak
    Süre
    Kurulum tamamlanır tamamlanmaz uygulanır
    Elde ettiğiniz
    Meta'dan doğrudan size iletilen mesajlar, biz mesaj yolunun dışındayız
    Geçersiz kılma etkinleştiğinde hangi olayların nereye gittiği.
    Operasyonel olaylarBize iletilir
    account_updateBağlantı durumu değişiklikleri
    phone_number_quality_updateKalite ve aktarım hızı
    account_review_updateİnceleme sonuçları
    Mesaj yoluSize iletilir
    messagesBir müşterinin gönderdiği her şey
    smb_message_echoesEkibin uygulamadan gönderdikleri
    SunucunuzDoğrudan, asla bizim üzerimizden değil
  4. Bağlantıyı canlı tutun ve yeniden bağlanmayı sorunsuz atlatın

    Meta, birincil cihazda yaklaşık on dört gün etkinlik olmazsa bir Coexistence numarasının bağlantısını keser. Bu bağlantı yeniden kurulabilir ve biz bunu ayrılan bir müşteri gibi değerlendirmek yerine kendi durumu olarak kaydederiz.

    İnsanları asıl hazırlıksız yakalayan, bağlantı kesilmesinin rotaya yaptığıdır. Meta hedefi, uygulamamızın hesap aboneliği üzerinde bir geçersiz kılma olarak saklar. Bu yüzden PARTNER_REMOVED olayı uygulamayı kaldırır ve geçersiz kılmayı da beraberinde götürür. Yeniden bağlanmak gönderimi ve izlemeyi geri getirir, ama hedefinizi getirmez. Biz onu otomatik olarak geri koyarız, çünkü bu kurala takılan ilk numara sorunsuzca yeniden bağlandı ve müşterinin sunucusuna iletimi sessizce bıraktı.

    Gerekenler
    Uygulamanın birincil cihazda ara sıra açılması
    Süre
    Sürekli
    Elde ettiğiniz
    İzlenen bir bağlantı ve yeniden bağlanmayı atlatan bir rota
    Yeniden bağlanmanın kendiliğinden geri getirdikleri ve geri konması gerekenler.
    Meta geri getirirOtomatik
    GönderimCloud API yeniden çalışır
    Operasyonel olaylarİzleme devam eder
    Uygulamayla birlikte giderYeniden uygulanması gerekir
    Webhook geçersiz kılmanızUygulamayla birlikte kaldırıldı
    Size mesaj iletimiSessizce durur
    Yeniden uygularızHer yeniden bağlantıda

Ekipler bir numarayı neden bu şekilde kullanır

  • Kamyonetlerde, fişlerde ve web sitesinde zaten yazılı olan numarayı ve etrafındaki mobil iş akışını korumak.
  • Kimseyi yeni bir araca taşımadan API ile gönderim, webhook işleme ve şablonlar eklemek.
  • Mesaj trafiğini bir sağlayıcının ortak gelen kutusunun dışında tutmak, böylece konuşmalar başka birinin platformunda durmaz.
  • Bir ajansa, her biri müşterinin kendi Business Portfolio'sunda bağlı olan çok sayıda müşteri numarasını tek hesapta tutma imkânı vermek.

Uygunluk ve pratik sınırlar

  • Numaranın WhatsApp Business uygulamasında zaten etkin olması gerekir. Bireysel WhatsApp uygulamasındaki bir numara önce oraya taşınmalıdır.
  • Mevcut sohbet geçmişini paylaşmak, kurulum sırasında bir kez verilen bir karardır ve sonradan değiştirilemez.
  • Grup sohbetleri, Coexistence numaralarında her sağlayıcıda API'nin dışında kalır.
  • Birincil cihazın düzenli etkinliğe ihtiyacı vardır. Meta, etkinlik olmadan yaklaşık on dört gün sonra bağlantıyı keser.
  • Meta doğrulama ve rozet süreçleri Coexistence numaraları için farklıdır ve bölgesel kullanılabilirlik Meta politikasıyla değişir.
Serbest metinson mesajlarından sonraki 0 ila 24 saatYalnızca şablonsonrasında, yeniden yazana kadar
Müşteri her bir şey gönderdiğinde süre yeniden başlar. Canlı ortamda entegrasyonları bozan kural budur, çünkü test her zaman bir mesajdan saniyeler sonra, serbest metin hâlâ çalışırken yapılır.

Size neyi yönlendiriyoruz, neyi kendimizde tutuyoruz

Meta, bir uygulamanın WhatsApp Business Hesabının webhook'larını nereye ileteceğini geçersiz kılmasına izin verir. Bu geçersiz kılmayı sizin URL'nize ayarlarız ve olaylar ikiye ayrılır.

Doğrudan uç noktanıza iletilirMesaj yolu. Varsayılan olarak asla bizim üzerimizden geçmez.
  • messagesBir müşterinin numaraya gönderdiği her şey
  • smb_message_echoesEkibinizin WhatsApp Business uygulamasından gönderdikleri
Bize iletilirOperasyonel yol. İzleme bundan oluşur.
  • account_updateBağlantı durumu: kaldırıldı, ayrıldı, yeniden bağlandı, kısıtlandı
  • phone_number_quality_updateKalite puanı ve aktarım hızı değişiklikleri
  • account_alertsMeta'nın hesap için verdiği uyarılar
  • account_review_updateMeta incelemesinin sonuçları
  • business_capability_updateMesaj limiti ve yetenek değişiklikleri
  • phone_number_name_updateGörünen ad onayları ve retleri

Bir numara için geçersiz kılma ayarlanmamışsa, mesaj olayları varsayılan geri çağırma adresimize düşer ve işleyici bunları kaydetmeden atar. Bu bir politikada vaat edilmez, kodla uygulanır: konuşma içeriğinin izleyebileceği bir depolama yolu yoktur.

On dört gün kuralı ve kimsenin bahsetmediği, bozduğu şey

Meta, birincil cihazda yaklaşık on dört gün etkinlik olmazsa Coexistence bağlantısını keser. Bağlantı yeniden kurulabilir, bu yüzden bunu ayrılan bir müşteri olarak saymak yerine kendi durumu olarak saklarız.

Asıl maliyetli sonuç daha sonra ortaya çıkar. Mesajlarınızın hedefi numaranın bir ayarı değildir, uygulamamızın WhatsApp Business Hesabı aboneliği üzerindeki bir geçersiz kılmadır. Bağlantının kesilmesi uygulamayı kaldırır ve geçersiz kılma da onunla birlikte gider. Yeniden bağlarsınız, gönderim çalışır, izleme çalışır ve mesajlar sunucunuza ulaşmayı bırakır, hiçbir yer de hata bildirmez.

Geçersiz kılmayı her yeniden bağlantıda tekrar uygularız. Bu davranış, bu durum yaşandığı için var: bir numara bu kurala takıldı, sorunsuzca yeniden bağlandı ve sessizce mesaj iletmeyi bıraktı.

O anda sunucunuz kapalı olduğu ya da token değiştiği için el sıkışma başarısız olursa, bu bağlantı zaman çizelgesine kaydedilir ve hedef atılmak yerine korunur. Yani yeniden kaydetmek sorunu çözmeye yeter.

Sessizce ne bozulur ve bunu nasıl fark ederiz

WhatsApp Business uygulaması aşağıdaki arızaların neredeyse hepsinde çalışmaya devam eder, bu yüzden kimse fark etmez. Kontrol ettiklerimiz ve nasıl kontrol ettiğimiz şunlardır.

Numaranın bağlantısı kesildiWebhook, kesin kaynak

Bir alanın false olmasından çıkarılmaz, Meta'nın account_update webhook'undan, özellikle PARTNER_REMOVED olayından tespit edilir. Bunun için bilerek is_on_biz_app alanını okumuyoruz, çünkü Coexistence olmayan numaralarda bu alan haklı olarak false olur ve yanlış bağlantı kesintilerine yol açıyordu.

Bağlantı on dört gün boyunca sessiz kaldıKendi durumu

Meta'nın birincil cihaz etkinsizlik kuralı. Bağlantı yeniden kurulabilir, bu yüzden ayrılan bir müşteri olarak değil kendi durumu olarak kaydedilir ve yeniden bağlanmak gönderimi ve izlemeyi geri getirir.

Webhook rotanız yeniden bağlantıda kaybolduOtomatik yeniden uygulanır

Hedef, uygulamamızın hesap aboneliği üzerinde bir geçersiz kılma olarak tutulur, bu yüzden bağlantının kesilmesi onu kaldırır. Yeniden bağlanınca gönderim geri gelir, sunucunuza iletim gelmez. Geçersiz kılmayı her seferinde tekrar uygularız, çünkü bunun yaşandığı bir numara sorunsuzca yeniden bağlandı ve sessizce mesaj iletmeyi bıraktı.

Erişim token'ı çalışmayı bıraktıİki token, tek yanıt

Aynı hesap için müşterinin token'ını ve kendi System User token'ımızı tutarız. Biri reddedildiğinde diğeri hesabı okur ve ikisinden hangisinin gerçekten bozulduğunu belirler. Böylece iptal edilmiş bir token artık kaybolmuş bir numara gibi görünmez.

Kalite düştüSorgulanır

Meta'dan düzenli aralıklarla sorgulanır. RED puanı bağlantıyı bozulmuş olarak işaretler ve kalite, mesajlaşma katmanı ve aktarım hızı seviyesi her kontrolde kaydedilir. Böylece bir düşüş, bir gönderime mal olmadan önce görünür.

Bir numarayı bağlamak ile bir numarayı izlemek farklı ürünlerdir. Bu ürünün var olma nedeni ikincisidir.

2 minutes

WhatsApp Business uygulamasından kod taranarak bir numaranın bağlanması için gereken tipik süre.

24 hours

Müşteri yanıtının serbest metin yanıtlarına açık oturumu ne kadar süre tuttuğu.

20 msg/s

Meta tarafından belirlenen ve artırılamayan Coexistence numarasının gönderim kapasitesi.

6 months

Bir numara ilk bağlandığında Meta'nın API'ye eşitlediği sohbet geçmişi miktarı.

Sık sorulan sorular

Ekibim telefonu kullanmayı bırakmak zorunda mı?

Hayır. Coexistence'ın amacı tam olarak budur. WhatsApp Business uygulaması aynı numarada, aynı konuşmalarla çalışmayı sürdürür ve API yanında çalışır.

Mevcut konuşmalarımı kaybeder miyim?

Hayır. Konuşmalar uygulamada kalır ve numara bağlandığında Meta yaklaşık altı aylık geçmişi API'ye eşitler; böylece yazılım boş bir başlangıç yerine bağlama sahip olur.

Bunu geri alabilir miyim?

Evet. Bir numaranın bağlantısı kesilebilir ve uygulama her zamanki gibi çalışmayı sürdürür. Bağlantı kurmak numaranın kendisinde kalıcı bir değişiklik oluşturmaz.

Bu, resmi olmayan WhatsApp API'leriyle aynı mı?

Hayır ve fark, numaranın kullanıma devam edip edemeyeceğini belirler. Coexistence, Cloud API üzerindeki Meta'nın resmi özelliğidir. Resmi olmayan ağ geçitleri WhatsApp Web'i bağlı cihaz olarak çalıştırır; bu da koşulları ihlal eder ve numaraların yasaklanmasına yol açar.

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz Denemeyi Başlatın3 gün ücretsiz. Deneme bitene kadar hiçbir ücret alınmaz.

Okumaya devam edin