// bölüm 04

WhatsApp Business aktivasyonu

Misafir doğrulama mesajları kendi WhatsApp numaranızdan gitsin — misafir işletmenizin adını görsün, kontör düşmesin. Meta tarafındaki adımlar dâhil, sıfırdan sonuna.

Bağlamak zorunlu mu?

Hayır. İki çalışma biçimi vardır:

Platform hesabı (varsayılan)Kendi hesabınız
KurulumYok — hemen çalışırMeta tarafında ~30 dk
Misafir kimden mesaj alırWiPoint numarasıSizin işletme numaranız
MaliyetMesaj başına 1 WhatsApp kontörüKontör düşmez; Meta ile aranızda
Şablon yönetimiWiPoint yönetirSiz yönetirsiniz (portal üzerinden)
Önerimiz: ilk günlerde platform hesabıyla başlayın (hemen çalışır), işletme akışınız oturunca kendi hesabınıza geçin. Geçiş sırasında misafir tarafında kesinti olmaz.

Başlamadan önce elinizde olması gerekenler

  • Meta Business hesabı — business.facebook.com. Yoksa ücretsiz açılır.
  • WhatsApp'a kayıtlı OLMAYAN bir telefon numarası. Bu en sık takılınan noktadır: kullanacağınız numara normal WhatsApp ya da WhatsApp Business uygulamasında kayıtlı olmamalı. Kayıtlıysa önce uygulamadan silmeniz gerekir (sohbet geçmişi kaybolur). Sabit hat numarası da kullanılabilir; doğrulama araması ile yapılır.
  • İşletme doğrulaması (Business Verification) — test için şart değil, ama günlük gönderim limitini yükseltmek ve numaranızda işletme adını göstermek için gerekir. Vergi levhası / ticaret sicil belgesi istenir.

1 · Meta Business hesabı ve WABA oluşturun

  1. business.facebook.com adresine girip işletme hesabınızı açın (varsa mevcut hesabı kullanın).
  2. Ayarlar > Hesaplar > WhatsApp Hesapları yolundan yeni bir WhatsApp Business Account (WABA) oluşturun.
  3. Meta sizden bir uygulama (app) oluşturmanızı isteyebilir: developers.facebook.com > My Apps > Create App > Business. Ürünlerden WhatsApp'ı ekleyin.

2 · Numaranızı ekleyip doğrulayın

  1. WhatsApp ürünü altında “Add phone number” deyin.
  2. İşletme adınızı (misafirin göreceği ad) ve numaranızı girin.
  3. SMS ya da arama ile gelen kodu girin. Numara doğrulandığında listede görünür.
“Bu numara zaten kullanımda” hatası alıyorsanız numara hâlâ WhatsApp uygulamasında kayıtlıdır. Telefonda WhatsApp > Ayarlar > Hesap > Hesabımı sil adımını uygulayın, 5-10 dakika bekleyip tekrar deneyin.

3 · Üç bilgiyi kopyalayın

WiPoint'in ihtiyacı olan tek şey şu üç değer:

BilgiNeredeNasıl görünür
phone_number_idWhatsApp > API Setup ekranı, numaranın altında15-16 haneli sayı
WABA IDAynı ekranda “WhatsApp Business Account ID”15-16 haneli sayı
Kalıcı erişim token'ıBusiness Ayarlar > Sistem KullanıcılarıEAA… ile başlayan uzun metin

Kalıcı token nasıl alınır:

  1. Business Ayarlar > Kullanıcılar > Sistem Kullanıcıları → Ekle → rolü Yönetici seçin.
  2. Oluşan kullanıcıda “Varlık Ekle” ile WABA'nızı ve uygulamanızı atayın; tam yetki verin.
  3. “Token Oluştur” deyin; izin olarak whatsapp_business_messaging ve whatsapp_business_management seçin. Süre: Never (süresiz).
  4. Token yalnız bir kez gösterilir — kopyalayın.
Token bir paroladır. E-posta/WhatsApp ile paylaşmayın. WiPoint token'ı şifreli saklar ve panelde bir daha açık metin olarak göstermez. Kaybederseniz Meta'dan yenisini üretip portalda güncellersiniz.

4 · WiPoint'e bağlayın ve test edin

whatsapp sekmesi

WhatsApp sekmesi: numara bağlama alanları ve bağlantı durumu.
Meta Business hesabınızdan aldığınız üç bilgiyi buraya girip bağlantıyı kurarsınız.
  1. Portalda Hotspot Yönetimi > WhatsApp sekmesini açın.
  2. “Kendi WhatsApp Business hesabınız” kartındaki üç alana kopyaladığınız değerleri yapıştırın ve “Hesabı bağla” deyin.
  3. Kartın sağ üstündeki rozet “Platform hesabından” yerine “Kendi hesabınız bağlı” olur.
  4. Test mesajı gönder bölümünden kendi cep numaranızı yazıp Test gönder deyin. Örnek değerlerle gerçek bir mesaj gider ve kontör düşmez.

whatsapp sekmesi › test gönderimi

WhatsApp bağlantısını doğrulamak için kullanılan test gönderimi düğmesi.
Bağladıktan sonra kendi numaranıza bir test mesajı gönderin — kurulumu canlıya almadan doğrulayın.
Test mesajı gelmezse önce “Şablonsuz (yalnız 24 saat penceresi)” seçeneğini denediğinizden emin olun: bu seçenek yalnız size son 24 saatte WhatsApp'tan yazdıysanız ulaşır. Ulaşmıyorsa numaranızdan WhatsApp'a bir mesaj yazın, sonra tekrar test edin — ya da onaylı bir şablon seçerek gönderin.

whatsapp sekmesi › telefon görünümü

Aynı ekranın telefon görünümü; sol menü kapalı, içerik tek sütun.
Telefonda aynı ekran.

5 · Onaylı mesaj şablonlarını eşleyin

WhatsApp, misafir size son 24 saatte yazmadıysa serbest metni engeller. Bu yüzden her olay için Meta'da onaylı bir şablon tanımlayıp portalda eşlemeniz gerekir. Portal, hangi olayların şablon beklediğini listeler:

whatsapp sekmesi › şablon eşleştirme

Onaylı WhatsApp mesaj şablonlarının WiPoint bildirimleriyle eşleştirildiği ekran.
Meta'da onaylattığınız şablonu doğrulama kodu mesajıyla eşleyin; eşleşmeyen şablon gönderilemez.
OlayNe zaman giderŞablon alanları
Yönetici onaylı giriş — onay linki Ziyaretçi giriş talebi yaptığında, onay yetkilisine {approver} {guest} {department} {hours} {phone} {email} {note} {url} {expires}
Misafir girişi — doğrulama kodu (OTP) Misafir telefon/kimlik ile giriş yaptığında {code} {minutes}
Panel kaydı — telefon doğrulama kodu Yeni müşteri kaydında {code}

Şablon oluşturma: portaldaki “Bu olay için şablon oluştur” düğmesi sizi doğru alanlarla hazır bir şablona götürür; Meta'ya gönderdikten sonra “Meta'dan senkronla” ile onay durumunu çekersiniz. Onaylanan şablonu ilgili olaya eşleyin — rozet “onaylı şablon bağlı — mesaj gönderilebilir” olur.

Şablon kategorisi doğru seçilmeli

  • Authentication — doğrulama kodları için. En hızlı onaylanan kategori.
  • Utility — onay linki, işlem bildirimi gibi hizmet mesajları.
  • Marketing — kampanya. Doğrulama akışında kullanmayın; hem reddedilir hem de İYS kapsamına girer.
En sık ret sebebi: doğrulama şablonunu pazarlama diliyle yazmak (“Kampanyalarımızdan haberdar olun” gibi cümleler). Şablon yalnız işlevi anlatmalı: “Doğrulama kodunuz: {{1}}. Kod {{2}} dakika geçerlidir.”

24 saat penceresi nedir?

WhatsApp'ta bir kullanıcıya serbest metin gönderebilmeniz için o kullanıcının size son 24 saat içinde yazmış olması gerekir. Bu pencere dışındaki her mesaj onaylı şablonla gitmek zorundadır. WiPoint bunu sizin yerinize yönetir: şablon eşliyse şablonla gönderir, eşli değilse o olayda WhatsApp mesajı göndermez ve panelde uyarı gösterir (onay linkleri bu durumda e-postaya düşer).

Kontör ve otomatik SMS'e dönüş

Platform hesabıyla çalışıyorsanız her WhatsApp mesajı 1 kontör düşer. Kontör bittiğinde:

whatsapp sekmesi › kontör

WhatsApp kontör kartı: kalan kontör sayısı ve kontör alma bağlantısı.
Kontör bittiğinde WhatsApp otomatik kapanır ve doğrulama SMS'e döner; kesinti olmaz.
  1. WhatsApp gönderimi otomatik kapanır — misafir doğrulama kodsuz kalmaz.
  2. Kodlar SMS ile gitmeye devam eder (SMS kontörünüz varsa).
  3. Panelde “WhatsApp kontörünüz bittiği için gönderim otomatik kapatıldı” uyarısı ve “WhatsApp'ı yeniden aç” düğmesi görünür.
  4. Kontör yükledikten sonra bu düğmeyle kanalı geri açarsınız.

Kontör satın alma: Abonelik > Kontör.

abonelik sekmesi › mesajlaşma hizmetim

Abonelik ekranındaki mesajlaşma hizmeti kartı: SMS ve WhatsApp kontörü, doğrulama şablonu durumu.
SMS ve WhatsApp kontörünüzü abonelik ekranından da izleyebilir, buradan kontör alabilirsiniz.

Sorun giderme

BelirtiSebepÇözüm
“Şablon yönetimi için WABA ID ve erişim token'ı bulunmalıdır”Hesap bağlanmamış ya da eksik bilgiÜç alanı da doldurup hesabı yeniden bağlayın
Test mesajı gitmiyor, hata: 131030Numara Meta'nın izin listesinde değil (test aşaması)Meta panelinde alıcı numarayı test numaraları listesine ekleyin ya da işletme doğrulamasını tamamlayın
Hata: 132000 / 132001Şablon bulunamadı ya da dil eşleşmediPortalda şablonu “Meta'dan senkronla” ile tazeleyin; şablonun dilini misafir diliyle eşleyin
Hata: 190 (token)Token süresi dolmuş ya da iptal edilmişMeta'da yeni kalıcı token üretip portalda güncelleyin
Mesaj gidiyor ama misafire ulaşmıyorNumara WhatsApp kullanmıyorDoğrulama kanalını SMS'e alın — portal bunu kendi de yapar
Günlük gönderim limitine takıldımİşletme doğrulaması yokMeta'da Business Verification tamamlayın (limit 250 → 1.000 → sınırsız kademeli açılır)

Sık sorulanlar

Aynı numarayı hem WhatsApp Business uygulamasında hem API'de kullanabilir miyim?

Hayır. Meta bir numaranın aynı anda yalnız birinde olmasına izin verir. API'ye taşıdığınızda telefondaki uygulamadan çıkmanız gerekir.

Birden fazla şubem var, hepsi aynı numarayı kullanabilir mi?

Evet. WhatsApp hesabı düğüm bazında tanımlanır ve alt düğümler üst firmanın hesabını miras alır. İsterseniz her şubeye ayrı numara da bağlayabilirsiniz.

Misafirin telefon numarasını Meta ile paylaşıyor muyuz?

Mesaj gönderebilmek için numara Meta'ya iletilir — bu WhatsApp'ın çalışma biçimidir. KVKK aydınlatma metninizde bu aktarım belirtilmelidir; WiPoint'in hazır metinlerinde ilgili madde bulunur.

Şablon onaylandı ama hâlâ “şablon bağlı değil” yazıyor.

Onaylanan şablonu portalda ilgili olaya eşlemeniz gerekir. “Meta'dan senkronla” dedikten sonra şablonu listeden seçip kaydedin.

Kendi hesabımı bağladıktan sonra kontörüm ne olur?

Kalan kontörünüz durur ve yalnız platform hesabına döndüğünüzde ya da SMS için kullanılır. Kontörün son kullanma tarihi yoktur.

WhatsApp yerine yalnız SMS kullanabilir miyim?

Evet. Gönderim yöntemini “Yalnız SMS” seçmeniz yeterli. SMS bölümüne bakın.

Sıradaki bölüm: SMS operatörü →