Kendi CRM'iniz, ERP'niz ya da sektöre özel bir yazılımınız var; müşterileriniz "WhatsApp'tan da yazabilsinler, sorulara yapay zekâ cevap versin" istiyor. Bu rehberde bunu Meta'nın resmi API'siyle, gayriresmi köprülere bulaşmadan ve aylarca altyapı geliştirmeden nasıl yapacağınızı anlatıyoruz — gerçek endpoint'ler, kod örnekleri ve emlak/e-ticaret senaryolarıyla.

Neden CRM'inize WhatsApp entegre edesiniz?

Türkiye'de müşteri mesajlaşması artık mesai saatlerine sığmıyor. DoWaba platform verisine göre 2026'nın ilk yarısında gelen WhatsApp mesajlarının %57,6'sı mesai saatleri dışında geldi; Instagram DM'lerinde bu oran %65,8. Yapay zekâ botunun medyan ilk yanıt süresi ise 23 saniye. Yani müşteriniz gece 23.00'te yazıyor ve cevap bekliyor — CRM'iniz buna hazır değilse müşteri deneyimindeki boşluğu rakipleriniz dolduruyor.

Kendi yazılımı olan bir ekip için bunun anlamı üç fırsat:

  • Ürününüz değerlenir: CRM'inize "WhatsApp + yapay zekâ destek" yeteneği eklersiniz; müşterileriniz tek üründen hem kayıt yönetimi hem otomatik müşteri iletişimi alır.
  • Yeni gelir kalemi: Bu yeteneği kendi markanızla, kendi fiyatınızla modül olarak satarsınız.
  • Bağlılık (stickiness): Müşterinizin WhatsApp hattı, botu ve mesaj geçmişi sizin ürününüz üzerinden akıyorsa, CRM'inizden vazgeçmesi zorlaşır.

"Meta API'ye kendim bağlanırım" — gerçekten mantıklı mı?

Teknik olarak mümkün: Meta'nın WhatsApp Cloud API'si herkese açık. Pratikte ise sıfırdan üretim kalitesinde bir entegrasyon şunları gerektirir:

  • Meta Business doğrulaması ve uygulama inceleme süreçleri,
  • Webhook altyapısı (imza doğrulama, kuyruk, tekrar deneme, ölçekleme),
  • Mesaj şablonu (template) başvuru ve onay yönetimi,
  • Token yaşam döngüsü ve yenileme,
  • Çok kiracılı (multi-tenant) mimari — her müşterinizin kendi numarası, kendi botu,
  • Ve asıl büyük iş: soruları gerçekten cevaplayacak yapay zekâ katmanı + operatör paneli + bilgi bankası.

Bu, tek başına aylarca sürecek bir ürün geliştirme projesidir. DoWaba'nın Geliştirici API'si tam bu noktada devreye girer: Meta bağlantısı, yapay zekâ motoru, çok kanallı gelen kutusu ve müşteri paneli hazırdır; siz yalnızca kendi sisteminizden REST API ile bağlanırsınız.

KonuSıfırdan Meta Cloud APIDoWaba Geliştirici API
Meta doğrulama & onaylarSizin sorumluluğunuzdaHazır (resmi Cloud API + Embedded Signup)
Yapay zekâ cevap motoruKendiniz geliştirirsinizHazır (sistem promptu + SSS bilgi bankası)
Operatör paneli & gelen kutusuKendiniz geliştirirsinizHazır (isterseniz white-label)
Diğer kanallar (IG, Telegram, e-posta, sesli çağrı)Her biri ayrı projeAynı API, aynı gelen kutusu
Entegrasyon süresiAylarSaatler (yapay zekâ kodu yazarsa dakikalar)

Mimari: CRM'iniz → DoWaba API → resmi Meta altyapısı

Kurgu basit bir üç katman: sizin CRM'iniz DoWaba REST API'sini çağırır (Bearer token ile), DoWaba müşterinizin WhatsApp/Instagram hattını Meta'nın resmi Cloud API'siyle işletir. Gelen mesajlar ve olaylar isterseniz webhook ile sizin sunucunuza geri akar. Bağlantı resmi olduğu için müşterinizin numarası gayriresmi QR köprülerindeki gibi risk altında değildir.

Adım adım entegrasyon

1) API anahtarınızı alın

DoWaba panelinde Geliştirici → API Anahtarları bölümünden tek tıkla anahtar üretirsiniz. Her istekte başlık olarak gönderilir:

curl https://dowaba.com/api/auth/user \
  -H "Authorization: Bearer ANAHTARINIZ" \
  -H "Accept: application/json"

2) Dokümantasyonu yapay zekâya taratın

API dokümantasyonu dowaba.com/api-docs adresinde herkese açık. Panelde hazır duran entegrasyon promptunu ChatGPT, Claude ya da Gemini'ye verip CRM'inize uygun bağlantı kodunu yapay zekâya yazdırabilirsiniz:

Aşağıdaki DoWaba API dokümantasyon linkini incele ve tarat:
https://dowaba.com/api-docs/

Bizim kendi geliştirdiğimiz CRM sistemimiz üzerinden müşterilerimizin DoWaba platformunu otomatik kullanabilmesini istiyoruz. Bu dokümantasyonu baz alarak;
1. Müşterilerimiz adına otomatik alt hesap açma ve şifre oluşturma,
2. Dinamik sistem promptu ve SSS (Sıkça Sorulan Sorular) güncelleme,
3. Müşterilerin kendi bilgilerini düzenleyebileceği panel yetkilendirme fonksiyonlarını yaz.

Bizim CRM sistemimizle uyumlu çalışacak tüm API bağlantı fonksiyonlarını ve gerekli manifest.json yapısını eksiksiz şekilde oluştur.

3) Üç temel fonksiyon

a) Müşteriniz adına alt hesap ve site açın. CRM'inizde ödeme yapan her müşteri için arka planda DoWaba hesabı ve çalışma alanı (site) oluşturursunuz:

# Müşteri hesabı aç
POST /api/reseller/customers
{ "name": "Nova Emlak", "email": "info@novaemlak.com", "phone": "+905321112233" }

# Müşteri adına site (çalışma alanı) aç — sistem promptu dahil
POST /api/reseller/customers/{user}/sites
{ "name": "Nova Emlak", "settings": { "system_prompt": "Sen Nova Emlak'ın 7/24 asistanısın...", "languages": ["tr"] } }

b) Sistem promptu ve SSS'leri programatik yönetin. Botun davranışı settings.system_prompt alanında durur (50.000 karaktere kadar) ve PUT /api/sites/{site} ile güncellenir. Bilgi bankası için tek tek ya da toplu SSS uçları hazır; hatta düz metinden yapay zekâyla SSS çıkaran uç bile var:

POST /api/sites/{site}/faqs/batch              # toplu SSS ekle
POST /api/sites/{site}/faqs/batch-update       # mevcutları toplu güncelle
POST /api/sites/{site}/faqs/extract-from-text  # düz metinden AI ile SSS çıkar
{ "text": "Çalışma saatlerimiz hafta içi 09-19... İade 14 gün içinde..." }

c) Müşterinizi kendi paneline taşıyın. Müşterinizin mesajları görmesi veya botu elle devralması gerektiğinde tek kullanımlık SSO giriş linki üretirsiniz; isterseniz panel kendi markanızla (white-label) açılır:

POST /api/oauth/login-link   # tek kullanımlık, 5 dakika geçerli
→ { "url": "https://panel.sizin-markaniz.com/admin/impersonate?token=..." }

4) Webhook ile geri besleme

Gelen mesajları kendi CRM'inizde göstermek isterseniz outbound webhook tanımlarsınız. Her çağrı X-Dowaba-Signature başlığıyla HMAC-SHA256 imzalanır — imzayı doğrulamadan işlemeyin:

POST /api/webhook-endpoints
{ "url": "https://crm.sizinfirma.com/hooks/dowaba",
  "events": ["whatsapp.message.received"] }

Sektör örnekleri

🏠 Emlak CRM'i

Portföy yönetimi yapan bir emlak CRM'i düşünün. Danışmanın portföyü CRM'de zaten kayıtlı; siz her portföy güncellemesinde ilan özetlerini faqs/batch-update ile botun bilgi bankasına yansıtırsınız. Gece 23.00'te "Kadıköy'de 3+1 kiralık var mı?" diye yazan müşteriye bot portföyden cevap verir, yer görme randevusunu alır; danışman sabah takviminde onaylı randevuyla güne başlar. Mesai dışı gelen o %57,6'lık trafik artık kaybolmuyor.

🛒 E-ticaret paneli

Kendi e-ticaret altyapınız varsa müşterinizin mağazası için siteyi otomatik açar, kargo/iade/ödeme SSS'lerini extract-from-text ile saniyeler içinde yüklersiniz. "Siparişim ne zaman kargolanır?" sorusuna bot anında cevap verir; kampanya gecesi mesaj yağarken kimse kuyrukta beklemez. Gelen mesajları webhook ile kendi panelinizdeki sipariş kaydının yanında da gösterebilirsiniz.

🏥 Klinik / randevu yazılımı

Randevu yazılımı geliştiriyorsanız aynı API ile her kliniğe bir asistan açarsınız: bot çalışma saatlerini, hazırlık talimatlarını cevaplasın, randevu talebini alsın. Üstelik yalnız yazılı kanallar değil — DoWaba'nın yapay zekâ çağrı merkezi telefonu da açar; gerçek sesli asistan hastayla konuşur, randevuyu oluşturur.

Sadece WhatsApp değil

Aynı entegrasyonla müşterileriniz Instagram DM, Messenger, Telegram, TikTok, X, e-posta, web widget'ı ve sesli çağrıları da tek gelen kutusundan yönetir. CRM'inize tek API bağlarsınız; kanal çeşitliliği DoWaba'nın işidir.

Uyum ve güvenlik notları

  • Resmi bağlantı: WhatsApp, Meta'nın resmi Cloud API'siyle bağlanır; Instagram ve Messenger da resmi Meta API üzerinden çalışır.
  • Opt-in zorunlu: API üzerinden yalnızca iletişim onayı almış kişilere mesaj gönderilir; spam, Meta politikaları gereği numaranızın kısıtlanmasına yol açabilir.
  • KVKK: Webhook payload'ları müşteri kişisel verisi içerir; kendi tarafınızda saklama sürelerinizi ve aydınlatma metinlerinizi buna göre kurgulayın.
  • İmza doğrulama: Webhook isteklerinde HMAC imzasını mutlaka doğrulayın.

Sık sorulan sorular

Kendi markamla sunabilir miyim? Evet — Çözüm Ortağı modelinde panel sizin logonuz ve alan adınızla açılır; müşteriniz DoWaba'yı hiç görmez.

Müşteri başına maliyet nedir? Planlar 1.999₺/ay'dan başlar; çözüm ortaklarında hacme göre kademeli indirim uygulanır. Satış fiyatını kendi ürününüzde siz belirlersiniz.

Yapay zekâ hangi modelle cevap veriyor? Her çalışma alanı kendi Gemini anahtarıyla çalışabilir; cevaplar sistem promptu + SSS bilgi bankasından beslenir.

Dokümantasyon nerede? dowaba.com/api-docs (OpenAPI + Postman koleksiyonu dahil) ve panel içindeki menü→endpoint eşleşmeli Geliştirici Rehberi.

Bugün başlayın

dowaba.com'da ücretsiz hesap açın, Geliştirici bölümünden API anahtarınızı üretin ve yukarıdaki promptu yapay zekânıza verin — ilk entegrasyon fonksiyonlarınız birkaç dakika içinde hazır olur. Takıldığınız yerde WhatsApp destek hattımız (ve evet, orada da botumuz) yanınızda.