# WhatsApp Business API MaviBot oluşturucu resmi WhatsApp Business API'sini de destekler. ## WhatsApp Business nasıl bağlanır WhatsApp Business API'sini (WABA) projenize bağlamak için şuraya gidin: **Messenger'lar** bölümünü açın ve **WhatsApp Business API**.
**WhatsApp Business API'sini 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 sürekli çevrimiçi tutmanız gerekmez; 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 günün herhangi bir saatinde müşterilere yazamaz ve gri Whatsapp'a benzer şekilde, 24 saatlik müşteri hizmetleri penceresi dışında bot oluştururken sınırsız mesaj gönderemez. 24 saatlik pencere dışında yalnızca WhatsApp mesaj şablonları (veya WhatsApp şablon mesajları) kullanılabilir; bu sırada seçilen kategori içinde iletişim ücretsiz olarak gerçekleşir. Bu işlev, belirli bir zaman aralığında izin verilen mesaj sayısını sınırlayarak ve ayrıca şablonlara bir kategori atayarak WhatsApp'ta spam gönderimini önlemek için kullanılır. Meta tarafından WhatsApp Business Api için aşağıdaki mesaj kategorileri kuruludur: 1\. Faydalı şablonlar (işlemler, faturalar, ödemeler vb. hakkında belirli bilgiler içerir); 2\. Pazarlama için şablonlar (şirket, organizasyon, stratejiler, reklam ve tanıtım hakkında bilgiler); 3\. Doğrulama ve kimlik doğrulama şablonları.
WABA için oluşturulan şablonlar moderasyondan geçirilmektedir. ### Şablon reddedilmesinin başlıca nedenleri Önemli sayıda şablon, birkaç nedenden dolayı WhatsApp moderasyonundan geçemez: 1. **Aşırı reklam:** WhatsApp Business, reklamlar ve tanıtım içeriğiyle aşırı yüklenmiş şablonları reddeder. Moderatörler veya platformun yapay zekâsı, reklamın ana mesajı gölgelediğine karar verirse, şablon engellenecektir. 2. **Ürün Politikasının İhlali:** uyuşturucular, psikotrop maddeler, alkol, tütün, mahrem hizmetler veya insan onurunu aşağılayıcı kabul edilen herhangi bir içeriği teşvik eden şablonlar reddedilecektir. 3. **Belirsizlik, eksiklik veya yanlışlık:** eğer WhatsApp moderatörleri gizli bir alt metin, yanıltıcı bilgi veya şirketiniz ya da hizmetiniz hakkında net ayrıntı eksikliği tespit ederse, şablon onaylanmayacaktır. 4. **Gizli bilgilerin toplanması:** hassas kullanıcı verilerini (ör. pasaport numaraları, banka kartı bilgileri, kişisel kimlik numaraları, ev adresleri) toplamak için tasarlanan şablonlar moderasyondan geçemez. 5. **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 reddedilecektir. 6. **Takdire bağlı reddetme:** WhatsApp moderatörleri, belirli bir neden vermeden şablonları reddetme hakkını saklı tutar. Mesaj şablonları nasıl kurulur Şablonlar bloklardan oluşturulduğu için, bir WhatsApp Business API şablonu olarak kullanmadan önce akışınızda önce bir blok oluşturmalısınız. * **Maliyet ve ilk mesaj:** Şablon mesajlarının gönderimi 24 saatlik konuşma penceresi içinde ücretsizdir. **ilk mesaj** bir müşteriye yalnızca Meta (Facebook) tarafından onaylanmış bir şablon olabilir. * **24 saat sonra:** Sohbet açıldıktan sonra 24 saat geçtiğinde, kullanıcıyla yeniden etkileşim kurmak için yalnızca başka bir onaylı şablon gönderebilirsiniz. * **Moderasyon notu:** Şablonlar değişkenler içeriyorsa (Kiril ya da Latin alfabelerinden herhangi birinde), moderasyondan geçemeyebilir. ## **MaviBot'ta şablon oluşturma** 1. Şuraya gidin: **Kanallar** bölümünde **WhatsApp Business API**seçin ve ardından **Mesaj şablonları**.
2. Şuna tıklayın: **"Şablon oluştur"** düğmesine tıklayın. Bu, şablon oluşturma sayfasını açar. 3. Şablonlar akışınızdaki bloklarla bağlantılıdır. Varsayılan olarak, şablon içeriği bloktan alınır, ancak özel metin ve düğmeler belirleyebilirsiniz.
4. Mesaj şablonu, oluşturulduğunda moderasyona gönderilecektir. **Yalnızca onaylanmış şablonları kullanabilirsiniz.** Moderasyon genellikle yaklaşık 8 saat sürer, en fazla 48 saat olabilir. ## Şablon türleri Seçebileceğiniz 3 şablon türü vardır. Şuna bir görsel ekleyebilirsiniz: **PAZARLAMA** şablonu aşağıdaki formatlarda: SVG, PNG, JPG ve GIF. #### Şablonlarda değişkenler nasıl iletilir Şablonlardaki değişkenler, WhatsApp'ın yerel formatına göre değil, MaviBot genelinde olduğu gibi aynı şekilde işlenir. {% hint style="danger" %} Sistemimiz MaviBot değişkenlerine uyarlanmıştır ve **desteklemez** değişkenleri `{{1}}` biçimlendirin {% endhint %} #### WhatsApp şablon mesajlarında değişken 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, `#{örnek}`. Gönderdikten sonra, sağlanan yöntemle mesajı kontrol ederek değişkenlerin doğru işlendiğini doğrulayın [bağlantısı](https://business.facebook.com/wa/manage/message-templates/). Bir şablon değişken içeriyorsa ancak bot ona bir değer atamazsa ya da değer eksikse, mesaj **gönderilmeyecektir**! ## Şablonlarda düğmeler nasıl çalışır Mesaj şablonları düğmeleri destekler. MaviBot'ta düğmeler, sözdizimine benzer şekilde ayarlanır Facebook API'si. Aşağıdaki bağlantıyı takip ederek bununla tanışabilirsiniz [bağlantısı](https://developers.facebook.com/docs/whatsapp/business-management-api/message-): Düğmeler JSON dizi biçiminde ayarlanır. **Düğme oluşturma parametreleri:** | Parametre | Gerekli | Açıklama | | ------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | tür | 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.

oluşturmak.

| | phone\_number | Hayır |

Arama yapılacak

düğmeye basıldığında aranacak telefon numarası

| | örnek | Hayır |

Şablonunuz için olası verilere bir örnek sunar. Bu, inceleme ve onay sürecine yardımcı olur, böylece

hangi mesajı göndermeyi planladığınızı anlayabilirsiniz. Emin olun

bunların örnekler olduğundan ve herhangi bir gizli ya da kişisel bilgi içermediğinden.

| Ö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 vardır: 1. **Call-To-Action (CTA):** Bir bağlantı veya telefon numarası için düğme (metninin yanında bağlantı veya ahize simgesiyle gösterilir). 2. **Quick Reply:** 20 karakter sınırı olan standart metin düğmeleri. **Sınırlamalar:** * Tek bir şablon en fazla **3 Quick Reply düğmesi** ve en fazla **2 Call-to-Action düğmesi**. Ancak aynı anda iki bağlantı veya iki telefon numarası kullanamazsınız. * Düğmeler değişken, satır sonları, emojiler veya biçimlendirme simgeleri içeremez. **Davranış:** * Bir **Quick Reply** düğmesine tıklamak, metnini kullanıcıdan bir yanıt mesajı olarak gönderir. * Bir **Call-to-Action** düğmesi bir dosyaya bağlantı açabilir. * Bir **Call-to-Action** telefon görüşmesi düğmesi standart arama ekranını açar. WhatsApp Web'de, masaüstü sürümünden arama yapılamayacağını belirten bir bildirim görünür. ### Şablon moderasyonu nasıl çalışır Her şablon, oluşturulduktan hemen sonra moderasyona gönderilir. Süreç genellikle **yaklaşık 8 saat**sürer, azami inceleme süresi ise **48 saat**. Moderasyon durumunu şablon listenizde takip edebilirsiniz. Bir şablon reddedilirse, reddedilme nedeni belirtilir. **Onaylanma olasılığı yüksek şablonlar genellikle:** * Açık, profesyonel bir dil kullanır. * Belirli, meşru bir kullanım senaryosuna hizmet eder (ör. randevu hatırlatıcıları, sipariş güncellemeleri). **Önemli:** Şuradaki metin: *italik* değişken ve özelleştirilebilir olabilir. Merhaba, size ulaşmayı başaramadık. Burada iletişimi sürdürmeniz sizin için uygun olur mu? Merhaba, web sitesinde bir mesaj bıraktınız ve sizinle iletişime geçmemi istediniz.(değişebilir) Merhaba, ben MaviBot'tan John Smith. Daha önce bir sohbet botu oluşturulması için başvuruda bulunmuştunuz. Size bazı haberlerimiz olduğunu bildirmekten memnuniyet duyuyoruz. Moderasyondan geçmeyecek şablonlar: herhangi bir reklam metni #### **24 saatlik pencere içinde olup olmadığınızı nasıl kontrol edersiniz** Müşterinin son mesajından bu yana kaç gün geçtiğini `days_from_last_message()` tetikleyici koşulunuzdaki işlevini kullanarak belirleyebilirsiniz. **24 saatlik pencereyi kontrol etme örneği:** `days_from_last_message() == 0` ### Şablonlar olmadan düğmeler nasıl kullanılır Şablonların dışında kullanılabilen ve diğer mesajlaşma uygulamalarındakiyle aynı şekilde yapılandırılan iki tür düğme vardır: 1. [**Yanıt düğmeleri:**](/doc/tr/chatbot/builder/butonlar.md) En fazla **3** bir blokta kullanılabilir. 2. [**Satır içi düğmeler**](/doc/tr/chatbot/builder/butonlar.md)**:** En fazla **10**, ve örnekte gösterildiği gibi görünürler. **Şablon dışı düğmeler için önemli sınırlamalar:** * Düğmeler yalnızca **text**. **Bağlantılar desteklenmez.** * Tek işlevleri **müşteriyi bir bloktan diğerine taşımak** akışınız içinde. *** **Doğrulanmamış hesaplar için kısıtlamalar** Doğrulanmamış Facebook Business hesapları şu sınırlamalarla karşılaşır: * **günde 50 şablon mesajı** (aylık ücrete dahildir). * **Kısıtlama yok** gelen mesajlarda. Bu kısıtlamaları kaldırmak için şirketinizin **İşletme Doğrulaması** sürecini tamamlaması gerekir; bu genellikle **2–3 hafta**. ## Ödeme sistemleri Doğrulanmamış hesaplar için gelen ve giden mesajların fiyatlandırması konusunda yeniden satıcınızla görüşün. {% hint style="info" %} Ödeme doğrudan **360dialog**. {% endhint %} ## Mesaj gönderme hataları **Teslimat başarısızlığının olası nedenleri:** 1. Alıcının telefon numarası WhatsApp'ta kayıtlı değil. 2. Şablon göndermeye çalışılıyor **"Kimlik Doğrulama"** kategoriye sahip bir WhatsApp kullanıcısına ülke kodu **+91 (Hindistan)**. Şu anda, Kimlik Doğrulama kategorisindeki şablonlar Hindistan'daki kullanıcılara teslim edilemez. 3. Alıcı güncellenmiş **Hizmet Şartları'nı** ve **Gizlilik Politikası'nı**. 4. Yüksek kaliteli bir kullanıcı deneyimini sürdürmek için mesaj teslim edilmedi (bu genel bir politika engelidir). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/tr/chatbot/mesajlasma-uygulamalari/waba.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.