Ne işe yarar
Bölüm başlığı “Ne işe yarar”WhatsApp Entegrasyonu ekranı, firmanın Meta (WhatsApp Business Cloud API) hattını KıbrısERP‘a bağlar. Burada telefon numarası kimliğini, erişim jetonunu, doğrulama belirtecini ve uygulama sırrını kaydeder, Meta’ya girilecek geri-arama adresini görür, test mesajı gönderir ve son 50 mesajın günlüğünü izlersiniz. Kurulumdan sonra WhatsApp Sohbet ekranı çalışır.
Kimler kullanır
Bölüm başlığı “Kimler kullanır”Sistem yöneticisi. Ekran yöneticiye veya Yetki Grupları (Roller) › Sayfa Yetkileri altındaki Ayarlar satırında Görüntüle yetkisi olana açılır. Kaydetme ve test gönderimi ayrıca Düzenle/Ekle yetkisi sormaz; ekranı açabilen herkes ayarı değiştirebilir, bu yüzden yetkiyi dar tutun.
Ön koşullar
Bölüm başlığı “Ön koşullar”- Meta tarafında bir WhatsApp Business hesabı, telefon numarası ve uygulama (kurulum Meta panelinde yapılır).
- Üst çubukta aktif firma ve şube seçili olması; ayar firmaya bağlı kaydedilir.
- Sunucuda gizli bilgileri şifreleyen ana anahtarın tanımlı olması; yoksa jeton ve sır kaydedilemez.
- Ekranın “Meta Kurulumu” notu: “Cutover: şablon onayı, uygulama sırrı ve telefon numarası doğrulaması Meta tarafında tamamlanır.”
- Parametreler: Bu ekran yasal oran veya eşik kullanmaz; Parametreler ekranında satır gerekmez.
Adım adım
Bölüm başlığı “Adım adım”-
Ayarlar grubundan WhatsApp Entegrasyonu ekranını açın.
-
Yapılandırma kartını doldurun: Telefon Numarası ID (phone-number-id) (zorunlu), İşletme Hesabı ID (WABA), Erişim Jetonu, Doğrulama Belirteci (verify token) (zorunlu), Uygulama Sırrı (app secret), Varsayılan Ülke Kodu. Etkin kutusunu işaretleyin ve Kaydet deyin; “WhatsApp yapılandırması kaydedildi.” görünür.
-
Jeton ve uygulama sırrı yalnız yazılır: kayıtlıysa alanda ”••• kayıtlı” görünür, değer bir daha gösterilmez. Değiştirmek için yeni değeri girin, boş bırakırsanız mevcut değer korunur. Uygulama sırrını silmek için alana tek tire (-) girin.
-
Meta Kurulumu kartından Geri-Arama URL ve Doğrulama Belirteci değerlerini kopyalayıp Meta uygulama panelinde webhook ayarına girin.
-
Test Mesajı Gönder kartında Alıcı Telefon ve Mesaj girip Test mesajı gönder deyin. Başarılıysa “Test mesajı gönderildi.”; değilse “Gönderim başarısız: …” ve hata ayrıntısı görünür.
-
Mesaj Günlüğü tablosunda son 50 mesajı (Zaman, Yön: Gelen/Giden, Durum, Numara, İçerik; hata varsa altında hata metni) izleyin. Boşken “Kayıt yok.” yazar. Yenile düğmesi listeyi tazeler.
Alanlar
Bölüm başlığı “Alanlar”| Alan | Anlamı | Zorunlu mu |
|---|---|---|
| Telefon Numarası ID (phone-number-id) | Meta’daki gönderici numara kimliği; gelen mesajlar bu kimlikle firmaya eşlenir | Evet |
| İşletme Hesabı ID (WABA) | WhatsApp Business hesap kimliği | Hayır |
| Erişim Jetonu | Meta API erişim jetonu; şifreli saklanır, yalnız yazılır | Gönderim için evet |
| Doğrulama Belirteci (verify token) | Meta’nın webhook doğrulamasında karşılaştırdığı gizli metin | Evet |
| Uygulama Sırrı (app secret) | Gelen mesajların imzasını doğrular (X-Hub-Signature-256). Tanımlı değilse gelen mesajlar reddedilir | Gelen mesaj için evet |
| Varsayılan Ülke Kodu | Yerel (0 ile başlayan veya kısa) numaralara eklenecek uluslararası ülke kodu | Hayır |
| Etkin | İşaretli değilse gönderim yapılmaz, gelen mesajlar sessizce atlanır | Evet |
| Geri-Arama URL | Meta’ya girilecek webhook adresi; salt okunur | Gösterilir |
Sık hatalar ve mesajları
Bölüm başlığı “Sık hatalar ve mesajları”| Ekranda gördüğünüz mesaj | Anlamı / ne yapmalı |
|---|---|
| “Aktif firma yok — WhatsApp ayarı bir firmaya bağlı olmalı.” | Üst çubuktan firma seçin. |
| “Aktif şube çözülemedi (şube damgası zorunlu).” | Firmanın en az bir şubesi ve erişim kapsamınızda şube olmalı. |
| “Phone-number-id zorunlu.” | Telefon Numarası ID alanını doldurun. |
| “Doğrulama belirteci (verify token) zorunlu.” | Doğrulama Belirteci alanını doldurun. |
| “Sır koruma yapılandırılmadı (…). Jeton/sır şifrelenemez.” | Sunucuda ana şifreleme anahtarı tanımlı değil; yöneticinize/destek ekibine başvurun. |
| “Test için alıcı telefon numarası girin.” | Alıcı Telefon boş. |
| “Gönderim başarısız: …” | Meta isteği reddetti veya jeton/ayar eksik; hata metnini günlükte okuyun. |
| “WhatsApp erişim jetonu yapılandırılmadı.” | Erişim Jetonu girilmemiş. |
| Erişim yok uyarısı (ekran açılmaz) | Ayarlar için Görüntüle yetkiniz yok ve yönetici değilsiniz. |
Doğrulama isteğini ve gelen mesajları Meta kendi sunucularından bu adrese gönderdiği için Geri-Arama URL’nin internetten erişilebilir olması gerekir. KıbrısERP yalnız gelen mesaj (messages) bildirimlerini işler; teslim ve okundu durum bildirimleri işlenmez. Meta panelindeki abonelik adımlarının ayrıntısı Meta’nın kendi belgelerindedir.