Canal Viber – promocional

O objeto de canal Viber para Advanced promotional. Coloca-se no objeto channel, sob a chave viber - consulte Cascata.

Importante

As mensagens transacionais utilizam um objeto Viber diferente sob a mesma chave - este contém modelos aprovados em vez de um botão e de uma imagem. Consulte Viber – transacional.

{ "viber": { "sender": "BulkGate", "image": "https://example.com/banner.jpg", "button": { "caption": "Abrir a oferta", "url": "https://example.com/oferta" } } }

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 suporte 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`
button	Estrutura que cria um botão na mensagem, consulte Objeto Button. Sem ela, a mensagem não tem botão	Não	`null`
image	URL de uma imagem apresentada na mensagem	Não	`null`

Objeto Button

NOME DO PARÂMETRO	VALOR	OBRIGATÓRIO	VALOR PREDEFINIDO
caption	Texto do botão	Não	`OK`
url	Endereço URL	Não	`#`

Os valores predefinidos aplicam-se apenas quando o próprio objeto button está presente - "button": {} cria um botão com o texto OK que aponta para #.

Exemplo de pedido completo

Viber com imagem e botão, SMS como alternativa. A parte SMS não tem imagem nem botão, pelo que recorre ao text de nível superior.

POST /api/2.0/advanced/promotional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": ["420777777777", "420777777778"], "text": "Spring sale starts today, up to 50 % off.", "channel": { "viber": { "sender": "BulkGate", "image": "https://example.com/spring-sale.jpg", "button": { "caption": "Open the offer", "url": "https://example.com/spring-sale" } }, "sms": { "sender_id": "gText", "sender_id_value": "BulkGate" } } }

A resposta é igual para todos os canais - consulte Advanced promotional.

Esta página foi útil?

Perguntar à IA Copiado