WordPress entegrasyonu

Business Messaging for WbizTool resmi WordPress eklentisidir. Sitenizde bir şey olduğunda bağlı numaranızdan WhatsApp mesajları gönderir: bir WooCommerce siparişi değiştiğinde, bir WP Amelia rezervasyonu yeniden planlandığında veya iptal edildiğinde ya da bir Contact Form 7 formu gönderildiğinde.

Başlamadan önce#

• WhatsApp ayarları sayfasında bağlı bir WhatsApp numarası olan bir Wbiztool hesabı.
• Ayarlar → API anahtarları sayfasından Client ID ve API anahtarınız.
• WhatsApp ayarları sayfasında gösterilen, gönderim yapılacak numaranın WhatsApp Client ID değeri.

Eklentiyi kurun#

1. WordPress'ten kurun

   WordPress yönetim panelinizde Plugins → Add New (Eklentiler → Yeni ekle) bölümüne gidin, Business Messaging for WbizTool araması yapın, Install Now'a (Şimdi kur) ve ardından Activate'e (Etkinleştir) tıklayın. Eklentiyi WordPress eklenti dizininden indirip zip dosyasını Plugins → Add New → Upload Plugin altından da yükleyebilirsiniz. Yükleme başarısız olursa (örneğin bir dosya boyutu sınırı nedeniyle) zip'i açın ve business-messaging-for-wbiztool klasörünü FTP ile /wp-content/plugins/ içine kopyalayın, ardından Plugins altından etkinleştirin.

2. Eklenti ayarlarını açın

   Yönetim kenar çubuğunda dört sayfalı yeni bir WbizTool menüsü görünür: Settings, Templates, Test Messages ve Logs.

Eklentiyi ayarlayın#

1. API kimlik bilgilerinizi girin

   WbizTool → Settings sayfasında API Configuration altında Client ID, API Key ve WhatsApp Client ID alanlarını doldurun, ardından Test Connection'a tıklayın.

   Kimlik bilgileri doğruysa Test Connection, yer tutucu 10000000000 numarasına gerçek bir test mesajını kuyruğa alır; bu mesaj Wbiztool mesaj geçmişinizde görünür. Teslim edilemez ve orada başarısız olarak görünür; bunu yok sayabilirsiniz. Unable to connect to WbizTool API. Please check your internet connection. mesajını görürseniz büyük olasılıkla Client ID'niz, API anahtarınız veya WhatsApp Client ID'niz yanlıştır ya da planınızda mesaj kalmamıştır. Bu mesaj nadiren internet bağlantınızla ilgili bir sorun anlamına gelir.

2. Genel seçenekleri ayarlayın

   General Settings altında:

   • Default Country Code: bir WooCommerce siparişinin fatura ülkesi bir ülke koduyla eşleştirilemediğinde kullanılır. Varsayılan değer 1'dir; bunu ana ülkenize göre değiştirin, örneğin 91.
   • Test Mode: açıkken mesajlar günlüğe yazılır ancak gönderilmez.
   • Admin Notifications: bu onay kutusunun sürüm 1.0.3'te görünür bir etkisi yoktur, çünkü ayarlar sayfasında kullandığı yönetici telefon numarası için bir alan yoktur. Form gönderimlerinde yönetici uyarıları için aşağıdaki Contact Form 7 ayarlarını kullanın.

3. Entegrasyonları ve olayları açın

   Integration Settings altında kullandığınız her eklentiyi etkinleştirin ve mesaj göndermesi gereken olayları işaretleyin. Bir entegrasyon seçeneklerini yalnızca o eklenti sitenizde etkin olduğunda gösterir. Save Settings'e tıklayın.

4. Mesaj şablonlarını düzenleyin

   WbizTool → Templates sayfasında WooCommerce, Amelia veya Contact Form 7 sekmesini seçin, bir olay seçin ve metnini düzenleyin. Sayfa kullanabileceğiniz değişkenleri listeler ve canlı bir önizleme gösterir. Reset varsayılan metni geri yükler.

5. Test gönderin

   Her şeyin çalıştığını doğrulamak için WbizTool → Test Messages sayfasından kendi numaranıza bir mesaj gönderin, ardından WbizTool → Logs sayfasını kontrol edin.

WooCommerce#

Mesajlar siparişin fatura telefonuna gider. Ülke kodu fatura ülkesinden alınır; bu ülke tanınmazsa Default Country Code kullanılır.

Şablon değişkenleri:

Örnek şablon:

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

Mesajlar rezervasyondaki müşteri telefonuna gider. Ayarlar sayfası altı olay listeler:

• Booking Added (Frontend bookings) – rezervasyon eklendi (ön yüz rezervasyonları)
• Booking Rescheduled – rezervasyon yeniden planlandı
• Booking Cancelled – rezervasyon iptal edildi
• Appointment Added (Backend) – randevu eklendi (yönetim paneli)
• Event Booking Saved – etkinlik rezervasyonu kaydedildi
• Event Booking Updated – etkinlik rezervasyonu güncellendi

Amelia şablonlarında kullanılabilen değişkenler:

Contact Form 7#

Bir form gönderildiğinde eklenti size (yöneticiye), formu dolduran kişiye veya her ikisine mesaj gönderebilir.

Eklenti formunuzdaki adı, e-postayı, telefonu ve mesajı alan adına göre bulur. your-name, your-email, your-phone (veya phone, mobile, whatsapp), your-subject ve your-message gibi yaygın adlar kullanın. Müşteri otomatik yanıtı yalnızca bir telefon alanı bulunduğunda gönderilir. Numarayı ülke koduyla isteyin: eklenti yalnızca bazı ülke kodlarını tanır, diğer durumlarda Default Country Code kullanır.

Şablon değişkenleri:

Her form alanı, kısa çizgiler alt çizgiyle değiştirilmiş olarak kendi adıyla da kullanılabilir. Örneğin your-city adlı bir alan {your_city} olur.

Örnek yönetici bildirimi:

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

Ziyaretçinin mesajındaki satır sonları kaldırılır; bu yüzden {message} tek satır olarak gelir.

Günlükler#

WbizTool → Logs, eklentinin göndermeye çalıştığı mesajları tarih, olay türü, entegrasyon, telefon, mesaj ve durumla birlikte listeler. Bir olayın tetiklenip tetiklenmediğini ve mesajın gönderilip gönderilmediğini kontrol etmek için kullanın. Bir mesajın neden başarısız olduğunu göstermez.

Sorun giderme#

Eklentiden gelen PHP hatalarını görmek için wp-config.php içinde WordPress hata ayıklama günlüğünü açın. Hatalar wp-content/debug.log dosyasına yazılır. İşiniz bitince yeniden kapatın.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);