WhatsApp Cloud API Nedir? Resmi Meta Altyapısını Anlamak

Cloud API nasıl çalışır?

Bir işletme hesabı ve numara bağlantısı yetkilendirildikten sonra uygun API çağrılarıyla mesaj gönderilir. Gelen mesaj ve durum değişiklikleri webhook olayları üzerinden sisteme iletilir.

Webhook’ların imza kontrolü, hata yönetimi ve kuyrukla işlenmesi operasyonun dayanıklılığı için önemlidir. Ağ kesintilerinde tek bir isteğe bağımlı tasarım yerine kayıt ve yeniden deneme mekanizmaları değerlidir.

Access token neden önemlidir?

Token, belirli izinler kapsamındaki API çağrılarını yetkilendirir. Bu nedenle tarayıcıya veya herkese açık bir dosyaya konulmamalı; güvenli sunucu tarafında saklanmalıdır.

Webhook bir gelen kutusu mudur?

Hayır. Webhook olayların sunucuya iletilmesidir. Gelen kutusu; mesaj kaydı, müşteri kimliği, ekip ataması ve arayüzün birlikte oluşturduğu çalışma alanıdır.

Mesaj penceresi ve şablonlar

Müşterinin başlattığı görüşmedeki serbest yanıtlar ile işletmenin daha sonra başlattığı mesajlar aynı kurallarla değerlendirilmez. Pencere dışındaki uygun iletişimlerde Meta onaylı template kullanılabilir.

İzin, kategori ve şablon durumunu canlı platformdan kontrol etmek gerekir; teknik entegrasyon Meta kurallarını ortadan kaldırmaz.

Büyük ekiplerde operasyon

Bir numaraya çok sayıda mesaj geldiğinde temsilci ataması, yanıt bekleyenler listesi, okunmamış görüşmeler ve müşteri geçmişi ön plana çıkar.

Yönetici raporlarında ilk yanıt ve çözüm süresi gibi ölçümler, iletişim kalitesini değerlendirmeye yardımcı olur; tek başına API bunları otomatik olarak anlamlandırmaz.

Webhook olaylarını iş akışına dönüştürmek

Bir webhook isteği sunucuya ulaştığında sistemin yalnızca ekrana yeni bir satır çizmesi yeterli değildir. Olayın daha önce işlenip işlenmediği, hangi işletmeye ait olduğu ve hangi konuşmayla ilişkili olduğu kontrol edilmelidir. Aynı olayın tekrarlanabildiği sistemlerde yinelenen kayıt üretmemek önemlidir.

Dayanıklı kuyruk ve hata kaydı, anlık sunucu kesintilerinde mesajların görünmeden kaybolması riskini azaltmayı hedefler. Ancak bunun için kuyruk işçilerinin çalışması, logların izlenmesi ve başarısız işlerin tekrar ele alınması gerekir.

Kimlik ve token yönetimini unutmayın

Access token bir şifre gibi korunmalıdır. Tokenın kaynak kodun içine veya herkese açık bir JavaScript dosyasına yazılması, yalnız entegrasyonu değil işletme hesabındaki yetkileri de riske sokabilir. Yetkilerin kapsamını minimumda tutup erişimi izlemek doğru yaklaşımdır.

Webhook adresinin internete açık olması normaldir; fakat gelen isteğin gerçekten beklenen kaynaktan geldiği imza gibi mekanizmalarla denetlenmelidir. Ürün geliştirirken güvenlik kontrolünü yalnız yönetici giriş ekranıyla sınırlamayın.

Canlıya alma ve arıza yönetimi

İlk başarılı mesajdan sonra dosya gönderimi, şablon akışı, yeniden deneme ve numara bağlantısının geçici olarak bozulması gibi durumları test edin. Yetkisiz istek, süresi dolmuş token ve geçici servis hatasının kullanıcıya aynı metinle gösterilmesi sorunu çözmeyi zorlaştırır.

Yönetim ekibi için kabul kriteri oluşturun: gelen mesajın kaydı, doğru atama, giden yanıtın teslim durumunun güncellenmesi ve hata yaşandığında sorumlunun uyarılması. Teknik entegrasyonun iş sürekliliği böylece daha görünür hale gelir.

Coexistence ile karıştırmayın

Coexistence, WhatsApp Business uygulamasını kullanmaya devam etme ihtiyacının ayrı bir bağlantı senaryosudur. Cloud API ise mesajlaşma API katmanını ifade eder; bunlar birebir rakip teknik terimler değildir.

Uygun bağlantı yöntemi mevcut numaranın durumu ve ihtiyaçlarla belirlenmelidir.

Uygulamada izlenecek adımlar

1. Meta işletme hesabınızı ve bağlanacak numarayı belirleyin.
2. Gerekli izin ve bağlantı akışını tamamlayın.
3. Gelen webhook mesajını ve giden API iletisini gerçek numara üzerinden deneyin.
4. Temsilci yetkisi, şablon ve hata bildirimlerini operasyon açısından kontrol edin.