Registo de modelos Viber

As mensagens Viber transacionais são enviadas através de modelos previamente aprovados pela Viber. O modelo é registado diretamente no portal: preenche o texto e as variáveis, o portal submete-o à Viber para aprovação e, depois de aprovado, pode utilizá-lo nos módulos e na API. A forma como os modelos são faturados está descrita na página Tipos de mensagens Viber.

Antes de começar

Um modelo é sempre registado com um remetente Viber específico, pelo que primeiro precisa de um remetente Viber registado. Enquanto não o tiver, a secção de modelos mostra apenas um aviso em vez do formulário.

Criar um modelo

1. No portal, abra Mensagens SMS e Viber → Viber templates.
2. Clique em New template.
3. Preencha o formulário de acordo com a tabela abaixo e, se necessário, acrescente variáveis.
4. Clique em Crio. O portal submete o modelo à Viber para aprovação.

Para um mesmo remetente, a mesma chave não pode ter dois modelos na mesma língua. Outra língua para o mesmo modelo é acrescentada como versão linguística.

Variáveis

Uma variável é um lugar no texto que, no momento do envio, é substituído por um valor concreto, por exemplo um número de encomenda.

• Uma variável é acrescentada com o botão Add variable. Um modelo pode ter no máximo 8.
• Para cada uma preenche o Nome variável (no máximo 50 caracteres) e um Example value (no máximo 125 caracteres). O exemplo é obrigatório — é submetido à Viber juntamente com o modelo para aprovação.
• No texto, uma variável escreve-se como {{name}}. Pode escrevê-la à mão ou inseri-la com o botão {} junto à variável — é inserida no fim do texto.

Exemplo de texto com duas variáveis, number e date:

A sua encomenda {{number}} foi expedida e será entregue {{date}}. Obrigado pela sua compra.

Regras para as variáveis

• Todas as variáveis da lista têm de ser utilizadas no texto.
• O texto não pode conter {{…}} com um nome que não esteja na lista de variáveis.
• Uma variável não pode estar no início do texto. No tipo Transactional também não pode estar no fim.

Modelo OTP

No tipo OTP, o próprio portal acrescenta a variável pin com o valor de exemplo 0451. Nela é inserido o código de verificação quando a mensagem é enviada. A variável pin não pode ser renomeada nem removida e tem de ser utilizada no texto. Ao contrário do que acontece num modelo transacional, também pode estar no fim do texto.

Aprovação do modelo

Depois de criado, o modelo aparece na lista. Para cada versão linguística vê o seu texto, o seu estado e, junto ao estado, o ID do modelo na Viber.

• Pendente — a Viber ainda está a analisar o modelo.
• Approved — pode utilizar o modelo.
• Um modelo recusado não foi aprovado pela Viber e não pode ser utilizado.

O estado na lista muda por si só assim que a Viber analisa o modelo.

Nem um modelo aprovado nem um modelo recusado podem ser editados no portal. Para alterar o texto, elimine a versão linguística e crie-a novamente com a mesma chave — o novo texto volta a passar pela aprovação.

Versões linguísticas

Um modelo pode ter o seu texto em várias línguas. Outra língua é acrescentada com o ícone ⊕ Add language version junto ao modelo na lista. A chave, o nome, o remetente e o tipo mantêm-se — só escolhe a língua, escreve o texto e preenche as variáveis.

Cada versão linguística é aprovada separadamente e tem o seu próprio estado. No envio, escolhe sempre uma versão linguística específica.

Uma versão linguística é eliminada com o ícone do caixote do lixo junto a ela. Após a confirmação, é eliminada tanto no portal como na Viber.

Utilizar um modelo

Nos módulos

Na secção Módulos e APIs abra as definições das notificações e, para o canal Viber, mude o texto da mensagem de texto livre para um modelo registado. Depois escolha-o na lista — só são propostos os modelos aprovados do remetente definido para a notificação, cada versão linguística em separado.

Para cada variável do modelo é apresentado um campo no qual pode inserir variáveis do módulo. Se deixar o campo vazio, é utilizado o valor da variável do módulo com o mesmo nome. O resultado pode ser visto na pré-visualização por baixo dos campos.

Através da API

Na API transacional avançada, o modelo é enviado no objeto viber com estes parâmetros:

A maioria das línguas tem um código de duas letras (cs, sk, en, de…). As exceções são o francês fr_FR, o espanhol es_ES, o português pt_BR e pt_PT e o chinês zh-Hans e zh-Hant.

A API não envia a mensagem através do modelo quando o modelo não existe, não tem a versão linguística pedida, não está aprovado ou não recebe todas as suas variáveis.