# WhatsApp Entegrasyonu Entegrasyonu kurmadan önce aşağıdaki gereksinimleri okuduğunuzdan emin olun: * **İçerik kuralları:** Tüm mesajlar WhatsApp ve Meta’nın içerik politikalarına uygun olmalıdır. * **Uyumluluk:** Geçerli tüm Meta politikalarına ve düzenlemelerine uymalısınız. * **İşletmeler** yalnızca bir **onaylanmış mesaj Şablon**. ### Gereksinimler | Gereksinim | Açıklama | | -------------------------------- | ---------------------------------------------------------------------------------- | | **Meta Business Manager hesabı** | WhatsApp Business ve Şablonları yönetmek için bir Meta Business hesabı gereklidir. | | **WhatsApp Business hesabı** | WhatsApp Business API üzerinden bağlanmak ve mesaj göndermek için gereklidir. | | **WhatsApp telefon numarası** | WhatsApp’ın gereksinimlerini karşılayan bir telefon numarası edinmelisiniz. | ### Entegrasyon Adımları ### 1. Adım: WhatsApp Business Kurulumu 1. **Bir Meta Business hesabı oluşturun veya seçin** (şirketinizin zaten bir hesabı varsa, uygun hesabı seçin). 2. **Bir WhatsApp Business hesabı oluşturun veya seçin** Meta Business Manager’ınız altında. 3. **WhatsApp Business profilinizi ayarlayın**; görünen ad ve işletme bilgileri dahil (Meta’nın [görünen ad yönergelerine](http://facebook.com/business/help/757569725593362)). 4. **WhatsApp Business numaranızı doğrulayın** Meta üzerinden. ### 2. Adım: WhatsApp’ı Netmera’ya Bağlayın * Netmera panelinde şu yola gidin: **Entegrasyonlar > Mesajlaşma Sağlayıcısı > WhatsApp**. * Meta Business Manager hesabınızı bağlamak için yönlendirmeli kurulum akışını izleyin. * Kullanmak istediğiniz WhatsApp Business hesabını seçin. * Kampanyaların gönderiminde kullanılacak telefon numarasını atayın. {% embed url="" %} Tamamlandığında, WhatsApp hesabınız kampanya yönetimi için Netmera’ya bağlanmış olacaktır. ### 3. Adım: Webhook Yapılandırması (Analitik İçin Gerekli) Bu webhook bağlantısı olmadan, yine de Netmera üzerinden WhatsApp kampanyaları oluşturup gönderebilirsiniz. Ancak, **ayrıntılı WhatsApp mesaj raporlarını** Netmera’da görüntülemek ve bu raporlardan belirli kullanıcı verilerini dışa aktarmak istiyorsanız, aşağıdakiler arasında bir webhook entegrasyonu yapılandırmanız gerekir: **Meta Business Profili** ve **Netmera**. Yapılandırma tamamlandığında, raporlarınızda aşağıdaki metrikleri göreceksiniz: * **Hedef Kitle** – Kampanyada hedeflenen kullanıcı sayısı * **Kullanıcılar** – Dahil edilen gerçek benzersiz kullanıcı sayısı * **Gönderilen** – Başarıyla gönderilen toplam mesaj sayısı * **Teslimat** – Alıcıların cihazlarına teslim edilen mesajlar * **Okundu** – Alıcılar tarafından açılan ve okunan mesajlar
#### Meta Business Profilinde Webhook Yapılandırması {% embed url="" %} Raporlamayı etkinleştirmek için, aşağıdaki ayrıntıları **Meta Business Profili > Webhook** bölümünde yapılandırmalısınız: **Geri arama URL’si** `https://report.netmera.com/reporter/whatsapp/webhook` **Doğrulama Token’ı** `ZOjDrXwwpPAEMofzIJ7wYxxrJ9g0PCqJTPIqVyyiCSI=`
### Adım 4: WhatsApp Şablonları Oluşturun {% hint style="info" %} Yalnızca **onaylı şablonlar** için kullanılabilir **başlatmak** müşterilerinizle WhatsApp kampanyalarını başlatmak için kullanılabilir. Şablonlarınızın durumunu Netmera Panel’de de görebilirsiniz. {% endhint %} **Meta’da bir şablon oluşturmak için:** 1. Şuraya giriş yapın: **Meta Business Manager**. 2. Altında **Hesap Araçları**, seçin **Mesaj Şablonları > Pazarlama**. 3. Tıklayın **Şablon Oluştur** ve mesajınızı şu yönergelere göre tasarlayın: [Meta’nın yönergeleri.](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines)
#### Şablonun Düzenlenmesi Mesaj şablonunuzu oluştururken şunları tanımlayabilirsiniz: * **Başlık (isteğe bağlı):** Metin veya medya (görsel, video, belge). * **Gövde (zorunlu):** Mesajınızın ana metni. * **Altbilgi (isteğe bağlı):** Ek destekleyici metin. * **Düğmeler (isteğe bağlı):** En fazla iki Eylem Çağrısı düğmesi ekleyin (ör. Web Sitesini Ziyaret Et, Telefon Ara). Oluştururken mesajınızın canlı önizlemesi panelde görüntülenecektir. {% columns %} {% column width="41.66666666666667%" %} #### Değişkenler Kullanımı Ekleyebilirsiniz **Değişkenler** Şablonunuza seçerek **+ Değişken Ekle**. * Bu yer tutucular (örn., *{{1}}*, *{{2}}*) daha sonra ile eşleştirilebilir **Netmera Profil Nitelikleri**. * Örnek: *Merhaba {{1}}* → olur *Merhaba Sarah* Netmera üzerinden kişiselleştirildiğinde. {% endcolumn %} {% column width="58.33333333333333%" %}
{% endcolumn %} {% endcolumns %} #### Onaya Gönder * Şablonu inceleme için Meta’ya gönderin. * Onay süresi **24 saate kadar sürebilir**. Şablonlarınız otomatik olarak **Netmera’ya senkronize edilir**, burada onları daha da kişiselleştirebilir ve kampanyalarınızda kullanabilirsiniz. Onaylandıktan sonra, doğrudan şu seçeneği kullanarak kampanya göndermeye başlayabilirsiniz: **WhatsApp Kampanyası Oluştur** Netmera panelinde. ### WhatsApp Numara Dosyası İçe Aktarma Bu **WhatsApp Numara Dosyası İçe Aktarma** toplu dosyalar aracılığıyla WhatsApp kampanyaları için kullanıcı onay kayıtlarını yüklemenize ve yönetmenize olanak tanır. Bu bölüm, gereksinimleri, doğrulama mantığını ve içe aktarma sırasında sistemin davranışını açıklar. #### Dosya Gereksinimleri **Zorunlu Alanlar** * Yalnızca **WhatsApp numarası (wpNumber)** ve **onay durumu (permission)** dosyada bulunmalıdır. * İzinler için dosyalarınızda 1 (opt\_in) ve 2 (opt\_out) kullanın. * Gibi diğer tanımlayıcılar **Harici Kimlik (ExID)**, **e-posta** veya **MSISDN** isteğe bağlıdır. **Numara Formatı** * Tüm WhatsApp numaraları **ülke kodunu** içermelidir (Meta’nın gerektirdiği şekilde). * Yükleme sırasında bir **format doğrulaması** kontrolü, numara yapısının uluslararası standartlara uygun olmasını sağlar. ### WhatsApp Kullanıcıları Netmera’ya Nasıl Yüklenir * Şuraya gidin **Panel > Hedefleme > İletişim Yükleme** * Dosyanızı seçin ve tıklayın **Yükleme**. * Sistem numaraları ve formatları otomatik olarak doğrular. #### Örnek Format
exide-postamsisdnwpNumberpermission
12345test1@example.com905301112233+9053011122331
34328user2@example.co.uk442071234567+4420712345670
78901test1@example.com905112345678+9051123456781
{% hint style="warning" %} * Her zaman `+` ve ülke kodunu `wpNumber`. * Kullanın **`1`** (opt\_in) ve **`0`** (opt\_out) dosyalarınızda izin değerleri için kullanın. * `wpNumber` ve `permission` zorunludur. `e-posta`, `msisdn` ve `exid` isteğe bağlıdır. {% endhint %} #### Kullanıcı Eşleştirme Mantığı Dosya işlendiğinde sistem, kullanıcının zaten mevcut olup olmadığını kontrol eder. Bu kontrol bir **öncelik sırasını**: 1. **ExID** (sağlanmışsa) 2. **E-posta** (sağlanmışsa) 3. **MSISDN** (sağlanmışsa) 4. **WhatsApp Numarası (wpNumber)** * bu sıralamadaki herhangi bir adımda bir kullanıcı bulunursa, o kullanıcı kaydı kullanılır. * eşleşen bir kullanıcı bulunmazsa, **yeni bir kullanıcı profili** sağlanan bilgilerle oluşturulur. **Onay Güncellemeleri** Eğer bir **eşleşen kullanıcı varsa**: * Yalnızca **WhatsApp onayı** alanı güncellenir. * Diğer profil bilgileri (ör., `ExID`, `e-posta`, `MSISDN`) **değiştirilmez**. Eğer bir **yeni kullanıcı oluşturulur**: * Dosyadaki sağlanan tüm bilgiler (`ExID`, `e-posta`, `MSISDN`, `wpNumber`vb.) yeni profile eklenir. **Numara Tekilleştirme** * Bir WhatsApp numarası aynı anda yalnızca **bir kullanıcı profiline** ait olabilir. * Aynı numara birden fazla kullanıcı profilinde bulunursa: * Sistem otomatik olarak **numarayı kaldırır** diğer kullanıcılardan. * Profil, **en son içe aktarılan dosyadaki** şu hale gelir: **ana kayıt** bu numara için. --- # 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://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/omnichannel-etkilesim/whatsapp/whatsapp-entegrasyonu.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.