Genel Bakış
WhatsApp Business entegrasyonunu kullanabilmek için öncelikle Meta WhatsApp Business hesabınızı platforma bağlamanız gerekir. Bağlantı, Facebook Embedded Signup akışı üzerinden gerçekleştirilir.Ön Koşullar
- Enterprise plan aktif olmalı (
whatsapp_messaging_channelyetkisi) - Meta Business Manager hesabı
- Facebook Embedded Signup’ı tamamlayabilecek yetkili bir Meta kullanıcısı
Hesap bağlama işlemi sırasında platform, Meta App ID ve yapılandırma bilgilerini otomatik olarak sağlar. Sizin ayrıca API anahtarı girmenize gerek yoktur.
Hesap Bağlama Adımları
1
WhatsApp Sayfasına Gidin
Sol menüden WhatsApp bölümüne gidin veya Ayarlar > WhatsApp sayfasını açın
2
Bağlantı Niyeti Oluşturun
WhatsApp Hesabı Bağla butonuna tıklayın. Platform otomatik olarak bir bağlantı niyeti (connection intent) oluşturur ve Meta App ID ile yapılandırma bilgilerini hazırlar
3
Facebook Oturum Açınız
Açılan pencerede Facebook hesabınızla oturum açın. Bu hesap, Meta Business Manager’da yetkili olmalıdır
4
İşletme Hesabınızı Seçin
Meta Business Manager’daki işletme hesabınızı seçin veya yeni bir WhatsApp Business Hesabı (WABA) oluşturun
5
Telefon Numarasını Kaydedin
WhatsApp için kullanacağınız telefon numarasını seçin veya yeni bir numara ekleyin
6
İzinleri Onaylayın
Platform’un WhatsApp Business hesabınıza erişim izinlerini onaylayın. Bu izinler mesaj gönderme, şablon yönetimi ve webhook abone olma yetkilerini içerir
7
Kurulumu Tamamlayın
Bağlantı tamamlandığında platform otomatik olarak:
- Erişim anahtarını (access token) alır
- Webhook aboneliğini oluşturur
- Telefon numarasını kaydeder
- Sağlık kontrolünü başlatır
Hesap Durumları
Bağlantı süreci sırasında hesabınız aşağıdaki durumlardan geçer:Normal Akış
Hata Akışı
setup_failed durumundaki hesaplar için platform otomatik olarak yeniden deneme yapar. Sorun devam ederse Sorun Giderme bölümüne bakın.Onboarding Türleri
Platform iki farklı onboarding türünü destekler:Tam Onboarding (Full)
Yeni bir WhatsApp Business Hesabı oluşturarak sıfırdan başlama. Tüm yapılandırma platform üzerinden yapılır.Birlikte Kullanım (Coexistence)
Mevcut bir WhatsApp Business Hesabını platforma bağlarken, diğer uygulamalarla birlikte çalışma. Bu modda:- Mevcut konuşma geçmişi senkronize edilebilir
- Diğer uygulamalardan gelen mesajlar da alınır (SMB echo)
- Durum senkronizasyonu otomatik olarak yapılır
Hesap Bilgileri
Bağlantı tamamlandıktan sonra aşağıdaki bilgilere erişebilirsiniz:Hesap Bağlantısını Kesme
1
WhatsApp Hesap Sayfasına Gidin
Ayarlar > WhatsApp bölümünde bağlı hesabınızı seçin
2
Bağlantı Kes Butonuna Tıklayın
Hesap detay sayfasında Bağlantı Kes butonuna tıklayın
3
Onaylayın
Açılan onay penceresinde işlemi teyit edin. Platform:
- Webhook aboneliğini iptal eder
- Sistem kullanıcısını siler
- Tüm aktif oturumları kapatır
- Erişim anahtarını geçersiz kılar
Çoklu Hesap Yönetimi
Bir organizasyon birden fazla WhatsApp Business hesabı bağlayabilir. Her hesap farklı bir telefon numarası ve WABA ile ilişkilendirilir. Kullanım senaryoları:- Farklı departmanlar için ayrı WhatsApp numaraları
- Farklı ülkeler için yerel numaralar
- Test ve üretim ortamları için ayrı hesaplar
Sonraki Adımlar
Telefon Numarası Sağlığı
Bağlı numaranızın sağlık durumunu izleyin
Mesaj Şablonları
Şablon mesajları yönetin
Ajan Yapılandırması
AI Agent’ınızı WhatsApp kanalına bağlayın
Sorun Giderme
Bağlantı sorunları için çözümler