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: Tüm geçerli Meta politikalarına ve düzenlemelerine uymalısınız.

• İşletmeler sadece 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 aracılığıyla bağlanmak ve mesaj göndermek için gereklidir.
WhatsApp telefon numarası	WhatsApp’ın gereksinimlerini karşılayan bir telefon numarası edinmelisiniz.

Entegrasyon Adımları

Adım 1: WhatsApp Business Kurulumu

1. Bir Meta Business hesabı oluşturun veya seçin (şirketinizin zaten bir hesabı varsa, uygun hesabı seçin).

2. Meta Business Manager altında bir WhatsApp Business hesabı oluşturun veya seçin Meta Business Manager hesabınızın altında.

3. WhatsApp Business profilinizi ayarlayın, görüntü adı ve işletme bilgileri dahil (Meta'nın görüntü adı yönergelerine).

4. uyduğundan emin olun). WhatsApp Business numaranızı doğrulayın

Meta üzerinden.

• Adım 2: WhatsApp'ı Netmera'ya Bağlayın Netmera panelinde.

• Integrations > Messaging Provider > WhatsApp

• kısmına gidin ve Meta Business Manager hesabınızı bağlamak için rehberli kurulum akışını takip edin.

• Kullanmak istediğiniz WhatsApp Business hesabını seçin.

Kampanya gönderiminde kullanılacak telefon numarasını atayın.

Tamamlandığında, WhatsApp hesabınız kampanya yönetimi için Netmera'ya bağlanmış olacaktır.

Adım 3: Webhook'u Yapılandırın (Analitik için Gereklidir) Bu webhook bağlantısı olmadan Netmera üzerinden WhatsApp kampanyaları oluşturabilir ve gönderebilirsiniz. Ancak, Netmera'da detaylı WhatsApp mesaj raporlarını görmek ve bu raporlardan belirli kullanıcı verilerini dışa aktarmak istiyorsanız, and Meta Business Profile ile Netmera arasında bir webhook entegrasyonu yapılandırmanız gerekir..

Yapılandırma tamamlandığında raporlarınızda aşağıdaki metrikleri göreceksiniz:

• The Success metric reflects whether the campaign’s notifications were successfully delivered. – Kampanyada hedeflenen kullanıcı sayısı

• Users – Dahil edilen gerçek farklı 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

• : Kullanıcıların açıp görüntülediği uygulama içi mesajların toplam sayısı. Bu, kullanıcı etkileşimi ve mesaj içeriğine ilginin seviyesini yansıtır. – Alıcılar tarafından açılıp okunan mesajlar

Meta Business Profile'da Webhook Yapılandırması

Raporlamayı etkinleştirmek için Meta Business Profile > Webhooks bölümünde aşağıdaki detayları yapılandırmalısınız:

Callback URL

https://report.netmera.com/reporter/whatsapp/webhooks

Verify Token

ZOjDrXwwpPAEMofzIJ7wYxxrJ9g0PCqJTPIqVyyiCSI=

Adım 4: WhatsApp Şablonları Oluşturun

Sadece onaylı şablonlar kullanılarak başlatılabilir müşterilerinizle WhatsApp kampanyaları. Şablonlarınızın durumunu Netmera Panel'de de görebilirsiniz.

Meta'da bir şablon oluşturmak için:

1. giriş yapın Meta Business Manager.

2. Altında Account Toolsseçin Message Templates > Marketing.

3. Tıklayın Create Template ve mesajınızı Meta'nın yönergelerine göre tasarlayın. Meta’nın yönergelerine uyun.

Şablonu Düzenleme

Mesaj şablonunuzu oluştururken şunları tanımlayabilirsiniz:

• Header (isteğe bağlı): Metin veya medya (görsel, video, belge).

• Body (gerekli): Mesajınızın ana metni.

• Footer (isteğe bağlı): Ek destekleyici metin.

• Buttons (isteğe bağlı): En fazla iki Harekete Geçirici Mesaj (CTA) butonu ekleyin (ör. Visit Website, Call Phone).

Mesajınızı oluştururken panelde canlı önizleme gösterilecektir.

Değişkenlerin Kullanımı

Şablonunuza değişkenler ekleyebilirsiniz + Add Variable.

• Bu yer tutucular (ör., {{1}}, {{2}}) daha sonra Netmera Profile Attributes.

• Example: ile eşlenebilir. Hello {{1}} → olur Hello Sarah

Netmera üzerinden kişiselleştirildiğinde.

• Onaya Gönder

• Şablonu Meta'ya inceleme için gönderin. Onay.

24 saate kadar sürebilir Şablonlarınız otomatik olarakNetmera'ya senkronize edilir , burada onları daha fazla kişiselleştirebilir ve kampanyalarınızda kullanabilirsiniz. Onaylandıktan sonra, doğrudan kullanarak kampanya göndermeye başlayabilirsiniz Create WhatsApp Campaign

WhatsApp Numara Dosya İçe Aktarma

The WhatsApp Numara Dosya İçe Aktarma ile toplu dosyalar aracılığıyla WhatsApp kampanyaları için kullanıcı onay kayıtlarını yükleyebilir ve yönetebilirsiniz. Bu bölüm, ithalat sırasında sistemin gereksinimlerini, doğrulama mantığını ve davranışını açıklar.

Dosya Gereksinimleri

Zorunlu Alanlar

• Sadece WhatsApp numarası (wpNumber) and onay durumu (permission) dosyada zorunludur.

• İzinler için dosyalarınızda 1 (opt_in) ve 2 (opt_out) kullanın.

• Diğer tanımlayıcılar gibi External ID (ExID), email, veya MSISDN isteğe bağlıdır.

Numara Formatı

• Tüm WhatsApp numaraları ülke kodunu içermelidir (Meta tarafından gerekli olduğu şekilde).

• Yükleme sırasında bir format doğrulaması kontrolü, numara yapısının uluslararası standartlara uygun olduğunu sağlar.

WhatsApp Kullanıcılarını Netmera'ya Nasıl Yükleyebilirsiniz

• Git: Panel > Targeting > Contact Upload

• Dosyanızı seçin ve tıklayın Yükle.

• Sistem numaraları ve formatları otomatik olarak doğrular.

Örnek Format

exid	email	msisdn	wpNumber	permission
12345	[email protected]	905301112233	[phone]	1
34328	[email protected]	442071234567	[phone]	0
78901	[email protected]	905112345678	[phone]	1

• Her zaman + ve ülke kodunu wpNumber.

• Kullanın 1 dosyalarınızda (opt_in) ve 0 (opt_out) için izin değerleri olarak dahil edin.

• wpNumber and permission zorunludur. email, msisdn and exid isteğe bağlıdır.

Kullanıcı Eşleştirme Mantığı

Dosya işlendiğinde, sistem kullanıcının zaten var olup olmadığını kontrol eder. Bu kontrol bir öncelik sırasını:

1. takip eder ExID

2. E-posta ExID

3. MSISDN ExID

4. (sağlanmışsa)

• WhatsApp Numarası (wpNumber)

• Bu dizide herhangi bir adımda bir kullanıcı bulunursa, o kullanıcı kaydı kullanılır. Hiçbir eşleşen kullanıcı bulunamazsa, sağlanan bilgilerle yeni bir kullanıcı profili

oluşturulur.

Onay Güncellemeleri Eğer bir:

• eşleşen kullanıcı varsa Sadece WhatsApp onay

• alanı güncellenir. takip eder, email, MSISDNDiğer profil bilgileri (ör., ).

Onay Güncellemeleri değiştirilmez:

• yeni kullanıcı oluşturulurtakip eder, email, MSISDN, wpNumberDosyada sağlanan tüm bilgiler (

, vb.) yeni profile eklenir.

• Numara Çoğaltma Kontrolü Bir WhatsApp numarası yalnızca tek bir kullanıcı profiline

• ait olabilir.

  • Aynı numara birden fazla kullanıcı profili altında bulunursa: Sistem otomatik olarak numarayı kaldırır

  • diğer kullanıcılardan. En son içe aktarılan dosyadan profil o numara için ana kayıt olur.