WhatsApp Business API (Cloud API) kurulumu: adım adım

Önce bilin: hangi adım kimin işi?

Kurulumun bir kısmı yalnız firmanın kendisi tarafından yapılabilir; çünkü hesap, işletme doğrulaması ve numara sahipliği hukuken firmaya aittir. Teknik bağlantı ise otomatikleştirilebilir.

• Firmanın işi: Meta Business hesabı, işletme doğrulaması (vergi ve şirket belgeleri), numara sahipliği, görünen adın onaya gönderilmesi, ödeme yöntemi.
• Otomatikleşebilen iş: uygulama bağlantısı, webhook, şablon taslakları, hattın taşıma ya da depo sistemine bağlanması, doğrulama testleri.
• Kural: kurulum için parola paylaşılmaz; kurulumu yapan, firmanın Meta Business hesabına iş ortağı olarak eklenir ve iş bitince erişim kaldırılır.

Adım 1: Meta Business hesabı ve işletme doğrulaması

Firma adına bir Meta Business hesabı açılır ve işletme doğrulamasına gönderilir. Doğrulama birkaç gün sürebilir; bu sürede diğer hazırlıklar yapılır. Şirket unvanı, adres ve web sitesindeki bilgiler resmi belgelerle aynı olmalıdır; farklılık en sık red sebebidir.

Adım 2: Numara ve görünen ad

API için genelde ayrı bir numara kullanılır: klasik kurulumda numara aynı anda telefondaki WhatsApp uygulamasında kayıtlı olamaz. Bazı ülkelerde Business uygulamasıyla aynı numarada sınırlı birlikte kullanım (coexistence) da sunuluyor; güncel durumu kurulumda doğrulayın. Görünen ad (müşterinin sohbet başlığında gördüğü ad) Meta onayından geçer ve markanın adıyla tutarlı olmalıdır. Birden çok hat (örneğin satış ve operasyon) ayrı ayrı eklenir ve her biri ayrı onaylanır.

Adım 3: Uygulama, erişim anahtarı ve webhook

Teknik bağlantı bir Meta geliştirici uygulaması üzerinden kurulur. Kalıcı bir sistem kullanıcısı anahtarı üretilir ve yalnız gereken izinlerle sınırlandırılır. Gelen mesajlar webhook ile sisteme düşer; webhook imzası her istekte doğrulanmalıdır. Anahtar firmanın sunucusunda ya da sır kasasında durur, e-postayla ya da sohbetle paylaşılmaz.

Adım 4: Şablonlar ve 24 saat kuralı

Müşterinin son mesajıyla 24 saatlik bir pencere açılır; bu pencere boyunca serbest mesaj gönderebilirsiniz. Bu pencere kapandıktan sonra yalnız Meta’nın onayladığı şablon mesajlar gider. Şablonlar kategoriye göre onaylanır: pazarlama (marketing), hizmet/işlem (utility) ve kimlik doğrulama (authentication). Sefer bilgisi, randevu ve belge hatırlatmaları hizmet/işlem şablonlarına girer; pazarlama dili içeren bir şablonu Meta pazarlama kategorisine kaydırabilir.

Adım 5: Doğrulama (kuruldu değil, doğrulandı)

Kurulum, gerçek bir uçtan uca denemeyle biter. Önerilen kontroller:

• Test numarasından gelen mesaj sisteme düşüyor mu, doğru kayda bağlanıyor mu?
• Karşılama ya da otomatik cevap gidiyor mu, ofise bildirim düşüyor mu?
• Webhook imzası doğrulanıyor mu, sahte istek reddediliyor mu?
• Müşteri “DUR” ya da “STOP” yazınca mesaj gönderimi duruyor mu?
• Deneme kaydı sonra kontrollü biçimde siliniyor mu?

WhatsApp ile neler yapılamaz?

Satış görüşmesinden önce sınırları bilmek, sonradan hayal kırıklığını önler. Kasım 2026 itibarıyla gözlenen sınırlar:

• İşletme, WhatsApp üzerinden yalnız WhatsApp kullanan ve bu hattan aranmaya izin vermiş kişiyi arayabilir; normal telefon hattı WhatsApp üzerinden aranamaz. Gözlemimize göre işletme numarası bir grup aramasına da eklenemiyor; konferans ya da tercümanlı arama için ayrı bir telefon (şebeke) sağlayıcısı gerekebilir. Afillo’da bu yol hazırlanıyor. Arama özelliği her ülkede açık olmayabilir.
• 24 saat penceresi dışında serbest metin gönderilemez; yalnız onaylı şablon gider.
• Görünen ad ve şablonlar Meta onayına bağlıdır; onay süresi garanti edilemez.
• Meta kuralları sık değişir; bu sayfadaki bilgiler sayfanın tarihindeki duruma göredir.

Gizlilik ve saklama

WhatsApp mesajları Meta’nın altyapısından geçer ve Türkiye ya da Avrupa Birliği dışına aktarılabilir; bu, aydınlatma metninde açıkça yazılmalıdır. Müşterinin size yazması, o talebe cevap vermek için yeterli olabilir; işletmenin başlattığı mesajlar ve özellikle pazarlama için ayrıca açık izin gerekir. Sözleşmeye dönmeyen yazışmalar için kısa bir saklama süresi (örneğin 1 yıl) belirlemek iyi uygulamadır. Bu sayfa hukuki görüş değildir; kendi durumunuz için hukuk danışmanınıza başvurun.