Ana içeriğe geç

Viber Mesajları

SMSBAT API, promosyon kampanyalarından işlem bildirimlerine kadar farklı kullanım durumları için birden fazla Viber mesajı türünü destekler.

Mesaj Türlerine Genel Bakış

Tür Amaç Zengin Medya İnteraktif
'viber_promo' Pazarlama kampanyaları ✅ Resimler, Videolar ✅ Düğmeler
'viber_trans' İşlem bildirimleri ✅ PDF'ler ❌
'viber_carousel' Ürün vitrinleri ✅ Resimler ✅ Çoklu düğmeler
'viber_survey' Anketler ve geri bildirimler ❌ ✅ Çoklu seçenekler
'viber_otp' Tek kullanımlık şifreler ❌ ❌

Viber Promosyonu

Pazarlama kampanyaları için zengin medya desteğine sahip tanıtım mesajları.

Desteklenen İçerik

  • Yalnızca resim
  • Yalnızca metin
  • Metin + düğmesi
  • Resim + metin + düğme
  • Video + metin
  • Video + metin + düğmesi
  • Yalnızca video

Parametreler

Parametre Tür Gerekli Açıklama
'img' dize Hayır Resim URL'si
'video' dize Hayır Video dosyası URL'si
'küçük resim' dize Hayır Video önizleme resmi
'düğmeMetni' dize Hayır Harekete geçirici mesaj düğmesi etiketi
'buttonAction' dize Hayır Düğme tıklama URL'si hedefi
'dosyaBoyutu' tamsayı Hayır Bayt cinsinden video dosyası boyutu
'süre' tamsayı Hayır Saniye cinsinden video uzunluğu

Örnekler

Metin + Resim + Düğme

Metin + Resim + Düğme Örneği

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Summer Sale! Up to 50% off on selected items.",
  "messageData": {
    "img": "https://example.com/summer-sale.jpg",
    "buttonText": "Shop Now",
    "buttonAction": "https://example.com/sale"
  }
}

Video + Metin + Düğme

Video + Metin + Düğme Örneği

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new product demo!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30,
    "buttonText": "Learn More",
    "buttonAction": "https://example.com/product"
  }
}

Yalnızca Resim

Yalnızca Resim Örneği

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "img": "https://example.com/banner.jpg"
  }
}

Yalnızca Metin

Yalnızca Metin Örneği

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Your promo text message"
}

Yalnızca Video

Yalnızca Video Örneği

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Video + Metin

Video + Metin Örneği

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Watch our new video!",
  "messageData": {
    "video": "https://example.com/demo.mp4",
    "thumbnail": "https://example.com/thumbnail.jpg",
    "fileSize": 5242880,
    "duration": 30
  }
}

Viber İşlemsel

Sipariş onayları ve makbuzları gibi zamana duyarlı bilgiler için işlem bildirimleri.

Desteklenen İçerik

  • Yalnızca metin
  • PDF dosyası + metin
  • Yalnızca PDF dosyası

Parametreler

Parametre Tür Gerekli Açıklama
'dosyaUrl' dize Hayır PDF belgesi URL'si
'dosyaAdı' dize Hayır Ekin görünen adı
'dosya Türü' dize Hayır Dosya türü ("pdf" kullanın)

Örnekler

Yalnızca Metin

Yalnızca Metin Örneği

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed and will be delivered tomorrow.",
  "ttl": 86400
}

Metin + PDF

Metin + PDF Örneği

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Thank you for your purchase! Please find your invoice attached.",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Yalnızca PDF

Yalnızca PDF Örneği

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "messageData": {
    "fileUrl": "https://example.com/invoice-12345.pdf",
    "fileName": "Invoice_12345.pdf",
    "fileType": "pdf"
  },
  "ttl": 86400
}

Viber Atlıkarınca

Ürünler veya içerik için çok öğeli göz atılabilir vitrin.

Yapı

Her biri aşağıdakileri içeren atlıkarınca öğeleri dizisi:

  • Başlık
  • Resim
  • Birincil düğme (ana eylem)
  • İkincil düğme (alternatif eylem)

Parametreler

Parametre Tür Gerekli Açıklama
'atlıkarınca' dizi Evet Atlıkarınca öğeleri dizisi
'öğeler' dizi Evet Bireysel kart nesneleri

Örnek

Viber Atlıkarınca Örneği

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "viber_carousel",
  "text": "Check out our featured products",
  "messageData": {
    "carousel": {
      "items": [
        {
          "title": "Product A",
          "imageUrl": "https://example.com/product-a.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-a"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-a/details"
          }
        },
        {
          "title": "Product B",
          "imageUrl": "https://example.com/product-b.jpg",
          "primaryButton": {
            "text": "Buy Now",
            "url": "https://example.com/product-b"
          },
          "secondaryButton": {
            "text": "Details",
            "url": "https://example.com/product-b/details"
          }
        }
      ]
    }
  }
}

Viber Anketi

Çoktan seçmeli seçeneklerle etkileşimli anketler ve geri bildirim toplama.

Parametreler

Parametre Tür Gerekli Açıklama
'anket' nesne Evet Anket konteyneri
'seçenekler' dizi Evet 1-5 cevap seçeneği dizisi

Kısıtlamalar

  • Maksimum 5 yanıt seçeneği desteklenir
  • Her seçenek kısa ve öz olmalıdır (önerilen: 30 karakterden az)

Örnek

Viber Anket Örneği

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "viber_survey",
  "text": "How satisfied are you with our service?",
  "messageData": {
    "survey": {
      "options": [
        "Very Satisfied",
        "Satisfied",
        "Neutral",
        "Dissatisfied",
        "Very Dissatisfied"
      ]
    }
  }
}

Viber OTP

Önceden tanımlanmış şablonlarla tek seferlik şifre teslimi.

Temel Özellikler

  • 9 önceden tanımlanmış şablon
  • Parametre doğrulama (METİN, SAYI türleri)
  • Çoklu dil desteği (19 dil)
  • Büyük/küçük harfe duyarlı değişken adları

Desteklenen Diller

Ukraynaca, İngilizce, Rusça, Lehçe, Rumence, İspanyolca, Almanca, Fransızca, İtalyanca, Portekizce, Felemenkçe, Türkçe, Arapça, İbranice, Hintçe, Çince, Japonca, Korece, Vietnamca

Parametreler

Parametre Tür Gerekli Açıklama
'şablon kimliği' dize (UUID) Evet Şablon tanımlayıcı
'şablon Dili' dize Evet ISO dil kodu
'templateParams' nesne Evet Değişken eşleştirme şablonu

Örnek

Viber OTP Örneği

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "templateId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "templateLang": "en",
    "templateParams": {
      "PIN": "123456",
      "TIME": "10"
    }
  },
  "ttl": 600
}

Şablon örneği: "Kodunuz: 123456. 10 dakika süreyle geçerlidir. Bu kodu asla paylaşmayın."

Desteklenen Şablonlar ve Doğrulamalar

Viber önceden tanımlanmış ve sıkı bir şekilde kontrol edilen şablonlar sunar. Aktarılan değişken parametrelerinin doğru veri türlerine karşılık gelmesi gerekir.

Veri Türleri: - SAYI: Yalnızca [0-9], +, - ve . rakamları. '/' veya boşluk gibi semboller desteklenmez. - METİN: Herhangi bir dil alfabesi, sembolleri (@#$%^&*().,<>;:!\"'+=-()[]{} \n vb.). - Düzenli eşleme: "" dizisi, "" dizisine bitişik olamaz; boşluk ayrımı gerektirirler. Şablonların içinde çift boşluk `` kullanılması genellikle yasaktır. Bağlantılar için sınırları aşan boşluklardan kaçının.

Aşağıda 9 Standart ISO şablonu bulunmaktadır. Belirli ülkelerdeki kayıt gereksinimlerinize göre kimlikleri değiştirin. İlave diller ekliyorsanız destek ekibiyle iletişime geçin.

1. "YALNIZCA Kod (Herhangi bir PIN)"

Gereksinimler: Rakamlar ve İngilizce harfler, - veya . sembollerinden oluşan PIN'leri destekler. Şablon, markanızın doğrulama PIN'inin yanında düzgün şekilde görüntülenmesi için biçimlendirme gerektirir.

2. "İşlem: Lütfen bu kodu kullanın"

Parametreler: {pin} (NUMBER veya TEXT) Örnek biçim: "Doğrulama için lütfen bu kodu {pin} kullanın."

3. "Marka Kaydı/Erişim"

Parametreler: {business_platform_name} (TEXT), {pin} (NUMBER veya TEXT) Örnek biçim: "{business_platform_name} için kodunuz: {pin}."

4. "Kod Doğrulama Zamanlaması"

Parametreler: "{pin}" (NUMBER/TEXT), "{code_validity_time}" (NUMBER) Örnek biçim: "Doğrulama kodunuz: {pin}. {code_validity_time} dakika süreyle geçerlidir."

5. "Marka Erişimi ve Kod Doğrulaması"

Parametreler: "{business_platform_name}" (TEXT), "{pin}" (NUMBER/TEXT), "{code_validity_time}" (NUMBER) Örnek biçim: "{business_platform_name} doğrulama kodu, {code_validity_time} dakika boyunca {pin} geçerlidir."

(Not: "pin", "business_platform_name" ve "code_validity_time" kullanımı kombinasyonlarına dayalı olarak Viber standart OTP kuralları için 9'a kadar önceden tanımlanmış yapısal blok vardır.

Genel Gereksinimler

Tüm Viber mesaj türleri şunları gerektirir:

  • "Kimden": Alfasayısal gönderen kimliği
  • kime: E.164 biçiminde telefon numarası
  • type: Mesaj türü tanımlayıcısı
  • ttl: Saniye cinsinden mesajın sona erme süresi (önerilen)

SMS'e geri dönüş

Tüm Viber mesaj türleri, 'geri dönüşler' dizi bloğunu kullanan SMS geri dönüşünü destekler. Viber teslimatı başarısız olursa mesaj otomatik olarak alternatif yapılandırılmış kanallara geri döner.

Viber Promosyonu -> SMS Geri Dönüşü

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_promo",
      "text": "Your Viber promo message",
      "ttl": 300,
      "messageData": {
        "img": "https://cdn.example.com/image.png",
        "buttonText": "View Offer",
        "buttonAction": "https://example.com"
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "Order #111 is waiting for you in our store",
          "ttl": 5600
        }
      ]
    }
  ]
}

Viber Anketi -> SMS Geri Dönüşü

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_survey",
      "text": "Please share your feedback",
      "ttl": 30,
      "messageData": {
        "survey": {
          "options": [
            "Very Good",
            "Good",
            "Bad"
          ]
        }
      },
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for the survey"
        }
      ]
    }
  ]
}

Viber Trans -> SMS Geri Dönüşü

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "type": "viber_trans",
      "text": "Your account details",
      "ttl": 300,
      "messageData": {},
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "type": "sms",
          "text": "SMS fallback for trans message text",
          "ttl": 5600
        }
      ]
    }
  ]
}

En İyi Uygulamalar

Görseller

  • JPG veya PNG formatını kullanın
  • Önerilen boyut: 800x600 piksel
  • Dosya boyutunu 1 MB'ın altında tutun
  • HTTPS URL'lerini kullanın

Videolar

  • MP4 formatını kullan
  • Dosya boyutunu 10 MB'ın altında tutun
  • Küçük resim resmini ekle
  • Süreyi ve dosya boyutunu belirtin

Düğmeler

  • Düğme metnini kısa tutun (2-3 kelime)
  • Net harekete geçirici mesajlar kullanın
  • Her zaman HTTPS URL'lerini kullanın
  • URL'leri göndermeden önce test edin

TTL (Yaşam Süresi)

  • Promosyon mesajları: 24-72 saat
  • İşlemsel mesajlar: 24 saat
  • OTP mesajları: 5-10 dakika
  • Anketler: 7-30 gün

Sonraki Adımlar