WhatsApp Business API

MaviBot builder ayrıca resmi WhatsApp Business API'yi de destekler.

WhatsApp Business nasıl bağlanır

WhatsApp Business API'yi (WABA) projenize bağlamak için Messengers bölümüne gidin ve WhatsApp Business API'yi seçin.

WhatsApp Business API'yi bağlama

Açılan pencerede Facebook hesabınızla giriş yapın. Ardından "Facebook ile Bağlan" düğmesine tıklayın.

Gerekirse devam etmek için Facebook şifrenizi girin.

Kurulum artık tamamlandı. Telefonunuzu her zaman açık tutmanıza gerek yok; bot istikrarlı ve bağımsız bir şekilde çalışacaktır.

WhatsApp Business API için mesaj şablonları

WhatsApp Business API kullanırken, kullanıcılar gri WhatsApp'a benzer şekilde, 24 saatlik müşteri hizmeti penceresi dışında, bot oluştururken günün her saati müşterilere yazamaz ve sınırsız mesaj gönderemez.

24 saatlik pencerenin dışında yalnızca WhatsApp mesaj şablonları (veya WhatsApp şablon mesajları) kullanılabilir; bu süre içinde seçilen kategori dahilinde iletişim ücretsiz olarak gerçekleşir.

Bu işlevsellik WhatsApp'ta, belirli bir zaman aralığında izin verilen mesaj sayısını sınırlayarak ve şablonlara bir kategori atayarak spam gönderimlerini önlemek için kullanılır.

Meta tarafından WhatsApp Business API için aşağıdaki mesaj kategorileri yüklenmiştir:

1. Faydalı şablonlar (işlemler, faturalar, ödemeler vb. hakkında belirli bilgiler içerir);

2. Pazarlama şablonları (şirket, kuruluş, stratejiler, reklam ve tanıtım hakkında bilgi);

3. Doğrulama ve kimlik doğrulama şablonları.

WABA için oluşturulan şablonlar denetlenmektedir.

Şablon reddinin ana nedenleri

Önemli sayıda şablon, birkaç nedenden dolayı WhatsApp denetiminden geçemiyor:

Aşırı reklam: WhatsApp Business, reklam ve tanıtım içeriğiyle aşırı yüklü şablonları reddeder. Moderatörler veya platformun yapay zekası, reklamın temel mesajı gölgelediğini belirlerse şablon engellenir.
Ürün Politikası ihlali: narkotik, psikotrop maddeler, alkol, tütün, samimi hizmetler veya insan onurunu zedeleyici olarak değerlendirilen herhangi bir içerik gibi yasaklı öğeleri tanıtan şablonlar reddedilir.
Belirsizlik, eksiklik veya yanlışlık: WhatsApp moderatörleri herhangi bir gizli alt metin, yanıltıcı bilgi veya şirketiniz veya hizmetiniz hakkında net ayrıntıların eksikliğini tespit ederse şablon onaylanmaz.
Gizli bilgilerin toplanması: hassas kullanıcı verilerini (ör. pasaport numaraları, banka kartı bilgileri, kişisel kimlik numaraları, ev adresleri) toplamak için tasarlanmış şablonlar denetimden geçemez.
Rahatsız edici içerik: ırk, milliyet, cinsiyet, kimlik veya diğer kriterlere dayalı olarak kullanıcıları rahatsız edebilecek bilgiler içeren herhangi bir mesaj reddedilir.
Takdire bağlı ret: WhatsApp moderatörleri, belirli bir neden belirtmeden şablonları reddetme hakkını saklı tutar.

Mesaj şablonları nasıl kurulur

Şablonlar bloklardan oluşturulduğundan, bir WhatsApp Business API şablonu için kullanmadan önce akışınızda önce bir blok oluşturmalısınız.

Maliyet ve ilk mesaj: Şablon mesajları göndermek, 24 saatlik konuşma penceresi içinde ücretsizdir. Bir müşteriye ilk mesaj yalnızca Meta (Facebook) tarafından onaylanmış bir şablon olabilir.
24 saat sonra: Sohbet açıldıktan sonra 24 saat geçtikten sonra, kullanıcıyı yeniden etkileşime geçirmek için yalnızca onaylanmış başka bir şablon gönderebilirsiniz.
Denetim notu: Şablonlar, değişkenler içeriyorsa (Kiril veya Latin alfabesiyle) denetimden geçemeyebilir.

MaviBot'ta şablon oluşturma

Kanallar bölümüne gidin, WhatsApp Business API'yi seçin ve ardından Mesaj şablonları'nı seçin.

"Şablon oluştur" düğmesine tıklayın. Bu, şablon oluşturma sayfasını açar.
Şablonlar, akışınızdaki bloklara bağlıdır. Varsayılan olarak, şablon içeriği bloktan alınır, ancak özel metin ve düğmeler belirtebilirsiniz.

Mesaj şablonu, oluşturulduktan sonra denetime gönderilecektir. Yalnızca onaylanmış şablonları kullanabilirsiniz. Denetim genellikle yaklaşık 8 saat sürer, maksimum 48 saattir.

Şablon türleri

Seçebileceğiniz 3 tür şablon vardır.

PAZARLAMA şablonuna aşağıdaki biçimlerde bir görsel ekleyebilirsiniz: SVG, PNG, JPG ve GIF.

Şablonlarda değişkenler nasıl iletilir

Şablonlardaki değişkenler, WhatsApp'ın yerel biçimine göre değil, MaviBot genelinde olduğu gibi işlenir.

Sistemimiz MaviBot değişkenlerine uyarlanmıştır ve {{1}} biçimindeki değişkenleri desteklemez

WhatsApp şablon mesajlarında değişkenleri kullanma

Mesaj şablonlarında değişken kullanmanız gerekiyorsa şu kurala uyun: değişken adlarını her zaman yalnızca Latin harfleriyle yazın, örneğin #{example}. Gönderdikten sonra, değişkenlerin doğru işlendiğini sağlanan bağlantı üzerinden mesajı kontrol ederek doğrulayın.

Bir şablon bir değişken içeriyorsa, ancak bot ona bir değer atamazsa veya değer eksikse, mesaj gönderilmez!

Şablonlarda düğmeler nasıl çalışır

Mesaj şablonları düğmeleri destekler. MaviBot'ta düğmeler, Facebook API sözdizimine benzer şekilde ayarlanır. Onunla bağlantı üzerinden tanışabilirsiniz:

Düğmeler JSON dizisi biçiminde ayarlanır.

Düğme oluşturma parametreleri:

Parametre	Gerekli	Açıklama
type	Evet	Değerler: PHONE_NUMBER, URL ve QUICK_REPLY
text	Evet	Düğme metni
url	Hayır	Düğmeye tıklandığında açılacak URL. Dinamik bağlantılar oluşturmak için değişkenler kullanabilirsiniz.
phone_number	Hayır	Düğmeye basıldığında aramanın yapılacağı telefon numarası
example	Hayır	Şablonunuz için olası verilere bir örnek sağlar. Bu, hangi mesajı göndermeyi planladığınızı anlamanız için inceleme ve onay sürecine yardımcı olur. Bunların örnek olduğundan ve gizli veya kişisel bilgi içermediğinden emin olun.

Örneğin: İki düğmeli mesaj: [{"type":"QUICK_REPLY", "text": "Evet, uygun"}, {"type":"QUICK_REPLY", "text": "Uygun değil"}]

Şablonlarda düğme özellikleri

Şablon mesajlarında iki tür düğme bulunur:

Eyleme Çağrı (CTA): Bir bağlantı veya telefon numarası için düğme (metninin yanında bağlantı veya ahize simgesiyle görüntülenir).
Hızlı Yanıt: 20 karakter sınırı olan standart metin düğmeleri.

Sınırlamalar:

Tek bir şablon en fazla 3 Hızlı Yanıt düğmesi ve en fazla 2 Eyleme Çağrı düğmesi içerebilir. Ancak, aynı anda iki bağlantı veya iki telefon numarası kullanamazsınız.
Düğmeler değişkenler, satır sonları, emojiler veya biçimlendirme sembolleri içeremez.

Davranış:

Bir Hızlı Yanıt düğmesine tıklamak, metnini kullanıcıdan bir yanıt mesajı olarak gönderir.
Bir Eyleme Çağrı düğmesi bir dosyaya bağlantı açabilir.
Telefon araması için bir Eyleme Çağrı düğmesine tıklamak standart arama uygulamasını açar. WhatsApp Web'de, masaüstü sürümünden arama yapılamayacağını belirten bir bildirim görünecektir.

Şablon denetimi nasıl çalışır

Her şablon, oluşturulduktan hemen sonra denetime gönderilir. Süreç genellikle yaklaşık 8 saat sürer, maksimum inceleme süresi 48 saattir.

Denetim durumunu şablon listenizde takip edebilirsiniz.

Bir şablon reddedilirse, reddedilme nedeni sağlanacaktır.

Onaylanma olasılığı yüksek şablonlar genellikle:

Açık, profesyonel bir dil kullanır.
Belirli, meşru bir kullanım durumuna hizmet eder (ör. randevu hatırlatmaları, sipariş güncellemeleri).

Önemli: İtalik metin değişken ve özelleştirilebilir olabilir.

Merhaba, size ulaşamadık. Buradan iletişime devam etmeniz sizin için uygun olur mu?

Merhaba, web sitesinde bir mesaj bıraktınız ve sizinle iletişime geçmemi istediniz. (değiştirilebilir)

Merhaba, ben MaviBot'tan John Smith. Daha önce bir sohbet robotu oluşturulması için başvurmuştunuz. Size bazı haberlerimiz olduğunu bildirmekten mutluluk duyuyoruz.

Denetimden geçmeyecek şablonlar:

herhangi bir reklam metni

24 saatlik pencerenin içinde olup olmadığınızı nasıl kontrol edersiniz

Müşterinin son mesajından bu yana kaç gün geçtiğini, tetikleyici koşulunuzda days_from_last_message() işlevini kullanarak belirleyebilirsiniz.

24 saatlik pencereyi kontrol etme örneği:

days_from_last_message() == 0

Doğrulanmamış hesaplar için kısıtlamalar

Doğrulanmamış Facebook Business hesapları aşağıdaki sınırlamalarla karşı karşıyadır:

Günde 50 şablon mesajı (aylık ücrete dahildir).
Gelen mesajlar için kısıtlama yoktur.

Bu kısıtlamaları kaldırmak için şirketinizin genellikle 2–3 hafta süren İşletme Doğrulaması sürecini tamamlaması gerekir.

Ödeme sistemleri

Doğrulanmamış hesaplar için gelen ve giden mesajların fiyatlandırması için satıcınıza danışın.

Ödeme doğrudan 360dialog'a yapılır.

Mesaj gönderme hataları

Teslimat başarısızlığının olası nedenleri:

Alıcının telefon numarası WhatsApp'a kayıtlı değil.
"Kimlik Doğrulama" kategorisinden bir şablonu +91 (Hindistan) ülke koduna sahip bir WhatsApp kullanıcısına gönderme girişimi. Şu anda, Kimlik Doğrulama kategorisi şablonları Hindistan'daki kullanıcılara teslim edilemiyor.
Alıcı, güncellenmiş Hizmet Şartları ve Gizlilik Politikası'nı kabul etmemiş.
Yüksek kaliteli bir kullanıcı deneyimi sağlamak için mesaj teslim edilmedi (bu genel bir politika engelidir).

Tıkla-WhatsApp Reklam Dönüşümleri

fb_pixel_event() işlevi için dokümantasyona bir ek.

Meta*, Tıkla-WhatsApp reklamındaki her tıklamayı bir ctwa_clid tıklama tanımlayıcısıyla işaretler. Bu, müşterinin ilk WhatsApp mesajıyla birlikte alınır ve konuşmadan bir dönüşümü belirli bir reklama atfetmek için kullanılır - tıpkı piksel olaylarının bir web sitesi tıklamasına atfedilmesi gibi.

İmza

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Yeni Parametreler

Parametre	Açıklama
`ctwa_clid`	Click-to-WhatsApp reklamı için tıklama tanımlayıcısı. Bu parametre sağlanmazsa, bot tarafından otomatik olarak kaydedilen `ctwa_clid` istemci değişkeni kullanılır. İsteğe bağlı.
`messaging_channel`	Dönüşümün gerçekleştiği mesajlaşma kanalı. Varsayılan olarak `whatsapp` değerini alır. İsteğe bağlı.

Yeni `action_source` Değeri

Aşağıdaki satır, action_source değerleri tablosuna eklenir:

Değer	Açıklama
`business_messaging`	Dönüşüm, müşterinin bir Click-to-WhatsApp reklamına tıklamasının ardından bir konuşmada gerçekleşti.

Aşağıdaki koşullardan en az biri karşılanıyorsa, bir olay mesajlaşma dönüşümü olarak gönderilir:

action_source="business_messaging" sağlanır;
ctwa_clid sağlanır;
messaging_channel sağlanır.

Bu durumda Meta*, action_source + messaging_channel + ctwa_clid kombinasyonunu alır. Bu kombinasyon olmadan, reklam tıklaması dönüşüme atfedilmez.

website değeri mesajlaşma dönüşümleri için kullanılmamalıdır: olay piksele ulaşır, ancak reklama atfedilmez.

İstemci Değişkenleri

Bir müşteri bir reklama tıkladıktan sonra WhatsApp mesajı gönderdiğinde, bot tıklama verilerini müşterinin istemci değişkenlerine kaydeder. Bu değişkenleri manuel olarak doldurmanız gerekmez.

Değişken	Açıklama
`ctwa_clid`	Tıklama tanımlayıcısı. Olaya otomatik olarak eklenir.
`ctwa_clid_time`	Tanımlayıcının alındığı zaman, Unix zaman biçiminde. Tıklamadan bu yana ne kadar zaman geçtiğini belirlemek için kullanılabilir.
`wa_ads_data`	JSON biçiminde reklam verileri: reklam URL'si, reklam kimliği (`source_id`), başlık, açıklama, yaratıcı türü ve yaratıcı URL'si.

Tıklama tanımlayıcısı otomatik olarak istemci değişkeninden alınır, bu nedenle onu işleve açıkça iletmeniz gerekmez.

Müşterinin telefon numarası, data içinde sağlanmazsa olaya otomatik olarak eklenir.

event_source_url parametresi mesajlaşma dönüşümleri için kullanılmaz.

Sınırlamalar

Tıklama tanımlayıcısı yalnızca müşterinin reklamdaki düğmeye tıkladıktan sonra gönderdiği ilk mesajla alınır. Sonraki mesajlara dahil edilmez. Bu nedenle, olay konuşma sırasında herhangi bir noktada gönderilebilir, ancak yalnızca ilk mesaj reklamdan kaynaklanıyorsa.

Meta*, Android ve iOS'ta Facebook* ve Instagram* uygulamalarından yapılan tıklamalar için ctwa_clid sağlar.

Tanımlayıcı, müşteri bir tarayıcıdan tıkladığında veya reklam düğmesi yerine normal bir gönderiye tıkladığında sağlanmaz. Bu tür etkileşimlerden kaynaklanan dönüşümler reklama atfedilemez.

Müşteri daha sonra başka bir reklama tıklarsa, değişkenler üzerine yazılır. Dönüşüm, müşterinin geldiği en son reklama atfedilir.

Tıklama tanımlayıcısı hem işlev parametrelerinde hem de istemci değişkenlerinde yoksa, işlev No ctwa_clid variable in client variables hatasını döndürür ve olay gönderilmez.