WhatsApp Business API CRM'e Nasıl Bağlanır? Adım Adım Entegrasyon Rehberi
WhatsApp Business API entegrasyonu için üç şey gerekir: doğrulanmış bir Meta Business hesabı, API'ye kayıtlı bir WhatsApp Business numarası ve CRM tarafında gelen mesajları dinleyen bir webhook adresi. Üçü kurulduğunda WhatsApp yazışmaları ilgili müşteri kaydına düşer ve kanal ölçülebilir hale gelir.
WhatsApp Business API, standart WhatsApp Business uygulamasından farklı olarak programatik çalışır: mesajı bir uygulama gönderir, gelen mesajı bir sunucu alır. Aynı numarayı birden fazla temsilci kullanabilir, şablonla proaktif mesaj gönderilebilir ve her yazışma bir kayda bağlanabilir.
Bu rehber kurulum sürecini, iki erişim yolunu, ölçüm çerçevesini, maliyet kalemlerini ve KVKK tarafını sırayla anlatıyor. Rapitek CRM'in bu işte ne yaptığını ve neyi yapmadığını da ayrı bir bölümde yazdık. Meta tarafındaki adımlar, kurallar ve ücretlendirme mantığı Ağustos 2026 itibarıyla Meta'nın kendi kamuya açık belgelerine dayanır; Meta bunları zaman içinde değiştiriyor.
Müşteri hangi kanaldan yazacağını kendi seçer; o kanal CRM'e bağlı değilse yazışma kaybolmaz — çalışanın telefonunda kalır ve şirket ona erişemez.
İçindekiler
WhatsApp Business API ve CRM entegrasyonu nedir?
WhatsApp Business API, işletmelerin WhatsApp üzerinden programatik ve ölçeklenebilir iletişim kurmasını sağlayan kurumsal arayüzdür. CRM ile entegre edildiğinde konuşmalar otomatik olarak müşteri kayıtlarına işlenir ve tek merkezden yönetilir.
Uygulamadan farkı ne?
- Çoklu kullanıcı: aynı numarayı birden fazla temsilci aynı anda kullanır.
- Programatik mesajlaşma: webhook üzerinden gelen mesaja sistem otomatik yanıt üretebilir.
- Şablon mesajlar: önceden onaylanmış şablonlarla konuşmayı işletme başlatabilir.
- Medya: görsel, video, PDF ve diğer dosya biçimleri desteklenir.
- Doğrulanmış işletme adı: müşteri kime yazdığını görür.
Entegrasyonun üç somut karşılığı
Merkezi geçmiş. Tüm yazışma tek yerde toplanır; hangi temsilcinin hangi müşteriyle ne konuştuğu kayıtlıdır. Satışçı ayrıldığında yerine gelen kişi geçmişi okuyup devam eder.
Otomatik eşleştirme. Gelen numara mevcut bir kişiyle eşleşirse konuşma o kayda bağlanır; eşleşmezse yeni bir müşteri adayı açılır. Paylaşılan dosyalar da kayda işlenir.
Ölçülebilirlik. "WhatsApp'tan gelen taleplerin yüzde kaçı teklife döndü?" sorusu tahminle değil sorguyla cevaplanır. Kanal kaynağı alan olarak tutulduğu için diğer kanallarla karşılaştırma yapılabilir.
Şifreleme konusunda bir netleştirme
WhatsApp'ın kişiden kişiye sohbetleri uçtan uca şifrelidir; Cloud API üzerinden yürüyen işletme mesajları için durum farklıdır. Mesajlar Meta'nın sunucusunda işlenir ve oradan işletmenin sistemine aktarılır. "Uçtan uca şifreli" ifadesini işletme yazışmaları için bir gizlilik garantisi olarak sunmayın; taşımada TLS ve sizin tarafınızdaki erişim kontrolü gerçek koruma katmanıdır.
WhatsApp Business API kurulum süreci
-
1
Adım 1: API erişimi
Meta Business Manager hesabı açıp WhatsApp Business Platform'a başvurun ve işletme doğrulamasını tamamlayın; ya da onaylı bir BSP üzerinden ilerleyin.
-
2
Adım 2: Numara doğrulama
Daha önce WhatsApp'ta kullanılmamış özel bir numara gerekir. Doğrulama SMS veya sesli aramayla yapılır; sabit hat kullanılabilir, kısa kodlar desteklenmez.
-
3
Adım 3: Webhook yapılandırması
HTTPS destekli bir webhook adresi oluşturun, doğrulama jetonunu tanımlayın, mesaj olaylarını dinleyin ve gelen veriyi CRM'e yönlendirin.
-
4
Adım 4: Şablon onayı
Proaktif mesajlaşma şablon onayı ister: kategoriyi seçin (utility, marketing, authentication), değişkenleri tanımlayın, dilleri ekleyin ve Meta onayını bekleyin.
İki erişim yolu: doğrudan Meta mı, BSP mi?
API'ye iki yoldan erişilir ve karar mesaj hacminize, teknik kapasitenize ve kimin fatura keseceğine bağlıdır.
Doğrudan Meta üzerinden: Meta Business Manager hesabı açılır, WhatsApp Business Platform'a başvurulur, işletme doğrulaması tamamlanır ve API erişim anahtarları alınır. Mesaj faturası doğrudan Meta tarafından işletmeye kesilir; arada bir aracı yoktur.
BSP (Business Solution Provider) üzerinden: onaylı bir sağlayıcı seçilir, platformuna kayıt olunur, numara doğrulanır ve kredi yüklenir. BSP kurulum yükünü azaltır ancak mesaj ücretine platform ücreti ekler.
Rapitek CRM'de kullandığımız model doğrudan erişimdir: kendi Meta uygulamanızı ve kendi WhatsApp Business hesabınızı bağlarsınız, bağlantı Meta Graph API v21.0 üzerinden kurulur ve mesaj faturası size kesilir. Meta'nın resmi iş ortağı (BSP) değiliz ve mesaj kredisi satmıyoruz.
Müşteri bölümü menüden seçer, sohbet doğru ekibe düşer
Müşteri numaralı menüden ilgili bölümü seçer, sohbet o bölüme yönlendirilir ve konuşmayı sorumlu temsilci devralır. Satış, teknik destek, muhasebe ve genel bilgi ayrı kuyruklara düşer.
Rapitek CRM ile WhatsApp entegrasyonu
Rapitek CRM, WhatsApp Business Platform'a Meta'nın resmi Cloud API'si üzerinden bağlanır; ayrıca telefondaki mevcut hesabı QR koduyla eşleştiren ikinci bir yöntem vardır. İkisini birbirinden ayırmak önemlidir: QR eşleştirmesi Meta'nın resmi arayüzü değildir, hızlı başlangıç için kullanılır ve kurumsal senaryolarda resmi API'yi öneririz. İkisinin ayrıntılı karşılaştırması QR ile mi, resmi API ile mi yazısında.
Modülün bugün yaptıkları
- Ortak gelen kutusu: ekip tek numaradan CRM içinden yanıtlar; her konuşma ilgili kişi, müşteri adayı ya da fırsat kaydına bağlanır.
- Bölüm yönlendirme: müşteri menüden seçim yapar, sohbet doğru ekibin kuyruğuna düşer.
- Otomatik müşteri adayı: WhatsApp'tan yazan her yeni numara CRM'de kayda geçer.
- Yanıt hedefi takibi: sohbet bazında ilk yanıt ve çözüm hedefi, iş saati takvimi ve duraklat/devam mantığı kayıt altına alınır. Bu bir SLA taahhüdü değil, kendi hedefinizi ölçme aracıdır.
- İzinli toplu gönderim: yalnızca iletişim izni bulunan, segmente edilmiş gruplara; İYS izin sorgusu Verimor üzerinden iki yönlü çalışır.
- Saklama: CRM verileriniz size ait ayrı bir veritabanında tutulur: ayrı tablo dosyaları, ayrı yedek ve ayrı dosya alanı. Bu ayırım uygulama ayarında değil veritabanı düzeyindedir. Saklama süresini siz belirlersiniz.
Tipik kullanım senaryoları
- Karşılama: yeni yazan müşteri çalışma saatlerini ve menüyü anında alır.
- Randevu ve teslimat bilgilendirmesi: şablon onayı alındıktan sonra hatırlatma mesajı gönderilir.
- Gayrimenkul: portföy paylaşımı şablonla yürür — ayrıntı için Emlak CRM.
- Destek talebi: gelen sorun kayda alınır, doğru temsilciye yönlendirilir, çözüm durumu aynı sohbetten bildirilir.
Tüm seçenekler için Entegrasyonlar ve WhatsApp CRM sayfalarına bakabilirsiniz.
Entegrasyonun işe yaradığını nasıl anlarsınız
| Ölçülecek metrik | Nasıl ölçülür | Neden önemli |
|---|---|---|
| İlk yanıt süresi | Mesajın gelişi ile ilk insan yanıtı arasındaki medyan süre | Hedefi siz belirlersiniz; Rapitek CRM sohbet bazında ilk yanıt hedefini iş saati takvimine göre sayar |
| Kayıt altına alınan yazışma oranı | CRM'e işlenen konuşma / toplam konuşma | Entegrasyonun asıl işi budur; düşükse yazışmanın bir kısmı hâlâ CRM dışında yürüyor demektir |
| WhatsApp kaynaklı müşteri adayı sayısı | Kanalı kaynak olarak işaretlenmiş yeni kayıtlar | Kanalın satış üretip üretmediğini bu sayıdan görürsünüz |
| Kanal bazında dönüşüm oranı | WhatsApp adaylarının müşteriye dönüşme oranı | Diğer kanallarla kıyaslayın; fark varsa sebebini arayacak olan sizsiniz |
| Şablon onay ve red oranı | Meta'ya gönderilen şablonların onaylanma yüzdesi | Reddedilen şablon yeniden yazılıp yeniden onaya gider; kampanya takviminiz o beklemenin uzunluğu kadar kayar |
| Servis penceresi dışı mesaj maliyeti | 24 saatlik pencere dışında gönderilen şablon mesaj gideri | Aylık toplamını takip edin: pencere kapandıktan sonra açılan her konuşma şablon ücretine girer, yani bu kalem yanıt hızınıza ve gönderim zamanlamasına bağlıdır |
Maliyet kalemleri
Meta tarafındaki mesaj ücreti
- Kullanıcının başlattığı konuşmalar: 24 saatlik servis penceresi içindeki yanıtlar için ayrı şablon ücreti ödenmez.
- İşletmenin başlattığı mesajlar: şablon ücreti alınır; tutar kategoriye (utility, marketing, authentication) ve ülkeye göre değişir. Meta'nın Ağustos 2026'da yayımlanmış kamuya açık fiyat listesinde pazarlama mesajları utility mesajlarından yüksek fiyatlanıyor.
- Güncel tarife: Meta zaman içinde değiştiriyor; rakamı her zaman Meta'nın kendi fiyat sayfasından doğrulayın.
- BSP ücreti: aracı kullanıyorsanız mesaj ücretine platform ücreti eklenir.
Kendi tarafınızdaki kalemler
Başlangıçta: API yapılandırması, CRM tarafındaki alan ve akış kurulumu, ekip eğitimi, pilot uygulama. Sürekli olarak: mesaj ücretleri, CRM plan bedeli ve şablon bakımı.
Kolayca gözden kaçan bir kalem var: 24 saatlik pencere kaçırılıp konuşmanın şablonla yeniden açılması. Her yeniden açılış ayrıca ücretlenir; yanıt süresini kısaltmak bu yüzden bir müşteri deneyimi konusu olduğu kadar bir maliyet konusudur.
Rapitek CRM tarafındaki güncel plan fiyatları ve plan dışında fiyatlanan kalemler için CRM Fiyatları sayfasına bakabilirsiniz; kurulumun kapsamı ve varsa bedeli keşif görüşmesinde çıkarılıp yazılı paylaşılır.
KVKK ve güvenlik uyumu
WhatsApp üzerinden toplanan veriler KVKK kapsamındadır ve entegrasyon kararından önce konuşulmalıdır.
- Açık rıza: ticari iletişim için izin alın; talebe verilen yanıt ile pazarlama mesajını ayırın.
- Aydınlatma metni: WhatsApp'ı kanal olarak açıkça sayın; "web formu" demek yetmez.
- Veri minimizasyonu: yalnızca süreç için gerekli veriyi toplayın.
- Saklama süresi: süre belirleyin ve dolunca imha edin.
- Silme hakkı: müşteri talebiyle kaydı silebilecek durumda olun; veri çalışanın telefonundaysa bu mümkün değildir.
Rapitek CRM'in barındırma ve saklama bileşenleri Avrupa Birliği'nde çalışır: veritabanı Helsinki'de (Finlandiya), yüklediğiniz dosyalar Frankfurt'ta, yedekler Falkenstein'da (Almanya). Türkiye'de tutulan bir kopya yoktur ve bölge seçimi diye bir özelliğimiz de yoktur. Bu yerleşim KVKK m.9 anlamında yurt dışına aktarımdır: aydınlatma metniniz kanalı ve alıcıyı içermeli, açık rıza süreciniz buna göre kurulmalıdır.
Bileşenlerin tamamı için tek bir konum cümlesi kurmuyoruz, çünkü iki akış AB dışına çıkar: yapay zekâ özelliklerini kullanırsanız ilgili istek Amerika Birleşik Devletleri'ne (Anthropic) gider — bu, KVKK m.9 kapsamında ikinci bir aktarımdır — ve sistem e-postaları ayrı bir gönderim servisinden çıkar. Hangi verinin hangi ülkede durduğu ve hangi alt işleyicinin devrede olduğu Güvenlik sayfasında kalem kalem yazılıdır. Yedek altı saatte bir alınır ve 30 gün saklanır. Ayrıntılar için KVKK Aydınlatma Metni sayfasına bakın.
Bizim sınırlarımız
Bu bölüm, WhatsApp entegrasyonunda kurulan beklentilerin bizdeki karşılığıdır. Kurulumdan sonra öğrenilmesi herkesi yorar.
- Meta'nın resmi iş ortağı (BSP) değiliz ve WhatsApp mesaj paketi satmıyoruz. Fatura doğrudan Meta tarafından size kesilir.
- Bu yazıdaki ölçüm tablosunu sizin yerinize dolduran hazır bir kanal panosu yok. Rapor ve pano kurulur; ama matris ve birleşik rapor tipleri erişebildiğimiz sekiz kiracının hiçbirinde bugüne kadar bir kez bile çalıştırılmadı. Kanal ölçümünü tablo ve özet raporla kurarsınız.
- Giden webhook altyapısı kurulu — imzalı, yeniden denemeli, iş akışından tetiklenebilir — ama 24 kiracının hiçbirinde tanımlı abonelik yok. WhatsApp olaylarını kendi sisteminize taşıyacaksanız bu bağlantı projeye özel kurulur.
- Kargo takip numarası Rapitek CRM'de düz metin bir alandır; hiçbir kargo servisinin API'si çağrılmaz. "Kargo durumunu WhatsApp'tan otomatik bildiririz" demiyoruz.
- Sipariş ya da teslimat mesajının arkasına resmi belge bağlayamayız: e-fatura ve e-arşiv kesmiyoruz, fatura nesnesinde ETTN ya da GİB durumu diye bir alan yok. Belgeyi kesen sistem ayrıdır ve bağlantısı projeye özel kurulur.
- Sepet terk otomasyonu vaat etmiyoruz. Satış dizisi nesnesi ürüne kurulu, ama erişebildiğimiz sekiz kiracıda bugüne kadar tek bir dizi tanımlanmamış.
- SMS tarafında "DURDUR yazın" vaadi verilemez: gönderici başlığı alfanümeriktir ve sisteme gelen SMS düşmez. WhatsApp'ta çıkma talebi çalışır.
Sık sorulan sorular
WhatsApp Business API nedir?
WhatsApp CRM entegrasyonu nasıl yapılır?
WhatsApp Business API fiyatı ne kadar?
Resmi Business API yerine QR eşleştirmeyle başlayabilir miyim?
WhatsApp Business API mesajları uçtan uca şifreli mi?
WhatsApp'tan toplu mesaj gönderebilir miyim?
WhatsApp'ta 24 saat kuralı maliyeti nasıl etkiler?
WhatsApp entegrasyonu kurulumu ne kadar sürüyor?
İlgili içerikler
- QR ile mi, resmi Business API ile mi? — iki yöntemin risk ve mülkiyet karşılaştırması.
- WhatsApp CRM — ortak gelen kutusu ve bölüm yönlendirme.
- Satış hattı (pipeline) nedir — gelen mesajın fırsata dönüştüğü yer.
- Güvenlik — veri konumu, yedekleme ve erişim kontrolü.
- CRM Fiyatları — plan kademeleri ve plan dışında fiyatlanan kalemler.
WhatsApp'ı CRM'inizle buluşturun
Ürün yeni, ekip değil: Salesforce döneminde 200'den fazla kurumsal CRM projesi tamamladıktan sonra kendi platformumuzu kurduk. Rapitek CRM'i ekibinizin çalışma şekline göre yapılandırıp kurulumunu biz yapıyoruz.
Keşifte numaranızı, şablonlarınızı ve webhook tarafını birlikte çıkarırız; kapsam yazılı olur, Meta onay süresi bize ait değildir.
Kerim Yıldırım
Kurucu, Rapitek CRM · Salesforce döneminde 200'den fazla kurumsal CRM projesi
Kaynaklar
Bu yazıdaki dış olgular şu birincil kaynaklara dayanıyor:
