Aller au contenu

Messages Viber

L'API SMSBAT prend en charge plusieurs types de messages Viber pour différents cas d'utilisation, des campagnes promotionnelles aux notifications de transactions.

Présentation des types de messages

Tapez Objectif Médias riches Interactif
viber_promo Campagnes marketing ✅ Images, Vidéos ✅ Boutons
viber_trans Notifications transactionnelles ✅ PDF ❌
viber_carrousel Vitrines de produits ✅ Images ✅ Plusieurs boutons
viber_survey Sondages et commentaires ❌ ✅ Plusieurs options
viber_otp Mots de passe à usage unique ❌ ❌

Promo Viber

Messages promotionnels avec support multimédia riche pour les campagnes marketing.

Contenu pris en charge

  • Image uniquement
  • Texte uniquement
  • Texte + bouton
  • Image + texte + bouton
  • Vidéo + texte
  • Vidéo + texte + bouton
  • Vidéo uniquement

Paramètres

Paramètre Tapez Obligatoire Descriptif
img chaîne Non URL de l'image
vidéo chaîne Non URL du fichier vidéo
vignette chaîne Non Image d'aperçu vidéo
boutonTexte chaîne Non Libellé du bouton d'appel à l'action
boutonAction chaîne Non Cliquez sur le bouton de destination de l'URL
taillefichier entier Non Taille du fichier vidéo en octets
durée entier Non Durée de la vidéo en secondes

Exemples

Texte + Image + Bouton

Texte + Image + Exemple de bouton

{
  "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"
  }
}

Vidéo + Texte + Bouton

Vidéo + Texte + Exemple de bouton

{
  "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"
  }
}

Image uniquement

Exemple d'image uniquement

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

Texte uniquement

Exemple de texte uniquement

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

Vidéo uniquement

Exemple vidéo uniquement

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

Vidéo + Texte

Exemple vidéo + texte

{
  "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 Transactionnel

Notifications de transaction pour les informations urgentes telles que les confirmations de commande et les reçus.

Contenu pris en charge

  • Texte uniquement
  • Fichier PDF + texte
  • Fichier PDF uniquement

Paramètres

Paramètre Tapez Obligatoire Descriptif
fileUrl chaîne Non URL du document PDF
nomfichier chaîne Non Nom d'affichage de la pièce jointe
Type de fichier chaîne Non Type de fichier (utilisez "pdf")

Exemples

Texte uniquement

Exemple de texte uniquement

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

Texte + PDF

Texte + Exemple PDF

{
  "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
}

PDF uniquement

Exemple PDF uniquement

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

Carrousel Viber

Vitrine consultable multi-éléments pour les produits ou le contenu.

Structure

Tableau d'éléments de carrousel, chacun contenant :

  • Titre
  • Image
  • Bouton principal (action principale)
  • Bouton secondaire (action alternative)

Paramètres

Paramètre Tapez Obligatoire Descriptif
carrousel tableau Oui Tableau d'éléments de carrousel
articles tableau Oui Objets de cartes individuels

Exemple

Exemple de carrousel Viber

{
  "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"
          }
        }
      ]
    }
  }
}

Enquête Viber

Sondages interactifs et collecte de commentaires avec options à choix multiples.

Paramètres

Paramètre Tapez Obligatoire Descriptif
enquête objet Oui Conteneur d'enquête
options tableau Oui Tableau de 1 à 5 choix de réponses

Contraintes

  • Maximum 5 options de réponse prises en charge
  • Chaque option doit être concise (recommandé : moins de 30 caractères)

Exemple

Exemple d'enquête Viber

{
  "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

Livraison de mot de passe unique avec des modèles prédéfinis.

Principales fonctionnalités

  • 9 modèles prédéfinis
  • Validation des paramètres (types TEXTE, NUMÉRO)
  • Prise en charge multilingue (19 langues)
  • Noms de variables sensibles à la casse

Langues prises en charge

Ukrainien, anglais, russe, polonais, roumain, espagnol, allemand, français, italien, portugais, néerlandais, turc, arabe, hébreu, hindi, chinois, japonais, coréen, vietnamien

Paramètres

Paramètre Tapez Obligatoire Descriptif
modèleId chaîne (UUID) Oui Identifiant du modèle
templateLang chaîne Oui Code de langue ISO
templateParams objet Oui Modèle de correspondance de variables

Exemple

Exemple Viber OTP

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

Exemple de modèle : "Votre code : 123456. Valable 10 minutes. Ne partagez jamais ce code."

Modèles et validations pris en charge

Viber propose des modèles prédéfinis et strictement contrôlés. Les paramètres de variables transmis doivent correspondre aux types de données corrects.

Types de données : - NUMÉRO : uniquement les chiffres [0-9], +, - et .. Les symboles tels que / ou les espaces ne sont pas pris en charge. - TEXTE : n'importe quel alphabet de langue, symboles (@#$%^&*().,<>;:!\"'+=-()[]{} \n etc). - Mappage régulier : une séquence de <lettres> ne peut pas exister à côté d'une séquence <numéro> ; ils nécessitent une séparation des espaces. Les doubles espaces à l'intérieur des modèles sont généralement interdits. Pour les liens, évitez les espaces s’ils dépassent les limites.

Vous trouverez ci-dessous les 9 modèles ISO standards. Remplacez les identifiants en fonction de vos exigences d’enregistrement dans des pays spécifiques. Contactez l'assistance si vous ajoutez des langues supplémentaires.

1. "Code UNIQUEMENT (n'importe quel code PIN)"

Exigences : Prend en charge les codes PIN en chiffres et en lettres anglaises, les symboles - ou .. Le modèle nécessite un formatage pour afficher correctement votre marque à côté du code PIN de vérification.

2. "Action : Veuillez utiliser ce code"

Paramètres : {pin} (NOMBRE ou TEXTE) Exemple de format : "Veuillez utiliser ce code {pin} pour vérification."

3. "Enregistrement/Accès de la marque"

Paramètres : {business_platform_name} (TEXTE), {pin} (NUMÉRO ou TEXTE) Exemple de format : "Votre code pour {business_platform_name} est {pin}."

4. « Délai de validation du code »

Paramètres : {pin} (NOMBRE/TEXTE), {code_validity_time} (NOMBRE) Exemple de format : "Votre code de vérification est {pin}. Il est valable pendant {code_validity_time} minutes."

5. "Accès à la marque et validation du code"

Paramètres : {business_platform_name} (TEXTE), {pin} (NOMBRE/TEXTE), {code_validity_time} (NOMBRE) Exemple de format : "Le code de vérification {business_platform_name} est {pin} valide pendant {code_validity_time} minutes."

(Remarque : Il existe jusqu'à 9 blocs structurels prédéfinis pour les règles OTP standard de Viber, basées sur des combinaisons d'utilisation de pin, business_platform_name et code_validity_time).

Exigences générales

Tous les types de messages Viber nécessitent :

  • from : identifiant de l'expéditeur alphanumérique
  • 'à' : Numéro de téléphone au format E.164
  • type : identifiant du type de message
  • ttl : délai d'expiration du message en secondes (recommandé)

Revenir aux SMS

Tous les types de messages Viber prennent en charge le secours SMS en utilisant le bloc de tableau « fallbacks ». Si la livraison Viber échoue, le message revient automatiquement sur d'autres canaux configurés.

Promo Viber -> SMS de secours

{
  "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
        }
      ]
    }
  ]
}

Enquête Viber -> SMS de secours

{
  "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 de repli

{
  "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
        }
      ]
    }
  ]
}

meilleures pratiques

Images

  • Utilisez le format JPG ou PNG
  • Taille recommandée : 800x600 pixels
  • Gardez la taille du fichier inférieure à 1 Mo
  • Utilisez des URL HTTPS

Vidéos

  • Utiliser le format MP4
  • Gardez la taille du fichier inférieure à 10 Mo
  • Inclure une image miniature
  • Spécifiez la durée et la taille du fichier

Boutons

  • Gardez le texte du bouton court (2-3 mots) - Utilisez des phrases d'incitation à l'action claires
  • Utilisez toujours des URL HTTPS
  • Testez les URL avant de les envoyer

TTL (durée de vie)

  • Messages promotionnels : 24 à 72 heures
  • Messages transactionnels : 24 heures
  • Messages OTP : 5 à 10 minutes
  • Enquêtes : 7-30 jours

Prochaines étapes