Mensajes de Viber

La API SMSBAT admite múltiples tipos de mensajes de Viber para diferentes casos de uso, desde campañas promocionales hasta notificaciones de transacciones.

Descripción general de tipos de mensajes

Tipo	Propósito	Medios enriquecidos	Interactivo
`viber_promo`	Campañas de marketing	✅ Imágenes, Vídeos	✅ Botones
`viber_trans`	Notificaciones transaccionales	✅ PDF	❌
`viber_carrusel`	Exhibiciones de productos	✅ Imágenes	✅ Múltiples botones
`viber_encuesta`	Encuestas y comentarios	❌	✅ Múltiples opciones
`viber_otp`	Contraseñas de un solo uso	❌	❌

Promoción de Viber

Mensajes promocionales con soporte rich media para campañas de marketing.

Contenido admitido

Sólo imagen
Sólo texto
Texto + botón
Imagen + texto + botón
Vídeo + texto
Vídeo + texto + botón
Sólo vídeo

Parámetros

Parámetro	Tipo	Requerido	Descripción
`img`	cadena	No	URL de la imagen
`vídeo`	cadena	No	URL del archivo de vídeo
`miniatura`	cadena	No	Imagen de vista previa del vídeo
`textodelbotón`	cadena	No	Etiqueta del botón de llamada a la acción
`botónAcción`	cadena	No	Haga clic en el botón URL de destino
`tamaño de archivo`	entero	No	Tamaño del archivo de vídeo en bytes
`duración`	entero	No	Duración del vídeo en segundos

Ejemplos

Texto + Imagen + Botón

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

Vídeo + Texto + Botón

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

Sólo imagen

Ejemplo de solo imagen

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

Sólo texto

Ejemplo de solo texto

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

Sólo vídeo

Ejemplo de solo vídeo

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

Vídeo + Texto

Ejemplo de vídeo + texto

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

Transaccional de Viber

Notificaciones de transacciones para información urgente, como confirmaciones de pedidos y recibos.

Contenido admitido

Sólo texto
Archivo PDF + texto
Sólo archivo PDF

Parámetros

Parámetro	Tipo	Requerido	Descripción
`URL de archivo`	cadena	No	URL del documento PDF
`nombre de archivo`	cadena	No	Nombre para mostrar del archivo adjunto
`tipo de archivo`	cadena	No	Tipo de archivo (use "pdf")

Ejemplos

Sólo texto

Ejemplo de solo texto

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

Texto + PDF

Texto + Ejemplo de 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
}

Sólo PDF

Ejemplo solo PDF

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

Carrusel de Viber

Escaparate navegable de varios elementos para productos o contenidos.

Estructura

Conjunto de elementos del carrusel, cada uno de los cuales contiene:

Título
Imagen
Botón principal (acción principal)
Botón secundario (acción alternativa)

Parámetros

Parámetro	Tipo	Requerido	Descripción
`carrusel`	matriz	Sí	Matriz de elementos del carrusel
`artículos`	matriz	Sí	Objetos de tarjeta individuales

Ejemplo

Ejemplo de carrusel de 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"
          }
        }
      ]
    }
  }
}

Encuesta de Viber

Encuestas interactivas y recopilación de comentarios con opciones de opción múltiple.

Parámetros

Parámetro	Tipo	Requerido	Descripción
`encuesta`	objeto	Sí	Contenedor de encuesta
`opciones`	matriz	Sí	Matriz de 1 a 5 opciones de respuesta

Restricciones

Se admiten un máximo de 5 opciones de respuesta
Cada opción debe ser concisa (recomendado: menos de 30 caracteres)

Ejemplo

Ejemplo de encuesta de 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"
      ]
    }
  }
}

OTP de Viber

Entrega de contraseña única con plantillas predefinidas.

Características clave

9 plantillas predefinidas
Validación de parámetros (tipos TEXTO, NÚMERO)
Soporte multilingüe (19 idiomas)
Nombres de variables que distinguen entre mayúsculas y minúsculas

Idiomas admitidos

Ucraniano, inglés, ruso, polaco, rumano, español, alemán, francés, italiano, portugués, holandés, turco, árabe, hebreo, hindi, chino, japonés, coreano, vietnamita

Parámetros

Parámetro	Tipo	Requerido	Descripción
`plantillaId`	cadena (UUID)	Sí	Identificador de plantilla
`plantillaLang`	cadena	Sí	Código de idioma ISO
`templateParams`	objeto	Sí	Plantilla de coincidencia de variables

Ejemplo

Ejemplo de OTP de Viber

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

Ejemplo de plantilla: "Tu código: 123456. Válido por 10 minutos. Nunca compartas este código".

Plantillas y validaciones admitidas

Viber ofrece plantillas predefinidas y estrictamente controladas. Los parámetros de variables pasados deben corresponder a los tipos de datos correctos.

Tipos de datos: - NÚMERO: Sólo los números [0-9], +, - y .. No se admiten símbolos como / o espacios en blanco. - TEXTO: Alfabeto de cualquier idioma, símbolos (@#$%^&*().,<>;:!\"'+=-()[]{} \n etc). - Mapeo regular: una secuencia de <letras> no puede existir adyacente a una secuencia <número>; Requieren separación de espacios en blanco. Los espacios en blanco dobles dentro de las plantillas generalmente están prohibidos. Para enlaces, evite los espacios si exceden los límites.

A continuación se muestran las 9 plantillas ISO estándar. Reemplace las identificaciones según sus requisitos de registro en países específicos. Póngase en contacto con el soporte si agrega idiomas adicionales.

1. "SÓLO código (cualquier PIN)"

Requisitos: Admite PIN en números y letras en inglés, símbolos - o .. La plantilla requiere formato para mostrar su marca correctamente junto con el PIN de verificación.

2. "Acción: utilice este código"

Parámetros: {pin} (NÚMERO o TEXTO) Formato de ejemplo: "Utilice este código {pin} para la verificación".

3. "Registro/Acceso a la Marca"

Parámetros: {business_platform_name} (TEXTO), {pin} (NÚMERO o TEXTO) Formato de ejemplo: "Su código para {business_platform_name} es {pin}."

4. "Momento de validación del código"

Parámetros: {pin} (NÚMERO/TEXTO), {code_validity_time} (NÚMERO) Formato de ejemplo: "Su código de verificación es {pin}. Es válido por {code_validity_time} minutos."

5. "Acceso a la marca y validación del código"

Parámetros: {business_platform_name} (TEXTO), {pin} (NÚMERO/TEXTO), {code_validity_time} (NÚMERO) Formato de ejemplo: "El código de verificación de {business_platform_name} es {pin} válido durante {code_validity_time} minutos".

(Nota: Hay hasta 9 bloques estructurales predefinidos para las reglas OTP estándar de Viber basadas en combinaciones del uso de pin, business_platform_name y code_validity_time).

Requisitos generales

Todos los tipos de mensajes de Viber requieren:

de: ID alfanumérico del remitente
to: Número de teléfono en formato E.164
type: Identificador del tipo de mensaje
ttl: tiempo de caducidad del mensaje en segundos (recomendado)

Recurrir a SMS

Todos los tipos de mensajes de Viber admiten el respaldo de SMS utilizando el bloque de matriz "fallbacks". Si la entrega de Viber falla, el mensaje vuelve automáticamente a canales configurados alternativos.

Promoción de Viber -> Reserva de SMS

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

Encuesta de Viber -> Reserva de SMS

{
  "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 -> Reserva de SMS

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

Mejores prácticas

Imágenes

Utilice formato JPG o PNG
Tamaño recomendado: 800x600 píxeles
Mantenga el tamaño del archivo por debajo de 1 MB
Utilice URL HTTPS

Vídeos

Usar formato MP4
Mantenga el tamaño del archivo por debajo de 10 MB
Incluir imagen en miniatura
Especificar duración y tamaño del archivo

Botones

Mantenga el texto del botón breve (2-3 palabras)
Utilice frases claras de llamado a la acción.
Utilice siempre URL HTTPS
Pruebe las URL antes de enviarlas

TTL (tiempo de vida)

Mensajes promocionales: 24-72 horas
Mensajes transaccionales: 24 horas
Mensajes OTP: 5-10 minutos
Encuestas: 7-30 días

Próximos pasos

Mensajes SMS - Obtenga información sobre el respaldo de SMS
Mensajes RCS - Servicios de comunicación enriquecidos
Verificar estado - Seguimiento del estado de entrega