WhatsApp Business API Entegrasyonu: Kurumsal Kullanım Rehberi

WhatsApp Business API entegrasyonu, işletmenizin sistemlerini (CRM, sipariş ya da randevu yazılımı, AI asistan) Meta'nın resmi WhatsApp Business Platform'una bağlayarak mesajları yazılım üzerinden göndermenizi ve almanızı sağlar. Dört şey gerekir: bir Meta işletme hesabı ve işletme doğrulaması, API'ye bağlanacak bir telefon numarası, Meta'nın onayladığı mesaj şablonları ve mesajları işleyecek bir yazılım katmanı. Doğrudan Meta üzerinden ya da bir iş ortağı (BSP) aracılığıyla yapılabilir; asıl iş, teknik bağlantıdan çok kuralların doğru tasarlanmasıdır.

WhatsApp Business API nedir, uygulamadan farkı ne?

WhatsApp Business uygulaması, telefonunuza kurduğunuz ve bir kişinin elle mesaj yazdığı küçük işletme aracıdır. WhatsApp Business API ise (Meta'nın adıyla WhatsApp Business Platform) yazılımların mesaj gönderip alabilmesi için açılmış resmi bir arayüzdür: kendi başına bir ekranı yoktur, mesajlar sizin ya da iş ortağınızın yazılımı üzerinden akar. Bu yüzden "API'ye geçmek", WhatsApp hattınızı bir sisteme bağlamak demektir. Çoklu temsilci, CRM bağlantısı, otomatik akış ve AI asistan gibi kurumsal ihtiyaçların hepsi bu arayüz üzerinden çalışır. Uygulamayla başlayıp sonra API'ye geçmek mümkündür; numara uygulamada kalırken API'ye de bağlanabilir. Yine de geçiş planlanmalı, numaranın hangi akışta kullanılacağı en baştan netleştirilmelidir.

Entegrasyondan önce hazır olması gerekenler

Kurumsal bir entegrasyon dört hazırlıkla başlar:

1. Meta işletme hesabı ve işletme doğrulaması. API erişimi Meta'nın işletme hesabına bağlıdır. İşletmenizin resmi adı, vergi ve adres belgeleriyle doğrulanır; doğrulama, mesaj hacmi sınırlarını ve bazı özellikleri etkiler.
2. API'ye bağlanacak telefon numarası. Numaranın hangi sistemde kullanılacağı belirlenir. Yeni bir numara ayrılabilir; WhatsApp Business uygulamasında kullanılan mevcut numara da Meta'nın birlikte kullanım (coexistence) özelliğiyle, bir iş ortağının kayıt akışı üzerinden API'ye bağlanabilir. Bu durumda uygulamadan bire bir yazışma sürer ve sohbet geçmişi iki tarafta eşitlenir; ancak gönderim hızı sabit bir sınırla çalışır, toplu yayın listeleri ve grup sohbetlerinin eşitlenmesi gibi bazı özellikler kullanılamaz.
3. Mesaj şablonları. İşletme tarafından başlatılan mesajlar (hatırlatma, bilgilendirme, kampanya dışı bildirimler) Meta'nın onayladığı şablonlarla gönderilir. Şablonun amacı ve kategorisi baştan doğru seçilmelidir.
4. Kimin cevap vereceğinin tanımı. Mesajı hangi sistemin karşılayacağı (AI asistan, temsilci paneli, ikisi birlikte) ve hangi durumlarda insana aktarılacağı yazılı hale getirilir.

Bağlantı nasıl kurulur? Doğrudan Meta mı, iş ortağı mı?

İki yol vardır. Birincisi Meta'nın Cloud API'sine doğrudan bağlanmaktır: Meta altyapıyı barındırır, sizin ekibiniz ya da yazılım ortağınız webhook'larla mesajları alıp API çağrılarıyla gönderir. Bu yol esnektir ama güvenlik, hata yönetimi ve ölçekleme sorumluluğu sizdedir. İkincisi Meta'nın onaylı iş ortaklarından (Business Solution Provider) birinin hazır platformunu kullanmaktır: panel, temsilci arayüzü ve faturalama hazır gelir, esneklik azalır. Seçimi belirleyen soru şudur: ihtiyacınız yalnızca mesajlaşma paneli mi, yoksa mesajların CRM, sipariş sistemi ve bir AI asistanla birlikte çalıştığı özel bir akış mı? İkincisiyse genellikle doğrudan bağlantı ya da bu akışı kurabilen bir ortak gerekir.

Kurumsal kullanımda bilinmesi gereken Meta kuralları

Entegrasyonun teknik kısmından çok bu kurallar sonucu belirler:

• 24 saatlik müşteri hizmetleri penceresi. Müşteri size yazdığında 24 saat boyunca serbest metinle cevap verebilirsiniz. Pencere kapandıktan sonra işletme yalnızca onaylı şablon mesaj gönderebilir.
• İzin (opt-in). Müşteriye işletme tarafından mesaj başlatmak için önceden izin alınmış olması gerekir; izin alınmamış toplu mesaj hesabın kalite puanını düşürür.
• Şablon onayı. Her şablon Meta tarafından incelenir; reddedilebilir. Şablon metinleri onay sürecine göre planlanmalıdır.
• Ücretlendirme. Meta, şablon mesajlar için mesaj başına ücret uygular; tarife ülkeye ve mesaj kategorisine göre değişir. Müşteri hizmetleri penceresi açıkken gönderilen serbest mesajlar ve hizmet (utility) şablonları ücretsizdir. Güncel liste Meta'nın resmi fiyat sayfasındadır, bu yazıda rakam verilmez çünkü sık güncellenir.
• Kullanım amacı. Platform şartları işletmenin kendi müşteri iletişimi için kurulan asistanları kapsar; genel amaçlı yapay zekâ asistanları için kısıtlar olabilir. Şartlar değişebildiği için kurulumdan önce güncel Business Solution şartlarına bakılır.

Bu kurallar Meta'nın resmi WhatsApp Business Platform dokümantasyonunda yazılıdır; entegrasyon tasarımı bu kurallara göre yapılmazsa teknik olarak çalışan bir sistem bile hesap kısıtlamasıyla karşılaşabilir.

Entegrasyon adım adım nasıl ilerler?

Pratikte süreç şu sırayı izler:

1. Kapsam: hangi akışlar WhatsApp'a taşınacak (sık sorular, randevu, sipariş durumu, bildirim) ve hangi sistemlerle konuşacak.
2. Hesap hazırlığı: Meta işletme hesabı, doğrulama, numara ve hesap kalitesi ayarları.
3. Bağlantı: webhook adresi, erişim anahtarlarının güvenli saklanması, mesaj alma ve gönderme testi.
4. Şablonlar: gerekli şablonların yazılması ve onaya gönderilmesi.
5. Sistem entegrasyonu: CRM, randevu ya da sipariş sisteminin bağlanması; mesajların hangi kayda yazılacağı.
6. Cevaplayıcı: AI asistan ya da temsilci paneli devreye alınır, insana devir kuralları test edilir.
7. Canlıya alma ve izleme: ilk haftalarda teslim edilmeyen mesajlar, şablon reddi ve hesap kalitesi izlenir.

Bu adımların ayrıntılı AI asistan boyutu için WhatsApp yapay zeka asistanı kurulum rehberine bakabilirsiniz.

Entegrasyonun en sık takıldığı yerler

En sık sorunlar altyapıda değil kararlardadır. İlki, işletme doğrulaması için gereken belgelerin geç toplanmasıdır; süreç bu yüzden uzar. İkincisi, mevcut numaranın hangi sistemde kalacağının baştan düşünülmemesidir. Üçüncüsü, 24 saat kuralının gözden kaçmasıdır: pencere kapandıktan sonra müşteriye serbest metin göndermeye çalışan akışlar hata verir. Dördüncüsü, izinsiz ya da ilgisiz toplu mesajla hesap kalitesinin düşmesidir. Beşincisi, cevaplayıcının sınırlarının tanımlanmamasıdır: sistem teknik olarak mesaj alıp gönderirken kimin hangi konuyu yanıtladığı belli değilse müşteri deneyimi bozulur.

Bir sonraki adım

WhatsApp Business API entegrasyonunu işletmenizin sistemleriyle ve bir AI asistanla birlikte planlamak için WhatsApp AI asistan hizmet sayfasına göz atabilir, iletişim formundan kısa bir keşif görüşmesi isteyebilir ya da 0850 840 08 23 numaralı hattı arayıp sesli asistanımız Azra ile canlı görüşebilirsiniz.

Sık sorulan sorular

WhatsApp Business API entegrasyonu için işletme doğrulaması şart mı?

API erişimi Meta işletme hesabı üzerinden çalışır ve doğrulama, mesaj hacmi sınırları ile bazı özellikleri etkiler. Bu yüzden kurumsal kullanımda doğrulamayı baştan tamamlamak önerilir; güncel gereklilikler Meta'nın resmi dokümantasyonundadır.

Mevcut WhatsApp numaramı API'ye taşıyabilir miyim?

Evet. İki yol vardır. Birincisi birlikte kullanımdır (coexistence): WhatsApp Business uygulamasındaki numara bir iş ortağının kayıt akışıyla API'ye bağlanır, uygulamadan bire bir yazışma sürer ve son altı ayın sohbetleri eşitlenebilir; gönderim hızı ise sabit bir sınırla çalışır. İkincisi numarayı tamamen API'ye taşımaktır. Hangisinin uygun olduğu mesaj hacmine ve ekibin uygulamayı kullanmaya devam edip etmeyeceğine göre baştan seçilir.

WhatsApp Business API ücretli mi?

Meta şablon mesajlar için mesaj başına ücret uygular ve tarife ülkeye ile mesaj kategorisine göre değişir. Müşterinin yazmasıyla açılan 24 saatlik pencere içindeki serbest mesajlar ücretsizdir. İş ortağı kullanıyorsanız platform ücreti ayrıca eklenir. Güncel tarife Meta'nın resmi fiyat sayfasında yayımlanır.

API entegrasyonu ile AI asistan aynı şey mi?

Hayır. API, mesajların yazılımla gönderilip alınmasını sağlayan kanaldır; AI asistan ise gelen mesajı anlayıp cevaplayan katmandır. İkisi birlikte çalışır: API kanalı sağlar, asistan konuşmayı yürütür ve gerektiğinde insana devreder.