WhatsApp API erişimi nasıl alınır?

WhatsApp API erişimi almak için Meta’nın WhatsApp Business Platform’unda bir işletme hesabı oluşturmanız, bir uygulama tanımlamanız, WhatsApp Business hesabı ile telefon numarasını bağlamanız ve API erişim belirteci oluşturmanız gerekir. Kendi entegrasyonunuz için doğrudan Cloud API kullanılabilir; teknik operasyonu bir servis sağlayıcıya bırakmak isterseniz Meta ile çalışan bir Business Solution Provider üzerinden de ilerleyebilirsiniz.

Ön koşullar​

Başlamadan önce şu bilgileri hazırlayın:

• İşletmeyi temsil eden bir Meta işletme hesabı ve bu hesap üzerinde yönetici yetkisi.
• SMS veya sesli arama ile doğrulanabilen bir telefon numarası.
• API çağrılarını yapacak sunucu ve gelen bildirimleri alacak HTTPS webhook uç noktası.
• Mesaj şablonlarını, alıcı izinlerini ve müşteri iletişim sürecini yönetecek bir uygulama planı.

API, normal WhatsApp Web oturumu gibi çalışmaz. Mesaj gönderme ve alma işlemleri uygulamanızın kimlik bilgileri, telefon numarası kimliği, işletme hesabı ve webhook yapılandırması üzerinden yürür.

Cloud API ile erişim alma adımları​

1. Meta geliştirici hesabınızla bir uygulama oluşturun ve uygulamaya WhatsApp ürününü ekleyin. Uygulamanın amacı, işletmesi ve yöneticileri doğru tanımlanmalıdır.
2. Uygulamanın WhatsApp bölümündeki test yapılandırmasını açın. Test telefon numarası, telefon numarası kimliği ve test erişim belirteci burada gösterilir. Bu bilgilerle önce gerçek işletme numaranızı kullanmadan deneme yapın.
3. Test alıcısını yetkilendirin ve bir test mesajı gönderin. Alıcıya mesaj ulaşırsa belirteç, telefon numarası kimliği ve temel gönderim yetkisi doğru çalışıyor demektir.
4. Üretim için kendi WhatsApp Business hesabınızı ve telefon numaranızı bağlayın. Numara SMS veya sesli arama ile doğrulanır; daha önce WhatsApp uygulamasında kullanılan numarayı bağlarken numara türünü ve uygun taşıma ya da WhatsApp Business app Coexistence akışını kontrol edin. Mevcut hesabı silmek evrensel bir kurulum adımı değildir.
5. Uygulamaya üretim erişim belirteci verin. Geliştirme sırasında görünen geçici belirteci doğrudan üretim sunucusunda kullanmayın. Üretim belirtecinin süresi, kapsamı ve yenileme yöntemi kullanılan Meta hesap türüne göre kontrol edilmelidir.
6. Uygulamanın gerekli WhatsApp izinlerini ve bağlı işletme varlıklarını doğrulayın. Mesaj gönderme yetkisi ile işletme hesabını yönetme yetkisi aynı şey değildir; yalnızca ihtiyaç duyulan izinleri tanımlayın.
7. Webhook adresini yapılandırıp GET doğrulamasında verify_token değerini kontrol ederek challenge yanıtını döndürün. Gerekli messages alanına ve doğru WhatsApp hesabına aboneliği doğrulayın. Gelen POST olaylarında ham gövdenin X-Hub-Signature-256 imzasını App Secret ile doğrulayın; kurulum belirteci bu imza kontrolünün yerine geçmez.
8. Üretime geçmeden önce kendi numaranızla mesaj gönderme, cevap alma, teslim edilememe ve opt-out senaryolarını test edin. Test başarılıysa uygulamanızdaki gerçek müşteri akışını etkinleştirin.

Başarılı bir ilk test, yalnızca API çağrısının kabul edildiğini gösterir. Mesajın karşı tarafa teslim edilmesi, alıcının iletişim izni, numaranın durumu, şablonun onayı ve hesabın kalite durumu gibi başka koşullara da bağlıdır. Bu nedenle gönderim yanıtını başarı olarak işaretlemek yerine webhook üzerinden teslim ve hata durumlarını da kaydedin.

Hangi erişim yolunu seçmelisiniz?​

İki yaklaşımın operasyon farkı şöyledir:


Doğrudan API, daha fazla teknik kontrol sağlar. Servis sağlayıcı ise hazır gelen kutusu, kampanya veya müşteri destek araçları sunabilir; ancak sağlayıcının hesabına bağımlılık ve ek operasyon koşulları oluşabilir. Kararı, yalnızca ilk kurulum kolaylığına göre değil, numara ve işletme hesabının kimin mülkiyetinde kalacağına göre verin.

Sık yapılan hatalar​

• Test belirtecini üretimde kullanmak: Süresi dolabilir veya yanlış yetki kapsamına sahip olabilir.
• Webhook kurmadan mesaj gönderme: Gelen cevapları ve teslim durumlarını göremezsiniz.
• Uygulamada kullanılan numarayı doğrudan bağlamaya çalışmak: Numaranın mevcut WhatsApp hesabıyla ilişkisi önce kontrol edilmelidir.
• Her mesajı serbest metin sanmak: Kullanıcı etkileşimi ve şablon gerektiren senaryoları ayrı tasarlayın.
• Yalnızca API yanıt koduna güvenmek: Asıl sonucu teslim webhook’u, hata kodu ve mesaj durumuyla değerlendirin.

Deneme akışında tek bir varsayımsal sipariş bildirimi için gönderim kimliğiyle teslim olayını ilişkilendirin. Geçersiz numara ve yinelenen webhook olaylarının nasıl ele alındığını kontrol edin. Mesajlaşmanın ve sağlayıcı hizmetinin güncel ücret koşullarını üretimden önce inceleyin; teknik erişim alınması bütün kullanımın ücretsiz olduğu anlamına gelmez.

Sık sorulan sorular​

WhatsApp Business uygulamasını aynı numarayla kullanmaya devam edebilir miyim?​

Uygun işletmeler için Embedded Signup üzerinden Coexistence akışı bulunur; bu, tüketici WhatsApp hesabına otomatik olarak uygulanmaz. Uygunluk ve özellik kısıtlarını inceleyin. Hesabı silmeden veya numarayı taşımadan önce hangi akışın desteklendiğini doğrulayın.

Webhook doğrulandı ama mesaj olayları neden gelmiyor?​

Challenge testinin geçmesi aboneliklerin tamamlandığını kanıtlamaz. messages alanını, uygulamanın doğru WhatsApp hesabına aboneliğini, numara kimliğini ve sunucu yanıtlarını inceleyin. POST imza kontrolü ile GET kurulum doğrulamasını ayrı test edin; yeniden gelen aynı olayı iki kez işlemeyecek kayıt düzeni kurun.