Viber Business Messaging - VeloConnect CPaaS API

Viber Business Messaging API

You need to create Sender in VeloSMS portal and wait for approval. Approval will take 3-5 business days.

Viber Webhook response examples.

For MessageStatus

{
"id": 0,
"userId": 0,
"campaignId": 0,
"from": "string",
"toPhoneNumber": "string",
"international": true,
"sendDate": "2025-08-26T12:34:20.840Z",
"price": 0,
"currency": "string",
"status": "Delivered",
"message": "string",
"actionUrl": "string",
"attachmentUrl": "string",
"attachmentType": "string",
"templateName": "string",
"responseCode": 0,
"detailedError": "string",
"createdAt": "2025-08-26T12:34:20.840Z",
"modifiedAt": "2025-08-26T12:34:20.840Z"
}

For Inbound

{
"id": 0,
"serviceId": "string",
"chatId": "string",
"from": "string",
"to": "string",
"userName": "string",
"type": "Text",
"message": "string",
"attachmentUrl": "string",
"attachmentType": "string",
"receivedAt": "2025-08-26T12:42:10.956Z",
"status": "Delivered",
"campaignId": 0
}

Inbound message types

1 - Text
2 - Image
3 - Video
4 - File
5- TextButton
6 - ImageTextButton
7 - VideoText
8 - VideoTextButton
9 - List
10 - OTP

Message status codes

100 - Sent
0 - Delivered
1 - Seen
2 - Expired
8 - DefaultAutoReply
9 - CustomAutoReply