Help Center Mensagens Viber

Mensagens Viber

A API SMSBAT oferece suporte a vários tipos de mensagens Viber para diferentes casos de uso, desde campanhas promocionais até notificações de transações.

Visão geral dos tipos de mensagens

TipoFinalidadeMeios interativosInterativo
viber_promoCampanhas de marketing✅ Imagens, vídeos✅ Botões
viber_transNotificações transacionais✅ PDFs❌
viber_carouselVitrines de produtos✅ Imagens✅ Vários botões
viber_surveyEnquetes e comentários❌✅ Múltiplas opções
viber_otpSenhas de uso único❌❌

Promoção Viber

Mensagens promocionais com suporte rich media para campanhas de marketing.

Conteúdo Suportado

  • Somente imagem
  • Somente texto
  • Texto + botão
  • Imagem + texto + botão
  • Vídeo + texto
  • Vídeo + texto + botão
  • Somente vídeo

Parâmetros

ParâmetroTipoObrigatórioDescrição
imgcordaNãoURL da imagem
vídeocordaNãoURL do arquivo de vídeo
miniaturacordaNãoImagem de visualização do vídeo
buttonTextcordaNãoEtiqueta do botão de call to action
botãoAçãocordaNãoDestino do URL de clique no botão
tamanhodoarquivointeiroNãoTamanho do arquivo de vídeo em bytes
duraçãointeiroNãoDuração do vídeo em segundos

Exemplos

Texto + Imagem + Botão

Exemplo de texto + imagem + botão

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

Exemplo de vídeo + texto + botão

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

Somente imagem

Exemplo apenas de imagem

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

Somente texto

Exemplo apenas de texto

CODE_BLOCO_3

Somente vídeo

Exemplo apenas de 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

Exemplo de vídeo + texto

CODE_BLOCO_5

Viber Transacional

Notificações de transações para informações urgentes, como confirmações de pedidos e recibos.

Conteúdo Suportado

  • Somente texto
  • arquivo PDF + texto
  • Somente arquivo PDF

Parâmetros

ParâmetroTipoObrigatórioDescrição
arquivoUrlcordaNãoURL do documento PDF
NomeArquivocordaNãoNome de exibição do anexo
tipo de arquivocordaNãoTipo de arquivo (use “pdf”)

Exemplos

Somente texto

Exemplo apenas de texto

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

Texto + PDF

Exemplo de texto + 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
}

Somente PDF

Exemplo apenas em PDF

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

Carrossel Viber

Vitrine navegável com vários itens para produtos ou conteúdo.

Estrutura

Matriz de itens do carrossel, cada um contendo:

  • Título
  • Imagem
  • Botão primário (ação principal)
  • Botão secundário (ação alternativa)

Parâmetros

ParâmetroTipoObrigatórioDescrição
carrosselmatrizSimMatriz de itens do carrossel
itensmatrizSimObjetos de cartão individuais

Exemplo

Exemplo de carrossel Viber

CODE_BLOCO_9

Pesquisa Viber

Enquetes interativas e coleta de feedback com opções de múltipla escolha.

Parâmetros

ParâmetroTipoObrigatórioDescrição
pesquisaobjetoSimContêiner de pesquisa
opçõesmatrizSimMatriz de 1 a 5 opções de resposta

Restrições

  • Máximo de 5 opções de resposta suportadas
  • Cada opção deve ser concisa (recomendado: menos de 30 caracteres)

Exemplo

Exemplo de pesquisa do 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

Entrega de senha única com modelos predefinidos.

Principais recursos

  • 9 modelos predefinidos
  • Validação de parâmetros (tipos TEXT, NUMBER)
  • Suporte multilíngue (19 idiomas)
  • Nomes de variáveis que diferenciam maiúsculas de minúsculas

Idiomas Suportados

Ucraniano, Inglês, Russo, Polonês, Romeno, Espanhol, Alemão, Francês, Italiano, Português, Holandês, Turco, Árabe, Hebraico, Hindi, Chinês, Japonês, Coreano, Vietnamita

Parâmetros

ParâmetroTipoObrigatórioDescrição
templateIdstring (UUID)SimIdentificador do modelo
templateLangcordaSimCódigo de idioma ISO
templateParamsobjetoSimModelo de correspondência de variáveis ​​

Exemplo

Exemplo de OTP do Viber

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

Exemplo de modelo: “Seu código: 123456. Válido por 10 minutos. Nunca compartilhe este código.”

Modelos e validações compatíveis

O Viber oferece modelos predefinidos e estritamente controlados. Os parâmetros de variáveis ​​passados ​​devem corresponder aos tipos de dados corretos.

Tipos de dados:

  • NUMBER: Somente numerais [0-9], +, - e .. Símbolos como / ou espaços em branco não são suportados.
  • TEXTO: Alfabeto de qualquer idioma, símbolos (@#$%^&*().,<>;:!\"'+=-()[]{} \n etc).
  • Mapeamento regular: Uma sequência de <letras> não pode existir adjacente a uma sequência de <número>; eles exigem separação de espaços em branco. Espaços em branco duplos “ dentro dos templates são geralmente proibidos. Para links, evite espaços caso ultrapassem os limites.

Abaixo estão os 9 modelos ISO padrão. Substitua os IDs com base nos seus requisitos de registro em países específicos. Entre em contato com o suporte se adicionar idiomas adicionais.

1. “SOMENTE código (qualquer PIN)”

Requisitos: Suporta PINs em números e letras inglesas, símbolos - ou .. O modelo requer formatação para exibir sua marca corretamente junto com o PIN de verificação.

2. “Ação: use este código”

Parâmetros: {pin} (NÚMERO ou TEXTO) Formato de exemplo: “Use este código {pin} para verificação.”

3. “Registro/Acesso à Marca”

Parâmetros: {business_platform_name} (TEXT), {pin} (NUMBER ou TEXT) Formato de exemplo: “Seu código para {business_platform_name} é {pin}.“

4. “Tempo de validação de código”

Parâmetros: {pin} (NÚMERO/TEXTO), {code_validity_time} (NÚMERO) Formato de exemplo: “Seu código de verificação é {pin}. É válido por {code_validity_time} minutos.”

5. “Acesso à marca e validação de código”

Parâmetros: {business_platform_name} (TEXT), {pin} (NUMBER/TEXT), {code_validity_time} (NUMBER) Formato de exemplo: “O código de verificação {business_platform_name} é {pin} válido por {code_validity_time} minutos.”

(Nota: Existem até 9 blocos estruturais predefinidos para regras OTP padrão do Viber com base em combinações de uso de pin, business_platform_name e code_validity_time).

Requisitos Gerais

Todos os tipos de mensagens do Viber exigem:

  • from: ID alfanumérico do remetente
  • to: Número de telefone no formato E.164
  • type: identificador do tipo de mensagem
  • ttl: Tempo de expiração da mensagem em segundos (recomendado)

Alternativa para SMS

Todos os tipos de mensagens do Viber suportam fallback de SMS utilizando o bloco de array fallbacks. Se a entrega do Viber falhar, a mensagem retornará automaticamente para canais configurados alternativos.

Promoção Viber -> SMS substituto

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

Pesquisa Viber -> Substituição 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 -> SMS substituto

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

Melhores práticas

Imagens

  • Use o formato JPG ou PNG
  • Tamanho recomendado: 800x600 pixels
  • Mantenha o tamanho do arquivo abaixo de 1 MB
  • Use URLs HTTPS

Vídeos

  • Use o formato MP4
  • Mantenha o tamanho do arquivo abaixo de 10 MB
  • Incluir imagem em miniatura
  • Especifique a duração e o tamanho do arquivo

Botões

  • Mantenha o texto do botão curto (2-3 palavras)
  • Use frases de chamariz claras
  • Sempre use URLs HTTPS
  • Teste URLs antes de enviar

TTL (tempo de vida)

  • Mensagens promocionais: 24-72 horas
  • Mensagens transacionais: 24 horas
  • Mensagens OTP: 5 a 10 minutos
  • Pesquisas: 7 a 30 dias

Próximas etapas