Ir para o conteúdo

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

Tipo Finalidade Meios interativos Interativo
viber_promo Campanhas de marketing ✅ Imagens, vídeos ✅ Botões
viber_trans Notificações transacionais ✅ PDFs ❌
viber_carousel Vitrines de produtos ✅ Imagens ✅ Vários botões
viber_survey Enquetes e comentários ❌ ✅ Múltiplas opções
viber_otp Senhas 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âmetro Tipo Obrigatório Descrição
img corda Não URL da imagem
vídeo corda Não URL do arquivo de vídeo
miniatura corda Não Imagem de visualização do vídeo
buttonText corda Não Etiqueta do botão de call to action
botãoAção corda Não Destino do URL de clique no botão
tamanhodoarquivo inteiro Não Tamanho do arquivo de vídeo em bytes
duração inteiro Não Duraçã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âmetro Tipo Obrigatório Descrição
arquivoUrl corda Não URL do documento PDF
NomeArquivo corda Não Nome de exibição do anexo
tipo de arquivo corda Não Tipo 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âmetro Tipo Obrigatório Descrição
carrossel matriz Sim Matriz de itens do carrossel
itens matriz Sim Objetos 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âmetro Tipo Obrigatório Descrição
pesquisa objeto Sim Contêiner de pesquisa
opções matriz Sim Matriz 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âmetro Tipo Obrigatório Descrição
templateId string (UUID) Sim Identificador do modelo
templateLang corda Sim Código de idioma ISO
templateParams objeto Sim Modelo 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