Canal Viber – transacional
O objeto do canal Viber para Advanced transactional. Insere-se no objeto channel, na chave viber - consulte Cascata.
As mensagens promocionais utilizam um objeto Viber diferente na mesma chave - em vez de modelos, contém um botão e uma imagem. Consulte Viber – promocional.
Objeto Viber
| NOME DO PARÂMETRO | VALOR | OBRIGATÓRIO | VALOR PREDEFINIDO |
|---|---|---|---|
| text | Texto da mensagem Viber. Substitui o text de nível superior, consulte Que texto é utilizado |
Não | null |
| sender | Remetente Viber registado. Tem de ser registado primeiro. Para o registo, contacte o apoio aqui | Sim | - |
| expiration | Limite de tempo em segundos após o qual é utilizado o canal seguinte da cascata. Os valores inferiores a 60 são ignorados e substituídos pelo valor predefinido |
Não | 300 |
| template_id | Chave de um modelo Viber aprovado com @ inicial (p. ex. @order-confirmation) ou o ID do modelo no Viber. Quando está preenchido, a mensagem é enviada como modelo e text não é utilizado |
Não | null |
| template_language | Código da versão linguística do modelo. A maioria dos idiomas tem um código de duas letras (cs, en); as exceções são fr_FR, es_ES, pt_BR, pt_PT, zh-Hans e zh-Hant |
Não | en |
| template_parameters | Array associativo de parâmetros do modelo, p. ex.: {"code": "0451"} |
Não | [] |
É o template_id que muda a mensagem para modelo - não o use_template. O parâmetro use_template continua a ser aceite por motivos de compatibilidade com versões anteriores, mas neste endpoint não tem qualquer efeito.
Todas as mensagens Viber transacionais têm de utilizar um modelo previamente aprovado pelo Viber. A forma de registar um modelo está descrita na página Registo de modelos Viber.
Sem template_id, a mensagem não é faturada à tarifa transacional. Uma mensagem Viber enviada através deste endpoint sem modelo é enviada à tarifa promocional; apenas uma mensagem que utilize um modelo aprovado é faturada como transacional.
Exemplo de um pedido completo
Primeiro o Viber, o SMS como alternativa. O text de nível superior é utilizado por ambos os passos da cascata; expiration indica quanto tempo esperamos pelo Viber antes de mudar para SMS.
A mesma mensagem como modelo aprovado. template_id muda o passo Viber para o modelo, pelo que o text de nível superior chega apenas ao passo SMS - e o passo Viber é faturado à tarifa transacional.
A resposta é igual para todos os canais - consulte Advanced transactional.
Obrigado pelo seu feedback.