WhatsApp API Entegrasyonu — Geliştirici Rehberi

WhatsApp Business API, büyük işletmelerin ve geliştiricilerin WhatsApp üzerinden otomatik mesajlaşma, chatbot ve CRM entegrasyonu kurmasını sağlar. Standart WhatsApp Business uygulamasından farklı olarak API, programatik erişim ve ölçeklenebilir çözümler sunar. Bu rehberde WhatsApp Business API ile Cloud API farkları, başvuru süreci, webhook, mesaj şablonları, otomasyon, chatbot entegrasyonu, üçüncü parti çözümler ve maliyet karşılaştırmasını ele alacağız.

API kullanımı teknik bilgi gerektirir; ancak üçüncü parti sağlayıcılar (Twilio, MessageBird, 360dialog vb.) ile kod yazmadan da entegrasyon kurabilirsiniz. WhatsApp Link Oluşturucu ile oluşturduğunuz wa.me linkleri API entegrasyonunda da geçerlidir; müşteriler aynı linke tıklayarak size ulaşır. WhatsApp Business avantajları rehberimizde temel özellikleri inceleyebilirsiniz.

WhatsApp Business API vs Cloud API

İki ana API türü vardır: On-Premise (kendi sunucunuzda) API ve Cloud API. On-Premise API, Meta tarafından artık yeni başvurulara kapalıdır; mevcut kullanıcılar geçiş yapmaya teşvik edilmektedir. Cloud API, Meta'nın önerdiği ve daha kolay kurulum sunan güncel çözümdür. Cloud API'de sunucu altyapısı Meta tarafından yönetilir; siz yalnızca webhook ve mesaj gönderme mantığınızı geliştirirsiniz. Başvuru süreci Meta Business Suite veya BSP (Business Solution Provider) üzerinden yapılır.

Başvuru Süreci

API kullanmak için Meta Business hesabı oluşturmanız ve WhatsApp Business hesabı bağlamanız gerekir. İşletme doğrulaması gerekebilir; bu süreç birkaç gün ile birkaç hafta sürebilir. Telefon numarası doğrulaması yapılır; mevcut WhatsApp numaranızı API'ye taşıyabilir veya yeni numara alabilirsiniz. Numara taşıma işlemi sırasında mevcut sohbet geçmişi korunmayabilir; bu nedenle önemli konuşmaları yedekleyin. BSP kullanıyorsanız başvuru süreci daha hızlı olabilir; ancak ek maliyetler uygulanır.

Webhook ve Mesaj Alma

Webhook, müşterilerden gelen mesajların sunucunuza anında iletilmesini sağlar. Webhook URL'inizi Meta'ya kaydedersiniz; gelen mesajlar bu URL'e POST isteği olarak gönderilir. Webhook'u doğrulamak için Meta'nın gönderdiği challenge parametresine yanıt vermeniz gerekir. Webhook'tan gelen verileri parse ederek mesaj içeriğini, gönderen numarayı ve zaman damgasını alabilirsiniz. Bu verilere göre otomatik yanıt veya chatbot mantığınızı çalıştırırsınız. Mesaj şablonu hazırlama rehberimizde şablon formatlarını inceleyebilirsiniz.

Mesaj Şablonları ve 24 Saat Kuralı

WhatsApp'ta müşteriye ilk mesajı siz gönderecekseniz, onaylı bir mesaj şablonu kullanmanız gerekir. Serbest metin yalnızca müşteri son 24 saat içinde size mesaj attıysa gönderilebilir. Şablonlar Meta tarafından onaylanır; reklam, spam veya yanıltıcı içerik reddedilir. Şablonlarda değişken (placeholder) kullanabilirsiniz; örneğin "Merhaba {{1}}, siparişiniz {{2}} numarasıyla hazırlanıyor." Şablon onayı genellikle birkaç saat ile bir gün arasında sürer. Hazır mesaj örnekleri ile şablon fikirleri geliştirebilirsiniz.

Otomasyon ve Chatbot Entegrasyonu

API ile basit veya gelişmiş chatbotlar kurabilirsiniz. Basit senaryolarda: Karşılama mesajı, sık sorulan sorulara otomatik yanıt, menü tabanlı seçenekler. Gelişmiş senaryolarda: Doğal dil işleme (NLP), CRM entegrasyonu, sipariş takibi, ödeme bildirimleri. Chatbot çözümleri için Dialogflow, Rasa veya özel modeller kullanılabilir. Üçüncü parti platformlar (ManyChat, Chatfuel, Respond.io) kod yazmadan chatbot kurmanızı sağlar; ancak esneklik sınırlıdır. Kendi sunucunuzda geliştirme yapıyorsanız tam kontrol sizde olur.

Üçüncü Parti Çözümler ve Maliyet

Twilio, MessageBird, 360dialog, Gupshup gibi BSP'ler API erişimini kolaylaştırır. Aylık abonelik veya mesaj başı ücretlendirme yapılır. Meta'nın kendi Cloud API'si ücretsizdir; ancak mesaj başı ücret (conversation-based pricing) uygulanır. Konuşma türüne göre (utility, marketing, service) farklı fiyatlar vardır. Küçük işletmeler için WhatsApp Business uygulaması genellikle yeterlidir; günde yüzlerce mesaj alıyorsanız API düşünülebilir. Müşteri hizmetleri ekibiniz büyükse API ile çoklu personel ve etiket sistemi kurabilirsiniz.

wa.me ve API Uyumu

API kullanan işletmeler de wa.me link formatını kullanır. Müşteri linke tıkladığında WhatsApp açılır ve sohbet başlar; API tarafında bu sohbet normal bir konuşma olarak işlenir. wa.me nasıl kullanılır rehberimizde link yapısını inceleyebilirsiniz. Hazır mesaj parametresi (?text=) ile müşterinin önceden doldurulmuş mesajla gelmesini sağlayabilirsiniz; bu, kategori bazlı yönlendirme veya chatbot tetikleyicisi olarak kullanılabilir.