> For the complete documentation index, see [llms.txt](https://user.netmera.com/netmera-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/omnichannel-etkilesim/whatsapp/whatsapp-entegrasyonu.md). # 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 konuşma başlatmak için bir **onaylı mesaj şablonu**. ### 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 hesabı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önergeleri](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 şuraya 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ı göndermek için 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 için Gerekli) Bu webhook bağlantısı olmadan da Netmera üzerinden WhatsApp kampanyaları oluşturabilir ve 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, sizin **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önderildi** – 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çılıp okunan mesajlar
#### Meta Business Profilinde Webhook Yapılandırması {% embed url="" %} Raporlamayı etkinleştirmek için, şuradaki aşağıdaki ayrıntıları yapılandırmalısınız: **Meta Business Profili > Webhooks** bölümü: **Callback URL** `https://report.netmera.com/reporter/whatsapp/webhooks` **Doğrulama Token'ı** `ZOjDrXwwpPAEMofzIJ7wYxxrJ9g0PCqJTPIqVyyiCSI=`
### 4. Adım: WhatsApp Şablonları Oluşturun {% hint style="info" %} Yalnızca **onaylı şablonlar** kullanılabilir **başlatmak için** müşterilerinizle WhatsApp kampanyaları. Şablonlarınızın durumunu Netmera Paneli'nde de görebilirsiniz. {% endhint %} **Meta'da bir şablon oluşturmak için:** 1. Meta Business Manager'a giriş yapın **Hesap Araçları**. 2. Altında **Mesaj Şablonları > Pazarlama**, **Şablon Oluştur**. 3. Tıklayın **ve mesajınızı şu doğrultuda tasarlayın:** Meta'nın yönergeleri. [Şablonun Düzenlenmesi](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines)
#### Mesaj şablonunuzu oluştururken şunları tanımlayabilirsiniz: Üstbilgi (isteğe bağlı): * **Metin veya medya (görsel, video, belge).** Gövde (gerekli): * **Mesajınızın ana metni.** Ana metin. * **Altbilgi (isteğe bağlı):** Ek destek metni. * **Butonlar (isteğe bağlı):** En fazla iki Eylem Çağrısı butonu ekleyin (örn. Web Sitesini Ziyaret Et, Telefonu Ara). Oluştururken mesajınızın canlı önizlemesi panelde görüntülenecektir. {% columns %} {% column width="41.66666666666667%" %} #### Değişkenlerin Kullanımı Ekleyebilirsiniz **değişkenleri** şablonunuza seçerek **+ Değişken Ekle**. * Bu yer tutucular (örn., *{{1}}*, *{{2}}*) daha sonra **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ürebilir **24 saate kadar**. Ş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 şunu 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 gereklidir. * İ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 Biçimi** * Tüm WhatsApp numaraları **ülke kodunu** içermelidir (Meta'nın gerektirdiği gibi). * Yükleme sırasında bir **biçim doğrulaması** kontrolü, numara yapısının uluslararası standartlara uygun olmasını sağlar. ### WhatsApp Kullanıcılarını Netmera'ya Nasıl Yüklersiniz * Şuraya gidin **Panel > Hedefleme > Kişi Yükleme** * Dosyanızı seçin ve tıklayın **Yükleme**. * Sistem numaraları ve biçimleri otomatik olarak doğrular. #### Örnek Biçim
exide-postamsisdnwpNumberpermission
12345test1@example.com905301112233+9053011122331
34328user2@example.co.uk442071234567+4420712345670
78901test1@example.com905112345678+9051123456781
{% hint style="warning" %} * Her zaman dahil edin `+` ve ülke kodunu `wpNumber`. * Kullanın **`1`** (opt\_in) ve **`0`** (opt\_out) dosyalarınızda. izin değerleri için. * `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ıradaki herhangi bir adımda kullanıcı bulunursa, o kullanıcı kaydı kullanılır. * Eğer eşleşen bir kullanıcı bulunmazsa, bir **yeni kullanıcı profili** sağlanan ayrıntılarla 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 (örn., `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** şuna dönüşür: **ana kayıt** bu numara için. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/omnichannel-etkilesim/whatsapp/whatsapp-entegrasyonu.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.