Mokapen Rehberi

Ana menü
Uygulama Entegrasyonları Ortak özellikler Bize Ulaşın

WhatsApp İş

The WhatsApp İş Entegrasyon, kuruluşunuzun WhatsApp Business numarasını Mokapen'e bağlar: SMS gönderebilir ve SMS'in aksine aynı zamanda almak Kişilerinizden gelen mesajlar, konuşmaları doğrudan kişi kartından veya birleşik karttan yönetme Mesajlar SMS ve sohbetin yanı sıra gelen kutusu.

Önemli: kanal resmi kanalı kullanıyor Meta WhatsApp İş platformu. Bağlamak için bir Meta Business hesabına ve WhatsApp ürününün yapılandırılmış olduğu bir Meta Developer uygulamasına ihtiyacınız vardır (Gereksinimler bölümüne bakın): bu, kişisel telefonunuzda kullandığınız WhatsApp uygulamasıyla doğrudan bir bağlantı değildir.

Genel entegrasyonlara genel bakış: Entegrasyonlar.

 

Gereksinimler

  • WhatsApp Business entegrasyonunu içeren bir Mokapen planı (prim — planınızda yoksa sayfadaki madalya simgesi).
  • A doğrulanmış Meta İşletme portföyü.
  • A Meta Geliştirici uygulaması bu portföye bağlı WhatsApp ürün yapılandırılmıştır.
  • Bir telefon numarası Olumsuz zaten kişisel WhatsApp uygulamasına, WhatsApp Business uygulamasına veya başka bir WhatsApp Business API sağlayıcısına/hizmetine bağlı. Numara zaten başka bir yerde kayıtlıysa, Meta'nın geçiş sürecini takiben ilk önce Mokapen kurulumuna taşınması gerekir: geçiş konusunda yardıma ihtiyacınız varsa Mokapen destek ekibiyle iletişime geçin.
  • Kredi kuruluşun cüzdanında mevcuttur: gönderilen her mesaj, hedef ülke ve mesaj kategorisine göre krediden düşülür (Kredi ve fiyatlandırma bölümüne bakın).

 

WhatsApp Business hesabını bağlama

Bağlantı Meta'nın aracılığıyla gerçekleşir Gömülü Kayıt, yani İşletme portföyünü, WhatsApp Business hesabını (WABA) ve bağlanılacak numarayı seçerken size yol gösteren bir Meta/Facebook oturum açma penceresi; taranması basit bir QR kodu değildir.

  1. Kullanıcı menüsü → EntegrasyonlarWhatsApp İş.
  2. Tıklamak WhatsApp Business'ı bağlayın (yeterli bir Premium planı gerektirir).
  3. Açılan pencerede Meta hesabınızla oturum açın ve belirtilen adımları izleyin: İşletme portföyünü, WhatsApp Business hesabını ve bağlanılacak telefon numarasını seçin.
  4. Onayla: Mokapen gerekli izinleri alır ve o hesap için bildirimlere (webhook) otomatik olarak abone olur.

Bağlantı sırasında Meta, numaranın zaten başka bir WhatsApp Business API sağlayıcısında olduğunu bildirirse önerilen seçeneği seçin göç seçeneğini seçin ve numaranın zaten WhatsApp Business API'de olduğunu onaylayın; bunun yerine numara hala kişisel WhatsApp uygulamasındaysa, tekrar denemeden önce yaklaşık 15 dakika bekleyerek önce o telefonun hesabının silinmesi gerekir. Numarada iki adımlı doğrulama etkinse, bağlanmadan önce devre dışı bırakılması gerekir (WhatsApp Yöneticisi'nde veya mevcut sağlayıcı aracılığıyla).

 

Numaranın etkinleştirilmesi

Katıştırılmış Kayıttan sonra numara şu şekilde olmalıdır: etkinleştirildi mesaj göndermeden önce:

  1. Entegrasyonlar → WhatsApp Business sayfasında Numarayı etkinleştir.
  2. İstenirse, bir istekte bulunun doğrulama kodu SMS veya sesli arama yoluyla bağlı numaraya gidin ve geldiğinde girin.
  3. Bir girin 6 haneli PIN: bu numarada iki adımlı doğrulama zaten mevcutsa mevcut PIN'i kullanın; aksi takdirde bu, Meta'nın gelecekte numarayla ilgili işlemler için ihtiyaç duyacağı yeni PIN olur.
  4. İsteğe bağlı: bir tane seçin veri yerelleştirme bölgesi. Etkinleştirildiğinde, yalnızca numaranın kaydı silinip yeniden kaydedilerek değiştirilebilir.
  5. Onayla: Her şey doğruysa sayı şu şekilde değişir: aktif durumu ve entegrasyonu kullanmaya başlayabilirsiniz.

Meta maksimuma izin verir 10 kayıt talebi 72 saatlik süre içinde aynı telefon numarası için: sınırı aşarsanız tekrar denemeden önce bekleyin. PIN yanlışsa bunu WhatsApp Yöneticisi'nde kontrol edin veya numarayı yeni taşıdıysanız önceki sağlayıcıyla sıfırlayın.

 

Kredi ve fiyatlandırma

WhatsApp mesajlarını göndermek kullandıkça öde: aynı organizasyonu kullanıyor cüzdan (ön ödemeli kredi) Mokapen'deki SMS gibi diğer kullandıkça öde özellikleri tarafından kullanılan, ayrı bir kredi değildir.

  • The mesaj başına maliyet bağlıdır hedef ülke numara ve mesaj kategori (24 saatlik pencerede pazarlama, yardımcı program, kimlik doğrulama veya ücretsiz konuşma mesajı - sonraki bölümlere bakın).
  • Entegrasyonlar → WhatsApp Business sayfası her zaman kuruluşun mevcut kredi, doğrudan bağlantıyla tamamlamak cüzdan.
  • Kredi: gönderildiği anda kesilir, daha önce değil.
  • Kredi yeterli değilse gönderim engellenir ve Mokapen bir uyarı gösterir — "Yetersiz WhatsApp Business kredisi. Lütfen mesaj göndermek için kredilerinizi doldurun." — yükleme sayfasına doğrudan bağlantı ile.

Cüzdana yükleme şu kullanıcılar tarafından görülebilir: Mal sahibi ve üyeler organizasyon izniyle; kampanyalardan veya pazarlama şablonlarının toplu gönderiminden önce bakiyeyi kontrol edin.

 

Manuel olarak mesaj gönderme

WhatsApp gönder butonu şu adreste mevcuttur: iletişim kartı. WhatsApp simgesine basmak:

  1. Kişinin adını seçin telefon numarası yazmak için (karttakiler arasında).
  2. Birden fazla bağlı WhatsApp Business hesabınız varsa hangisini kullanacağınızı seçin.
  3. eğer sen 24 saatlik pencere içinde (kişi yakın zamanda size yazdı, sonraki bölüme bakın), normal WhatsApp'ta olduğu gibi serbest biçimli bir mesaj yazabilirsiniz. eğer sen pencerenin dışında ya da bu ilk temasınızsa, bir onaylanmış şablon Meta'dan: yalnızca içeren şablonlar Onaylı durumu menüden seçilebilir.
  4. Şablonda yer tutucular varsa ({{1}}, {{2}}…), devam etmeden önce gerekli değerleri girin: değerler olmadan şablon devre dışı kalır.
  5. Mesaj önizlemesini kontrol edin (WhatsApp balonu olarak gösterilir) ve tuşuna basın. Göndermek. Başarı durumunda onay "WhatsApp Business mesajı başarıyla gönderildi." görüntülenir ve mesaj kişinin geçmişine girer.

Henüz etkin bir WhatsApp Business entegrasyonunuz yoksa düğme, önce bağlantıyı tamamlamanız için sizi Entegrasyonlar → WhatsApp Business sayfasına yönlendirir.

 

24 saatlik pencere

WhatsApp Business, yalnızca Mokapen için değil, platformdaki her işletme için geçerli olan bir kural uyguluyor: yazabilirsiniz serbest biçimli metin (şablon olmadan) yalnızca içindeki bir kişiye 24 saat kişinin size gönderdiği son mesajın (sözde) müşteri hizmetleri penceresi.

  • Kişi size yazarsa pencere açılır (veya yenilenir) ve 24 saat boyunca metin veya eklentilerle serbestçe yanıt verebilirsiniz.
  • Yeni bir mesaj gelmeden 24 saat geçtikten sonra veya bu numaradan hiç mesaj almadıysanız, bir numara kullanmalısınız. onaylanmış şablon Meta'dan onlara yazmak için (bir sonraki bölüme bakın): pencerenin dışında bir iş görüşmesini bu şekilde başlatır veya sürdürürsünüz.
  • Pencerenin dışına serbest biçimli metin göndermeye çalışırsanız gönderim engellenir: uygun bir şablon seçin (genellikle Yardımcı Program kategori) serbest biçimli bir mesaj yerine.

 

WhatsApp Business şablonları

Mesaj şablonları Meta'dan önceden onaylanmış formatlardır ve 24 saatlik pencerenin dışında bir konuşma başlatmak veya yazmak için gereklidir. Bunları iki şekilde yönetebilirsiniz:

  • Meta'da zaten mevcut olan şablonları senkronize edin — Entegrasyonlar → WhatsApp Business sayfasında şunu kullanın: Şablonları senkronize et: Mokapen şablonları içe aktarır Onaylı durum henüz bağlanmadığından manuel gönderimde bunları hemen kullanabilirsiniz.
  • Mokapen'de şablon oluşturma veya düzenleme - içinde Ayarlar → Şablonlar, WhatsApp Business türü: oluşturma, düzenleme veya silme gerçekleşir doğrudan Meta'da bağlantılı uygulama aracılığıyla ve Meta bunu bildirdiğinde onay durumu otomatik olarak güncellenir.

 

Şablon oluştururken bazı önemli kurallar:

  • KategoriYardımcı Program (Kullanıcının beklediği işlem güncellemeleri: sipariş durumu, randevu hatırlatıcıları, hesap uyarıları), Pazarlama (promosyonlar, teklifler, haber bültenleri: alıcının işletmenizden WhatsApp mesajları almak için açık izin vermiş olmasını gerektirir) veya Kimlik doğrulama (OTP veya doğrulama kodları, özel düğmelerle birlikte). Kategori gerçek içerikle eşleşmelidir: Yanlış kategorilendirme reddedilmeye veya daha düşük kalite puanına yol açabilir.
  • Yapı — isteğe bağlı başlık (metin, resim, video, belge veya konum), gerekli gövde, isteğe bağlı altbilgi, en fazla 3 düğme (hızlı yanıt, URL bağlantısı veya telefon numarası).
  • İsim — yalnızca küçük harfler, sayılar ve alt çizgiler (ör. order_confirmation), hesap ve dil başına benzersizdir.
  • Yer tutucular - kullanmak {{1}}, {{2}}, {{3}} sıralı ve boşluksuz; oluştururken örnek değerler sağlayın.
  • Karakter sınırları — gövde en fazla 1.024 karakter, metin üstbilgisi ve altbilgisi her biri en fazla 60 karakter, düğme etiketi en fazla 20 karakter, şablon başına en fazla 3 düğme.

Her şablon kullanılmadan önce Meta tarafından incelenir: Onay genellikle birkaç dakika, bazen de 24 saate kadar sürer. Reddedilen bir şablon, reddedilme nedenini gösterir; Düşük kalite puanı veya alıcılardan gelen çok fazla engelleme/rapor, WhatsApp Business hesabını kısıtlayabilir.

 

Geçmiş, konuşmalar ve alma

SMS'in aksine, WhatsApp Business iki yönlü: Bir kişi size özgürce yazabilir ve mesaj Mokapen'e gerçekten yeni bir konuşma olarak ulaşır.

  • Kişi kartı — geçmiş/zaman çizelgesi hem gönderilen hem de alınan mesajları bir metin önizlemesiyle gösterir.
  • Mesajlar gelen kutusu — WhatsApp konuları, metin arama özelliğiyle aynı birleşik gelen kutusunda SMS ve sohbetin yanında görünür. SMS'in aksine, WhatsApp için Mokapen otomatik olarak mesajları günceller. teslim ve okuma durumu (gönderildi, teslim edildi, okundu) Meta olayları bildirir.
  • Bir kişi size belirli bir mesaja yanıt olarak bile metin, resim, belge, ses, video ve çıkartma gönderebilir: her şey Mesajlar gelen kutusunda aynı başlıkta gelir.

 

Bilmenin sınırları

  • Otomasyonlarda mevcut değil — günümüzde Otomasyon modülü E-posta Gönder ve SMS Gönder işlemlerini sunmaktadır, ancak Olumsuz bir WhatsApp Business eylemi: gönderme yalnızca kişi kartından manuel olarak mümkündür.
  • Serbest biçimli metin yalnızca 24 saat içinde — müşteri hizmetleri penceresinin dışında her zaman Meta'nın onaylı bir şablonuna ihtiyacınız vardır.
  • Bugün iletişimde bir kanal — Gönder düğmesi Kişiler'de mevcuttur; Şirketler veya diğer kartlar için WhatsApp gönderimi henüz arayüzde gösterilmiyor.
  • Numara diğer kullanımlarla paylaşılamaz — WhatsApp Business API aracılığıyla Mokapen'e bağlanan bir numara, kişisel WhatsApp uygulamasında veya başka bir API sağlayıcısında aynı anda aktif kalamaz.
  • Kayıt limiti — Mokapen tarafından değil, Meta tarafından zorunlu kılınan, her 72 saatte bir numara başına maksimum 10 etkinleştirme denemesi.

 

Yaygın sorunlar

  • Bağlantı tamamlanamıyor — doğrulanmış bir Meta Business portföyünüz ve WhatsApp ürününün yapılandırılmış olduğu bağlantılı bir Geliştirici uygulamanızın olup olmadığını kontrol edin ve Yerleşik Kayıt işlemini tekrar deneyin.
  • Numara hâlâ kişisel WhatsApp uygulamasında — telefondaki bu numaranın WhatsApp hesabını silin, yaklaşık 15 dakika bekleyin ve tekrar bağlanmayı deneyin.
  • Numara zaten başka bir API sağlayıcıda — bağlantı sırasında geçiş seçeneğini seçin ve onaylayın; bu numarada iki adımlı doğrulama etkinse, önce WhatsApp Manager'da veya mevcut sağlayıcı aracılığıyla bunu devre dışı bırakın.
  • Yanlış doğrulama PIN'i — WhatsApp Manager'da 6 haneli iki adımlı doğrulama PIN'ini kontrol edin veya yeni geçiş yaptıysanız önceki sağlayıcıyla sıfırlayın.
  • WhatsApp bağlandı ancak webhook aboneliği başarısız oldu — gelen mesajlar görünmeyebilir: Bağlantıyı yeniden denedikten sonra sorun devam ederse Mokapen desteğiyle iletişime geçin.
  • Serbest biçimli mesaj gönderilmiyor — muhtemelen 24 saatlik sürenin dışındasınız: serbest biçimli metin yerine onaylanmış bir şablon seçin.
  • Şablon Meta tarafından reddedildi — belirtilen reddetme nedenini kontrol edin: içerikle eşleşmeyen kategori, yanlış numaralandırılmış veya boşluklu yer tutucular, izin verilmeyen içerik (spam, yanlış aciliyet, hassas veriler) veya uyumlu olmayan format.
  • Yetersiz kredi — Kuruluşun cüzdanına Entegrasyonlar → WhatsApp Business sayfasındaki bağlantıdan veya Faturalandırma bölümünden yükleme yapın.

 

Bağlantı kesiliyor

Entegrasyonlar → WhatsApp Business sayfasından tıklayın Bağlantıyı kes: ile bir pencere açılır Kale bölüm.

  • The Mesajlar ve Şablonlar onay kutusu varsayılan olarak işaretlidir: işaretli bırakıldığında mesaj geçmişi ve senkronize edilmiş şablonlar, bağlantı kesildikten sonra bile Mokapen'de görünür kalır.
  • eğer sen işareti kaldır Mokapen senkronize edilen şablonları, bu entegrasyona bağlı WhatsApp konularını ve mesajlarını ve ayrıca ilgili medya dosyalarını siler.

Her durumda Meta hesabına ve webhook aboneliğine olan bağlantı her zaman kaldırılır. Kullanıcıysanız entegrasyon şuydu: Paylaşıldı (sahibi değil) ile bağlantının kesilmesi yalnızca erişiminizi kaldırır: entegrasyon kuruluş için etkin kalır. Onaylamak için yazın BAĞLANTIYI KES Gerekli alanda.

 

Kullanım örnekleri

  • Sipariş veya randevu onayı — onaylı bir tane kullanın Yardımcı Program Yeni kapatılmış bir siparişi veya ayarlanmış bir randevuyu onaylamak için şablon: müşteri, size henüz yazmamış olsa bile, bir e-posta açmasını beklemek zorunda kalmadan bildirimi alır.
  • Gerçek zamanlı müşteri desteği — bir müşteri size WhatsApp'ta bir soruyla yazıyor: mesaj kişi kartına ve Mesajlar gelen kutusuna ulaşır ve sonraki 24 saat boyunca bir şablona ihtiyaç duymadan serbest biçimli metin, resimler veya belgelerle yanıt verebilirsiniz.
  • Gönderim durumu güncellemesi — Sevkiyat durumu değiştiğinde kişi kartından manuel olarak gönderilen, sipariş numarası ve beklenen tarih için yer tutucuları olan bir Yardımcı Program şablonu.
  • Doğrulama kodu - BİR Kimlik doğrulama Özel bir OTP düğmesine sahip kategori şablonu; bir kişiye güvenilir bir şekilde ve geçmişte izlenen bir güvenlik kodu göndermeniz gerektiğinde kullanışlıdır.
  • Açık rıza içeren kampanya - A Pazarlama şablon, yalnızca işletmeden WhatsApp mesajları almak için (örneğin sezonluk bir promosyonu duyurmak için) açık izin vermiş olan kişilere gönderilir.

 

Sık sorulan sorular

S: Mokapen'deki müşterilerimden SMS'in aksine mesaj alabilir miyim?

C: Evet. WhatsApp Business iki yönlüdür: Bir kişi size yazarsa, mesaj kişi kartında ve Mesajlar gelen kutusunda yeni bir görüşme olarak görünür ve 24 saat içinde serbest biçimli metinle yanıt verebilirsiniz.

 

S: WhatsApp'a bağlanmak için gerçekten bir Meta Business hesabına ihtiyacım var mı?

C: Evet. Doğrulanmış bir Meta Business portföyüne ve WhatsApp ürününün yapılandırılmış olduğu bir Meta Developer uygulamasına ihtiyacınız vardır: bağlantı, telefonun WhatsApp uygulamasında doğrudan oturum açmakla değil, Meta'nın Yerleşik Kaydı aracılığıyla gerçekleşir.

 

S: Numaram zaten normal WhatsApp'ta veya başka bir sağlayıcıda kayıtlı: yine de bağlayabilir miyim?

C: Evet, ancak önce serbest bırakılması veya taşınması gerekiyor: Kişisel WhatsApp uygulamasındaysa söz konusu telefonun hesabını silin ve yaklaşık 15 dakika bekleyin; Zaten başka bir WhatsApp Business API sağlayıcısındaysa bağlantı sırasında taşıma seçeneğini seçin ve onaylayın.

 

S: Bir müşteriye istediğim zaman özgürce yazabilir miyim?

C: Hayır. Serbest biçimli metni yalnızca müşterinin size gönderdiği son mesajdan sonraki 24 saat içinde yazabilirsiniz. Bu pencerenin dışında veya ilk iletişim için Meta tarafından onaylanmış bir şablon kullanmalısınız.

 

S: Bir mesaj şablonunu nasıl oluşturabilirim veya güncelleyebilirim?

C: Ayarlar → Şablonlar'da, WhatsApp Business şunu yazın: şablonu oluşturur veya düzenlersiniz; bu şablon doğrudan Meta'da kaydedilir ve onay için gönderilir. Alternatif olarak, Meta'da zaten onaylanmış şablonlarınız varsa bunları içe aktarmak için Entegrasyonlar → WhatsApp Business sayfasındaki Senkronizasyon şablonlarını kullanın.

 

S: WhatsApp mesajı göndermenin maliyeti ne kadardır?

C: Maliyet, hedef ülkeye ve mesaj kategorisine (pazarlama, yardımcı program, kimlik doğrulama veya 24 saatlik pencere içinde ücretsiz görüşme) bağlıdır. Kredi, gönderim anında kuruluşun cüzdanından düşülür: Entegrasyonlar → WhatsApp Business sayfasında mevcut bakiyeyi kontrol edin.

 

S: WhatsApp Business otomasyonlarda E-posta veya SMS gibi bir işlem olarak kullanılabilir mi?

C: Henüz değil: Bugün Otomasyon modülü yalnızca E-posta Gönder ve SMS Gönder özelliklerini sunuyor. WhatsApp mesajlarını göndermek yalnızca kişi kartından manuel olarak mümkündür.

 

S: Şablonum neden Meta tarafından reddedildi?

C: En yaygın nedenler şunlardır: asıl mesaj içeriğiyle eşleşmeyen bir kategori, yanlış numaralandırılmış veya boşluklu yer tutucular, izin verilmeyen içerik (spam, yanlış aciliyet, hassas veri talepleri) veya yapı kurallarına uymayan bir format. Kesin ret nedeni şablonda Meta tarafından gösterilir.

 

S: Entegrasyonun bağlantısını kesersem verilere ne olur?

C: "Mesajlar ve Şablonlar" onay kutusu işaretlendiğinde (varsayılan), mesaj geçmişi ve senkronize edilen şablonlar Mokapen'de görünür kalır. İşaretini kaldıran Mokapen, bu entegrasyona bağlı şablonları, konuları, mesajları ve medya dosyalarını siler. Meta hesabına olan bağlantı ne olursa olsun her zaman kaldırılır.

 

S: Aynı kuruluşta birden fazla WhatsApp Business numarası kullanabilir miyim?

C: Evet, WhatsApp Business hesabınıza (WABA) bağlı birden fazla numara varsa veya birden fazla hesabı bağlarsanız: Oluşturucuda birden fazla seçenek mevcutsa, göndermeden önce hangisini gönderen olarak kullanacağınızı seçin.

Yardıma mı ihtiyacınız var?