WhatsApp Business API bağlama
Klinik numaranızı Meta'nın resmi WhatsApp Business API'sine bağlayın; gereksinimler, adım adım kurulum, numara durumları ve limitler.
6 dk okuma
Sağlık turizminde hastaların çoğu kliniğe WhatsApp'tan yazar. MedicalGrow, numaranızı Meta'nın resmi WhatsApp Business API'sine bağlar: tüm ekibiniz aynı numaradan, tek gelen kutusundan yanıt verir; konuşmalar hasta kaydında saklanır; kimsenin telefonu "klinik telefonu" olmak zorunda kalmaz.
Bu makale kurulumu baştan sona anlatır. Kurulum yaklaşık 15–20 dakika sürer; numaranıza o sırada SMS veya arama ile kod gelebilmesi gerekir.
Resmi API ne demek, neden önemli?
Piyasada WhatsApp Web'i taklit eden, QR kod okutarak çalışan resmi olmayan araçlar vardır. Bunlar WhatsApp kullanım koşullarına aykırıdır ve numaranın kalıcı olarak yasaklanmasına yol açabilir. MedicalGrow'daki bağlantı ise Meta'nın kendi kurulum penceresiyle (Embedded Signup) yapılır ve Meta tarafından onaylı bir iş ortağı altyapısı üzerinden çalışır.
"Ban riski yok" ifadesinin doğru anlamı şudur: Aracı kullandığınız için numaranız kapatılmaz. Ancak Meta'nın mesajlaşma kurallarına uymanız yine gerekir: izinsiz toplu mesaj, çok sayıda engellenme veya şikâyet, yasaklı içerik gibi durumlar resmi API'de de numaranızı kısıtlayabilir. Kurallar için bkz. WhatsApp kuralları ve kalite puanı.
Başlamadan önce
| Gereksinim | Açıklama |
|---|---|
| Uygun telefon numarası | SMS veya sesli arama alabilen bir numara (sabit hat da olabilir). Numara şu anda WhatsApp veya WhatsApp Business uygulamasında aktif olmamalı — ya da aşağıdaki "Coexistence" yöntemini kullanmalısınız. |
| Meta Business portföyü | Kliniğin Meta Business portföyü (Business Manager). Yoksa kurulum sırasında oluşturulabilir; ancak önceden açıp yönetici olmanız önerilir. |
| Facebook hesabı | Portföyde yönetici (Full control) olan kişisel Facebook hesabı. Klinik sahibinin veya kalıcı bir yöneticinin hesabını kullanın. |
| İşletme doğrulaması (önerilir) | Meta Business doğrulaması (Business verification). Zorunlu değildir ama mesaj limitinizi yükseltir ve görünen ad onayını kolaylaştırır. |
| Web sitesi | Görünen adınızla uyumlu, yayında bir web sitesi. Meta görünen adı buna bakarak onaylar. |
| Panel yetkisi | MedicalGrow'da Settings'e erişen Admin kullanıcı. |
Dikkat
Numara şu anda kişisel WhatsApp uygulamasında kayıtlıysa API'ye bağlanamaz. Önce telefonda sohbetlerinizi yedekleyin, ardından WhatsApp → Settings → Account → Delete my account ile o numaradaki hesabı silin. Silme işleminden sonra birkaç dakika bekleyip kuruluma başlayın. Kişisel hesap silinince eski sohbetler panele aktarılmaz.
Hangi bağlantı yöntemi size uygun?
| Durumunuz | Seçeneğiniz |
|---|---|
| Yeni veya hiç WhatsApp'ta kullanılmamış bir numara | Create a new WhatsApp business account (önerilen) |
| Numara telefondaki WhatsApp Business uygulamasında ve uygulamayı kullanmaya devam etmek istiyorsunuz | Connect a WhatsApp Business App (Coexistence) |
| Numara başka bir firmanın WhatsApp API'sinde kayıtlı | Migrating from an existing BSP — taşıma için destek ekibimize de haber verin |
Coexistence ile aynı numarayı hem telefondaki WhatsApp Business uygulamasında hem panelde kullanırsınız; kişileriniz ve son 6 aya kadar sohbet geçmişiniz panele aktarılır. Sınırları şunlardır: hesap başına tek numara, şablon mesajlar yalnızca panelden gönderilir, grup sohbetleri, yayın listeleri, kaybolan mesajlar ve WhatsApp aramaları panele gelmez. Ayrıca bağlantının sürmesi için telefondaki uygulamayı düzenli olarak (Meta'nın şartına göre en az iki haftada bir) açmanız gerekir.
Adım adım bağlantı (yeni numara)
- Sol menüden Settings'e girin ve alt menüde WhatsApp'ı açın (Integrations değil, ayrı bir menü).
- Connect your WhatsApp butonuna tıklayın.
- Bağlantı yöntemi olarak Create a new WhatsApp business account'u seçin ve Continue with Facebook ile devam edin. Meta'nın kurulum penceresi açılır.
- Facebook hesabınızla giriş yapın ve işletme bilgilerinizi doldurun: Business portfolio (mevcut portföyünüzü seçin veya yeni oluşturun), web siteniz ve ülkeniz.
- WhatsApp Business account (WABA) seçin. İlk kurulumda Create a WhatsApp Business account seçeneğini işaretleyin; daha önce oluşturduğunuz bir hesap varsa onu seçebilirsiniz.
- İşletme profilini oluşturun: display name (hastaların göreceği ad, ör. "Aura Dental Clinic") ve Category olarak Medical and health. Açıklama ve web sitesi alanlarını da doldurabilirsiniz.
- Telefon numarasını girin ve doğrulama yöntemini seçin: Text message (SMS) veya Phone call (sesli arama). Sabit hatlarda sesli aramayı seçin.
- Numaraya gelen 6 haneli kodu girin.
- Son ekranda MedicalGrow'a verilecek izinleri gözden geçirin ve Confirm ile onaylayın; ardından Finish'e tıklayın. Pencere kapanır.
- Panele döndüğünüzde Settings → WhatsApp sayfasında numaranızı, durumunu ve görünen ad onayını görürsünüz.
İpucu
Kurulum sırasında pencere kapanırsa veya hata alırsanız baştan başlayın; Meta yarım kalan adımları hatırlar ve oluşturduğunuz portföy/WABA'yı listede gösterir. Aynı numarayla ikinci bir WABA oluşturmayın.
Görünen ad (display name) kuralları
Görünen ad, hastanın WhatsApp'ta sizi kaydetmemiş olsa bile gördüğü işletme adıdır. Meta her adı inceler; onaylanana kadar adınız görünmeyebilir ve gönderim sınırlı olabilir.
- Adınız işletmenizle açıkça ilişkili olmalı ve web sitenizde, tabelanızda veya resmi belgelerinizde geçmeli.
- Yalnızca genel bir kelime olamaz: "Dental Clinic", "Hair Transplant" ✗ — "Aura Dental Clinic" ✓.
- Büyük harf kuralları normal olmalı (tamamı büyük harf olmamalı, kısaltmalar hariç); emoji, gereksiz noktalama ve "WhatsApp" kelimesi kullanılmamalı.
- Bir kişinin adı tek başına kullanılamaz; marka olarak tanınıyorsa (ör. "Dr. Kaya Aesthetics") web sitesinde aynı şekilde geçmeli.
- Adı sonradan değiştirirseniz yeniden incelemeye girer.
Ad reddedilirse panelde veya Meta'nın WhatsApp Manager ekranında Rejected görünür; adı kurallara göre düzeltip yeniden gönderin.
Numara durumları
| Durum | Anlamı | Ne yapmalı? |
|---|---|---|
| Connected | Numara aktif, mesaj gönderip alabilirsiniz. | — |
| Pending | Kayıt veya görünen ad incelemesi sürüyor. | Birkaç saat ile 1–2 gün bekleyin. |
| Flagged | Kalite puanı düşük. | Gönderimleri azaltın, şablonları gözden geçirin. |
| Restricted | Kural ihlali veya limit aşımı nedeniyle yeni konuşma başlatma kısıtlandı. | Gelen mesajlara yanıt verebilirsiniz; destek ekibimize yazın. |
| Disconnected / Offline | Bağlantı koptu (ör. numara başka yerde kaydedildi). | Destek ekibimize yazın. |
Durum etiketleri panelde ve WhatsApp Manager'da küçük farklarla görünebilir.
Mesaj limitleri
Meta, işletmelerin 24 saatlik pencere dışında (yani şablonla) ulaşabileceği benzersiz kişi sayısını sınırlar. Limit, Meta Business portföyünüzdeki tüm numaralar için ortaktır:
| Seviye | 24 saatte şablonla ulaşılabilecek kişi |
|---|---|
| Başlangıç | 250 |
| 1. seviye | 2.000 |
| 2. seviye | 10.000 |
| 3. seviye | 100.000 |
| En üst | Sınırsız |
- İşletme doğrulamasını tamamladığınızda veya 30 gün içinde yüksek kaliteli şablonlarla 2.000 kişiye ulaştığınızda 2.000'e çıkarsınız.
- Sonraki seviyeler, kalite puanınız iyiyse ve son 7 günde mevcut limitinizin en az yarısını kullandıysanız otomatik yükselir.
- Hastanın size yazdığı konuşmalara verdiğiniz yanıtlar bu limite sayılmaz.
Mesajlar nerede görünür?
WhatsApp mesajları Conversations'ta yeşil WhatsApp ikonuyla görünür; ilk kez yazan her hasta için Contacts'ta kayıt açılır. 24 saat penceresi kapalıysa yanıt kutusu sizden şablon seçmenizi ister — bkz. WhatsApp şablonları.
Örnek: Londra'dan Sarah Mitchell, Instagram reklamınızdaki WhatsApp butonuna tıklayıp yazar. Mesaj panele düşer, Zeynep Arslan konuşmayı üstlenir, Mehmet Demir de aynı konuşmaya not bırakır; hasta tüm yanıtları "Aura Dental Clinic" adıyla tek numaradan alır.
Sık karşılaşılan sorunlar
"Bu numara zaten WhatsApp'ta kayıtlı" hatası. Numara kişisel veya Business uygulamasında hâlâ aktif. Ya hesabı silin ya da Coexistence yöntemini seçin.
Doğrulama kodu gelmiyor. Sesli arama yöntemini deneyin; sabit hatlarda arama hattının dışarıdan çağrı aldığından emin olun. Çok sayıda deneme yaptıysanız Meta birkaç saat bekletebilir.
Kurulum bitti ama panelde numara görünmüyor. Sayfayı yenileyin; hâlâ görünmüyorsa destek ekibimize WhatsApp'tan yazın. Ayrıntılı kontrol listesi: Entegrasyon sorunları.
İlgili makaleler
Bu makale sorununuzu çözmedi mi?
Asistana sorun ya da destek ekibimize yazın.