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.
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.
Ekip telefondan yanıt verir. Hiçbir şey otomatikleştirilemez, entegre edilemez ya da ölçülemez.
API yokYazılım numaraya erişebilir. Business uygulaması o numarada çalışmayı bırakır ve ekip araç değiştirir.
Uygulama yokMeta, 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.
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.
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.
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.
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ırOnların platformuMesajları alır ve saklarSizBir kopya, onların takvimine göreEasyCoexistenceYalnızca yapılandırmaUç noktanızHenüz doğrulanmadıBizRotayı biz ayarlarız, üzerinde biz yokuzMeta'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.
İkinci taraf ortaya çıkar. Birincisi kaldırılmaz. Taşıma sonrasıTek tarafYalnızca Cloud APIBusiness uygulaması bu numarada artık çalışmazCoexistence sonrasıİki tarafWhatsApp Business uygulamasıAynı sohbetler ve aynı geçmişCloud APIAynı hattaMesaj 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.
Geçersiz kılma etkinleştiğinde hangi olayların nereye gittiği. Operasyonel olaylarBize iletilirMesaj yoluSize iletilirmessagesBir müşterinin gönderdiği her şeysmb_message_echoesEkibin uygulamadan gönderdikleriSunucunuzDoğrudan, asla bizim üzerimizden değilBağ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ı.
Yeniden bağlanmanın kendiliğinden geri getirdikleri ve geri konması gerekenler. Meta geri getirirOtomatikGönderimCloud API yeniden çalışırOperasyonel olaylarİzleme devam ederUygulamayla birlikte giderYeniden uygulanması gerekirWebhook geçersiz kılmanızUygulamayla birlikte kaldırıldıSize mesaj iletimiSessizce dururYeniden 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.
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.
messagesBir müşterinin numaraya gönderdiği her şeysmb_message_echoesEkibinizin WhatsApp Business uygulamasından gönderdikleri
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şiklikleriaccount_alertsMeta'nın hesap için verdiği uyarılaraccount_review_updateMeta incelemesinin sonuçlarıbusiness_capability_updateMesaj limiti ve yetenek değişiklikleriphone_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.
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.
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.
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ı.
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.
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.
WhatsApp Business uygulamasından kod taranarak bir numaranın bağlanması için gereken tipik süre.
Müşteri yanıtının serbest metin yanıtlarına açık oturumu ne kadar süre tuttuğu.
Meta tarafından belirlenen ve artırılamayan Coexistence numarasının gönderim kapasitesi.
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.