Ana içeriğe geç

Yapılandırma

WhatsApp Cloud API Chat & Marketing modülünü kurup aktifleştirdikten sonra, Perfex CRM ile Meta WhatsApp Cloud API arasındaki bağlantıyı yapılandırmanız gerekir. Bu, bir Meta Uygulaması kurmayı, API kimlik bilgileri oluşturmayı, webhook'ları yapılandırmayı ve modül ayarlarını düzenlemeyi içerir.

Meta Uygulama Yapılandırması​

WhatsApp Cloud API'ye bir Meta (Facebook) Uygulaması aracılığıyla erişilir. Henüz oluşturmadıysanız, şu adımları izleyin.

Adım 1 — Facebook Developers Hesabı Oluşturma​

  1. developers.facebook.com adresine gidin.
  2. Facebook hesabınızla giriş yapın.
  3. İstenirse, koşulları kabul edip hesabınızı doğrulayarak geliştirici olarak kaydolun.

Adım 2 — Meta Uygulaması Oluşturma​

  1. Facebook Developers kontrol panelinde Create App düğmesine tıklayın.
  2. Uygulama türü olarak Business seçin (hesap türünüz için Business mevcut değilse Other seçin).
  3. Bir App Name (ör. "Perfex CRM WhatsApp") ve iletişim e-postanızı girin.
  4. Business Account'unuzu seçin (gerekirse yeni oluşturun).
  5. Create App düğmesine tıklayın.

Adım 3 — Uygulamanıza WhatsApp Ekleme​

  1. Yeni uygulamanızın kontrol panelinde ürün listesinde WhatsApp'ı bulun ve Set Up düğmesine tıklayın.
  2. Bir WhatsApp Business Account bağlamak için rehberli kurulumu izleyin.
  3. Geliştirme için otomatik olarak bir test telefon numarası sağlanır. Kendi doğrulanmış işletme telefon numaranızı daha sonra ekleyebilirsiniz.
bilgi

Test telefon numarası, önceden kayıtlı 5 numaraya kadar mesaj göndermenize olanak tanır. Üretim kullanımı için, WhatsApp Business Account ayarlarında kendi işletme telefon numaranızı ekleyin ve doğrulayın.

Adım 4 — Kalıcı Erişim Token'ı Oluşturma​

Varsayılan geçici token 24 saat sonra süresi dolar. Üretim için kalıcı bir System User token'ı oluşturun:

  1. business.facebook.com adresine gidin ve Business Settings > System Users bölümüne geçin.
  2. Admin erişimli yeni bir System User oluşturun (veya mevcut birini kullanın).
  3. Generate New Token düğmesine tıklayın, WhatsApp uygulamanızı seçin ve şu izinleri verin:
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. Oluşturulan token'ı kopyalayın — bu sizin kalıcı erişim token'ınızdır.
uyarı

Kalıcı token yalnızca bir kez gösterilir. Güvenli bir şekilde saklayın. Kaybederseniz, yeni bir tane oluşturmanız ve modül ayarlarınızı güncellemeniz gerekecektir.

Webhook Yapılandırması​

Webhook'lar, WhatsApp'ın Perfex CRM örneğinize gelen mesajlar, teslim makbuzları ve durum güncellemeleri hakkında gerçek zamanlı bildirim göndermesini sağlar.

Webhook Kurulumu​

  1. Facebook Developers kontrol panelinde uygulamanızın WhatsApp > Configuration sayfasına gidin.
  2. Webhook altında Edit düğmesine tıklayın.
  3. Modül tarafından sağlanan Callback URL'yi girin (Perfex CRM'de WhatsApp Modülü > Ayarlar bölümünde bulunur). Genellikle şu formattadır: 
    https://perfex-alaniniz.com/whatsapp_cloud_api/webhook
  4. Modül ayarlarında görüntülenen Verify Token'ı girin.
  5. Verify and Save düğmesine tıklayın.
  6. Şu webhook alanlarına abone olun:
    • messages
    • message_template_status_update
ipucu

Perfex CRM kurulumunuz geçerli bir SSL sertifikasıyla HTTPS üzerinden sunulmalıdır. Meta, HTTP kullanan veya geçersiz/self-signed sertifikalara sahip webhook URL'lerini reddeder.

Modül Ayarları​

Meta App kurulumunu tamamladıktan sonra modülü Perfex CRM içinde yapılandırın.

  1. Perfex CRM kenar çubuğunda WhatsApp Cloud API modülüne gidin.
  2. Ayarlar bölümüne gidin ve aşağıdakileri girin:
AyarAçıklama
Access TokenYukarıda oluşturulan kalıcı System User token'ı
Phone Number IDMeta Uygulamanızın WhatsApp > Getting Started sayfasında bulunur
WhatsApp Business Account IDMeta Uygulamanızın WhatsApp ayarlarında bulunur
Webhook Verify TokenSizin tanımladığınız özel bir dize — Meta webhook kurulumunda girdiğinizle eşleşmelidir
App IDMeta Uygulamanızın ID'si (uygulama kontrol panelinde bulunur)
  1. Ayarları Kaydet düğmesine tıklayın.
  2. Modülün WhatsApp Cloud API ile iletişim kurabildiğini doğrulamak için Bağlantıyı Test Et düğmesini kullanın.

Gömme Yapılandırması​

Gelişmiş kurulumlar için modül, WhatsApp sohbet widget'ını harici sayfalara veya müşteri portallarına gömmeyi destekler. Bir gömme kodu snippet'i oluşturmak ve widget görünümünü (renkler, konum, karşılama mesajı) özelleştirmek için WhatsApp Modülü > Ayarlar > Gömme bölümüne gidin.

İşletme Doğrulaması​

Tam mesajlaşma kapasitesinin kilidini açmak ve tüm şablon kategorilerine erişmek için Meta İşletme doğrulamanızı tamamlayın:

  1. business.facebook.com > Business Settings > Security Center bölümüne gidin.
  2. Start Verification düğmesine tıklayın ve rehberli süreci izleyin.
  3. Meta'nın istediği işletme belgelerinizi gönderin.
  4. Doğrulama genellikle 2-5 iş günü sürer.
bilgi

İşletme doğrulaması olmadan, mesajlaşmanız 24 saatlik yuvarlanan pencerede 250 benzersiz alıcıyla sınırlıdır. Doğrulamadan sonra, limitler mesaj kalitesi ve hacmine göre kademeli olarak artar.

Sırada Ne Var?​

  • Kullanım Kılavuzu — sohbet arayüzünü kullanmayı, kampanyalar yürütmeyi, botları yapılandırmayı ve şablonları yönetmeyi öğrenin
  • WhatsApp Kayıtları — tüm otomatik etkileşimlerin kapsamlı kayıtlarını görüntüleyin