WHMCS Core WhatsApp Modülü
Meta WhatsApp Cloud API üzerinden onaylı şablonlarla WHMCS bildirimleri gönderir.
Ön koşullar
- WHMCS 8.x/9.x desteklenen sürüm
- PHP 7.4+
- Meta Business/WhatsApp Business hesabı
- Phone Number ID
- Kalıcı erişim token'ı
- Onaylı mesaj şablonları
- PHP cURL
Kurulum adımları
-
1
Yedek ve ön kontrol
WHMCS dosyaları ile veritabanını yedekleyin; işlemi önce staging ortamında uygulayın.
-
2
Dosyaları yükleyin
Paket dizin yapısını bozmadan şu hedeflere yükleyin: modules/addons/CoreWhatsApp/
-
3
İzinleri doğrulayın
Klasörleri normalde 750/755, dosyaları 640/644 tutun; web sunucusu sahibini doğru ayarlayın ve 777 kullanmayın.
-
4
Modülü etkinleştirin
WHMCS > Sistem Ayarları > Eklenti Modülleri bölümünde modülü etkinleştirin ve gerekli yönetici rollerine erişim verin.
-
5
İlk yapılandırmayı kaydedin
Aşağıdaki modüle özel alanları doldurun; test tamamlanmadan canlı ortam/kimlik bilgilerine geçmeyin.
Yapılandırma
Cloud API
Güncel Graph API sürümünü, Phone Number ID ve token'ı ekleyin; temel adresi sağlayıcının güncel dokümanından alın.
Şablonlar
24 saat penceresi dışındaki bildirimler için Meta onaylı şablon ve dil kodlarını eşleyin.
Testler
- E.164 biçimli test numarasına onaylı şablon gönderin.
- Webhook durumlarını ve başarısız teslimat kaydını kontrol edin.
- Sabit +90 eklenmediğini, ülke kodunun numaradan/config'den geldiğini doğrulayın.
Güvenlik
- Eski api.whatsapp.com/v1/messages adresini kullanmayın; Graph API `{sürüm}/{phone-number-id}/messages` yolunu kullanın.
- Token'ı loglarda ve tarayıcı kodunda göstermeyin.
Sorun giderme
Mesaj gönderilemiyor
Token süresi/yetkisi, Phone Number ID, şablon adı/dili ve alıcı E.164 formatını kontrol edin.