Giriş Yap Başlayın

WhatsApp Kurulum Rehberi

Meta Business API ile WhatsApp hatırlatma sistemini adım adım kürün. Tahmini sure: 15 dakika.

Gereksinimler

  • Bir Facebook hesabı
  • Bir işletme telefon numarası (kişisel WhatsApp'ınızdan farklı olmalı)
  • DevuApp hesabı (buradan oluşturun)
1

Meta Business Hesabı Oluşturun

  1. business.facebook.com adresine gidin
  2. "Hesap Oluştur" butonuna tıklayın
  3. İşletme adınızı, adınızı ve is e-posta adresinizi girin
  4. İşletme bilgilerinizi doğrulayın
Ekran görüntüsü: Meta Business Suite ana ekranı
2

WhatsApp Business Uygulaması Oluşturun

  1. developers.facebook.com adresine gidin
  2. "Uygulamalarım" → "Uygulama Oluştur" seçin
  3. Uygulama turu olarak "Business" seçin
  4. Uygulama adını girin (örn: "Kliniğim WhatsApp")
  5. Meta Business hesabınızı bağlayın
  6. Oluşturulan uygulamada WhatsApp ürününü ekleyin ("Ürün Ekle" → WhatsApp → "Kur")
Ekran görüntüsü: Meta Developer Portal — uygulama oluşturma
3

Telefon Numarası Ekleyin

  1. WhatsApp → Başlangıç (Getting Started) sayfasına gidin
  2. "Telefon Numarası Ekle" butonuna tıklayın
  3. İşletme telefon numaranızı girin
  4. SMS veya arama ile doğrulama kodunu alın
  5. Kodu girin ve numaranızı doğrulayın
Ekran görüntüsü: Telefon numarası ekleme ekranı
4

API Bilgilerini Alın

  1. WhatsApp → API Kurulumu (API Setup) sayfasına gidin
  2. Phone Number ID (Telefon Numarası Kimliği) değerini not edin
  3. WhatsApp Business Account ID değerini not edin

Kalıcı Erişim Anahtarı (Permanent Access Token) oluşturun:

  1. Business Settings → Users → System Users sayfasına gidin
  2. Sistem kullanıcısı oluşturun
  3. Sistem kullanıcısına whatsapp_business_messaging iznini verin
  4. Kalıcı token oluşturun
Ekran görüntüsü: API bilgileri ve token oluşturma
5

DevuApp'ta Yapılandırın

  1. DevuApp'a giriş yapın
  2. Ayarlar → WhatsApp sayfasına gidin
  3. Phone Number ID'yi yapıştırın
  4. WABA ID'yi (WhatsApp Business Account ID) yapıştırın
  5. Access Token'ı yapıştırın
  6. "Etkinleştir" butonunu açın
  7. "Test Mesajı Gönder" ile çalıştığını doğrulayın
Ekran görüntüsü: DevuApp WhatsApp ayarları ekranı
6

Randevu Hatırlatmalarını Ayarlayın

Hatırlatma oluşturmak artık çok kolay — serbest metin yazmak yerine adım adım bir oluşturucu kullanırsınız. Sistem mesajı sizin için oluşturur ve Meta'ya gönderir.

  1. Ayarlar → WhatsApp → Hatırlatmalar bölümüne gidin
  2. "Yeni Hatırlatma" butonuna tıklayın
  3. Zamanlama: Randevudan ne kadar önce gönderileceğini seçin (dakika, saat veya gün)
  4. Dahil edilecek bilgiler: Uzman adı, mekan adı, mekan adresi seçeneklerini işaretleyin
  5. Üslup: Samimi ("Merhaba") veya Resmi ("Sayın") seçin
  6. Dil: Türkçe veya İngilizce seçin
  7. Canlı önizlemede mesajın tam halini kontrol edin
  8. "Oluştur" butonuna tıklayın — şablon onay için Meta'ya gönderilir

Şablon Durumları

Durum Anlamı
Aktif Şablon onaylandı ve yaklaşan randevu hatırlatmaları için kullanılacak.
Hazırlanıyor Meta incelemesi devam ediyor. Genellikle birkaç dakika sürer.
Dikkat Gerekli Meta tarafından reddedildi. "Düzelt" butonuna tıklayın — şablon otomatik düzeltilip yeniden gönderilir.
💡 Not: Otomatik yanıt mesajları (onay, iptal, güncelleme yanıtları) hâlâ serbest metindir ve Meta onayı gerektirmez. Bu mesajlar WhatsApp'ın 24 saatlik oturum penceresi içinde gönderilir.
Ekran görüntüsü: Hatırlatma oluşturucu ve şablon durumları
7

Webhook Kurulumu (İki Yönlü Mesajlaşma)

Webhook, müşterilerinizin WhatsApp yanıtlarının (onay/iptal) otomatik işlenmesini sağlar.

  1. Meta Developer Portal → WhatsApp → Yapılandırma (Configuration) sayfasına gidin
  2. Webhook URL olarak girin: https://devu-backend-57810004994.europe-west1.run.app/api/whatsapp/webhook
  3. Doğrulama Token'ı olarak DevuApp'taki "Webhook Verify Token" değerini girin
  4. Abone olunacak alanlar: messages seçin
  5. "Dogrula ve Kaydet" butonuna tıklayın

✅ Artık müşterileriniz "Evet" veya "İptal" yazdığında randevu durumu otomatik güncellenir.

Ekran görüntüsü: Meta webhook yapılandırma ekranı

Sorun Giderme

Sorun Çözüm
Mesaj gönderilmiyor Token süresinin dolmadığını kontrol edin. Kalıcı token kullandığınızdan emin olun.
Webhook dogrulanamıyor Verify Token'ın DevuApp ayarlarıyla eşleştiğinden emin olun.
"Evet" yazıldıgında onaylanmıyor Webhook'un dogru URL'ye bağlandığını ve messages alanına abone olduğunuzu kontrol edin.
Şablon "Hazırlanıyor" durumunda takılı kaldı Meta onayı genellikle birkaç dakika sürer. Bir saatten uzun sürerse yeni bir hatırlatma oluşturmayı deneyin.
Şablon "Dikkat Gerekli" gösteriyor "Düzelt" butonuna tıklayın. Şablon otomatik olarak düzeltilip Meta'ya yeniden gönderilir.
Hatırlatmalar gönderilmiyor Hatırlatma şablonunun "Aktif" durumda olduğundan emin olun. "Hazırlanıyor" durumundaki şablonlar henüz mesaj gönderemez.