For the complete documentation index, see llms.txt. This page is also available as Markdown.

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).

  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.

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ı

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

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.

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

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.

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.

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

exid
e-posta
msisdn
wpNumber
permission

12345

test1@example.com

905301112233

+905301112233

1

34328

user2@example.co.uk

442071234567

+442071234567

0

78901

test1@example.com

905112345678

+905112345678

1

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.

Son güncelleme

Bu yararlı oldu mu?