Panele Giriş Yapın

Newmore WhatsApp API Entegrasyon Kılavuzu

WhatsApp Business API, spam’i önlemek için katı kurallara sahiptir. Sistem iki farklı modda çalışır.

Durum Açıklama Gönderilebilecek Mesaj Tipi
🟢 Pencere AÇIK Müşteri size mesaj attığında başlar ve 24 saat sürer. Serbest Metin: Özgürce yazı, resim, video gönderebilirsiniz.
🔴 Pencere KAPALI Son mesajın üzerinden 24 saat geçmiştir. Sadece Şablon Mesaj: Sadece Meta tarafından onaylanmış şablonlar gönderilebilir.

Önemli: Müşteri size son 24 saat içinde yazmadıysa, “Naber?” gibi serbest bir mesaj gönderemezsiniz. İletişimi başlatmak için mutlaka Şablon Mesaj kullanmalısınız.

API istekleri yapabilmek için Geliştirici Konsolu üzerinden erişim anahtarınızı almanız gerekir.

  • API Base URL: https://wp.newmore.com.tr/wp-json/wpws/v1
  • Header (Başlık): x_wpws_verify_token

Tüm isteklerde x_wpws_verify_token başlığı ile API anahtarınızı göndermelisiniz.

Bu yöntem sadece müşteri size son 24 saat içinde mesaj attıysa (oturum açıksa) çalışır.

Başlık: Serbest Metin Mesajı (Text)
Açıklama: Müşteri ile aktif bir sohbetiniz varsa, onaylı şablona gerek kalmadan bu kodu kullanabilirsiniz. 
<?php
// API BİLGİLERİ
$apiUrl   = 'https://wp.newmore.com.tr/wp-json/wpws/v1/send';
$apiToken = 'SIZIN_API_ANAHTARINIZ'; 
$phone    = '905551234567';

// GÖNDERİLECEK VERİ (TEXT)
$data = [
    'x_wpws_verify_token' => $apiToken,
    'phone'                => $phone,
    'type'                 => 'text',
    'message'              => 'Merhaba, bu bir test mesajıdır. 🚀',
];

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'x_wpws_verify_token: ' . $apiToken
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Bu yöntem 24 saat kuralına takılmaz. Müşteriye ilk mesajı atarken bunu kullanmalısınız.

<?php
$apiUrl   = 'https://wp.newmore.com.tr/wp-json/wpws/v1/send';
$apiToken = 'SIZIN_API_ANAHTARINIZ';
$phone    = '905551234567';

$data = [
    'x_wpws_verify_token' => $apiToken,
    'phone'                => $phone,
    'type'                 => 'template',
    'template_name'        => 'hello_world', 
    'language'             => 'en_US',
    'components'           => [
        [
            'type' => 'BODY',
            'parameters' => [
                ['type' => 'text', 'text' => 'Sayın Müşteri'] 
            ]
        ]
    ]
];

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json', 'x_wpws_verify_token: ' . $apiToken]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);
curl_close($ch);
?>

Şablonlarınızın onaylanması için şunlara dikkat edin:

  • Tehditkar Dil Yasak: “Dava açarız” gibi ifadeler kullanmayın.
  • Hatalı Değişken: {{1}} işareti bir bağlam içinde olmalıdır.
  • İmla: Yazım hataları reddedilme sebebidir.

WhatsApp hattınıza gelen mesajları anlık olarak kendi sunucunuza aktarabilirsiniz.

Adım 1: Webhook URL’nizi Belirleyin

Kendi sunucunuzda bir adres hazırlayın (Örn: https://site.com/webhook).

Adım 2: Panele Kaydedin

NewMore Geliştirici Konsolu’na giderek adresinizi kaydedin.

Adım 3: Test Edin

Swagger sayfasından /webhook-test endpoint’ini kullanarak test verisi gönderin.