WhatsApp Business Cloud API'yi AssistFlow'a Bağlama: Adım Adım Rehber

Süre: ~10 dakika · Teknik bilgi: Orta · Maliyet: Test numarası ücretsiz

Bu rehberde Meta for Developers üzerinden bir WhatsApp Business Cloud API uygulaması oluşturacak, AssistFlow ile bağlayacak ve gelen mesajlara AI ile otomatik yanıt vermeyi açacağız. Tüm adımlar canlı olarak Türkiye'den test edildi.

Ön koşullar

• Bir Meta (Facebook) hesabı ve aktif bir Meta Business hesabı
• WhatsApp'a kayıtlı olmayan bir telefon numarası (test için Meta size ücretsiz bir test numarası da verecek)
• AssistFlow hesabı ve Geliştirici paneline erişim (/dashboard/whatsapp-settings)

1. Meta for Developers'da uygulama oluştur

1. developers.facebook.com/apps adresine gidin ve Create App'e tıklayın.
2. Use case olarak "Other", app type olarak "Business" seçin.
3. Uygulama adı (ör. "AssistFlow WhatsApp") ve iletişim e-postanızı girin, ardından Business Account'ınızı seçin.

2. WhatsApp ürününü ekle

1. Uygulama dashboard'ında soldaki menüden "Add product"'a tıklayın ve WhatsApp kartında "Set up"'a basın.
2. Bir Business Portfolio seçin (yoksa "Create one" ile yeni oluşturun).
3. Meta sizin için otomatik olarak bir test telefon numarası ve WhatsApp Business Account (WABA) oluşturacak — bu numara ile geliştirme aşamasında ücretsiz mesaj atabilirsiniz.

3. Phone Number ID, WABA ID ve görüntülenen numarayı al

Sol menüden WhatsApp → API Setup'a girin:

• Phone Number ID — "From" kısmında numaranın altındaki uzun rakam (ör. 527144740475098)
• WhatsApp Business Account ID (WABA ID) — sayfanın üstünde, dropdown'ın yanında
• Görüntülenen telefon numarası — test numarası veya verify ettiğiniz gerçek numara (E.164 formatında, ör. +90 555 724 22 44)
• Onaylı işletme adı — Business Manager'daki firma isminiz

Bu dört değeri bir yere kopyalayın — birazdan AssistFlow'a yapıştıracağız.

4. Kalıcı (Permanent) Access Token üret

API Setup ekranındaki "Temporary access token" sadece 24 saat geçerlidir. Production için Meta Business'ta bir System User oluşturup ona kalıcı token vermeniz gerekir:

1. business.facebook.com → Settings → Users → System Users
2. Add → ad verin (ör. "AssistFlow Token"), rolü Admin yapın.
3. Oluşturulan kullanıcıyı seçin → Add Assets → Apps → AssistFlow uygulamanızı seçin → Manage app izni verin.
4. Aynı kullanıcıya WhatsApp Accounts asset'ini de ekleyin → Manage WhatsApp account izniyle.
5. Generate New Token → uygulamanızı seçin → en az şu izinleri açın:
   • whatsapp_business_management
   • whatsapp_business_messaging
   • business_management
6. "Never expires" seçeneğini açın → Generate → çıkan token'ı güvenli bir yere kopyalayın (Meta bunu tekrar göstermez!).

5. AssistFlow'a bilgileri gir

1. AssistFlow Geliştirici Paneli'ne giriş yapın → WhatsApp AI → WhatsApp Settings.
2. Meta Cloud API Kimlik Bilgileri kartına şunları yapıştırın:
   • Phone Number ID
   • WhatsApp Business Account ID
   • Permanent Access Token
   • Görüntülenen Telefon Numarası
   • Onaylı İşletme Adı
3. Sayfanın altındaki Kaydet butonuna basın. Sistem sizin için otomatik olarak bir Webhook Verify Token üretecek.

6. Webhook'u Meta tarafında bağla

AssistFlow kayıttan sonra Webhook Ayarları kartında size iki değer gösterecek:

Callback URL : https://<proje>.supabase.co/functions/v1/whatsapp-webhook
Verify Token : (otomatik üretildi, "Kopyala"ya bas)

Şimdi Meta Developer Portal'a dön:

1. Sol menüden WhatsApp → Configuration → Webhook bölümüne git.
2. Callback URL ve Verify Token'ı yapıştır → Verify and save.
3. "Webhook fields" listesinde messages field'ını Subscribe et. (İsteğe bağlı: message_template_status_update ve account_update'i de aç.)

7. AI yanıtlarını aç

AssistFlow → WhatsApp Settings → Otomatik Yanıt Ayarları kartı:

• Entegrasyonu Aktif Et → açık
• AI Yanıtları Aktif → açık
• Varsayılan Widget → AI'ın hangi knowledge base + persona ile cevaplayacağını seçin (mevcut chat widget'ınızı seçebilirsiniz).
• Günlük Mesaj Limiti → 1000 (ister daha fazla, ister daha az).
• Mesai Dışı Mesajı → çalışma saatleri dışında otomatik gönderilecek metin.

Tekrar Kaydet'e bas.

8. Test et

1. Test telefon numarasının "Send and receive messages" bölümünden bir mesaj at — kendi WhatsApp'ından numaraya yaz.
2. 30 saniye içinde AI'ın cevabını WhatsApp'ında görmelisin.
3. AssistFlow'da WhatsApp Messages sayfasını aç → mesajın inbound + outbound olarak loglandığını gör.

9. Production'a geç

1. Meta Developer Portal → App Review → Permissions and Features → whatsapp_business_messaging ve whatsapp_business_management için Request Advanced Access.
2. WhatsApp → Phone Numbers → Add phone number → kendi işletme numaranı ekle, SMS/Voice ile verify et.
3. Yeni numaranın Phone Number ID'sini AssistFlow'a güncelle (eski test numarası alanına yapıştır).
4. App Mode'u Live'a al.

Sık karşılaşılan sorunlar

"Webhook verification failed"

Verify Token yanlış kopyalandı veya AssistFlow tarafında henüz kaydetmediniz. Önce Settings'i Kaydet, sonra Meta tarafına yapıştırın.

Mesaj geliyor ama AI yanıt vermiyor

"AI Yanıtları Aktif" kapalı olabilir. Ayrıca "Varsayılan Widget" seçilmemişse AI hangi persona'yı kullanacağını bilmez.

"Re-engagement" / 24 saat penceresi hatası

WhatsApp politikası: Müşteri 24 saat içinde size yazmadıysa sadece onaylı template ile ulaşabilirsiniz. Şablonlar sekmesinden Meta'dan template senkronize edin.

Token süresi doldu

Geçici (24 saatlik) token kullandınız. 4. adımdaki System User flow'uyla kalıcı token üretin.

Sonraki adımlar

• WhatsApp Şablonları: Templates sekmesinden onaylı pazarlama mesajlarınızı senkronize edin.
• WhatsApp Kampanyaları: Lead listesi yükleyip toplu drip kampanya kurun.
• Conversational Analytics: Analytics sekmesinden günlük gönderim, açılma ve aktif sohbet sayılarını izleyin.

Yardım gerekirse support@assistflow.ai'ye yazın — kurulum desteği planınıza dahildir.