Format | Markdown | String to be sent | Appearance on message |
---|---|---|---|
Bold | One asterisk at each end of the text: * | *This text will be bold* | This text will be bold |
Italics | One underscore at each end of the text: _ | _This text will be in italics_ | This text will be in italics |
Monospace | Three backticks at each end of the text: ``` | ```This text will be in monospace``` | This text will be in monospace |
Strikethrough | One tilde at each end of the text: ~ | ~This text will have a strikethrough~ |
Transactional messages
Note that there must be a space between the last markdown symbol and the next word for the formatting to work. For example:
- *Viber*business will be shown as *Viber*business
- *Viber* business will be shown as Viber business
Formatted messages from users will be received on callback text with markdowns.
ℹ️ Only users with Viber version 14.6 and above will be able to see formatting messages; users with older versions will see the markdowns instead.




ℹ️It's highly recommended by Viber that customers use only the secure HTTPS protocol when sending image links.
File type | File formats | File max. size |
---|---|---|
Documents | .doc, .docx, .rtf, .dot, .dotx, .odt, fodt, .txt, .info | 200MB |
.pdf, .xps, pdax, .eps | 200MB | |
Spreadsheet | .xls, .xlsx, .ods, .fods, .csv, .xlsm, .xltx | 200MB |
{ "contentType": "file", "file": { "url": "string", "filename": "string", "type": "doc" } }
Files sent from the user to your business account
Each file sent from the user to you will be stored on Viber’s server for up to 7 days, after which it will no longer be available to download. The file URL can be found in the callback you receive (in the “media” field), with its name displayed in the “file_name” field.
The user also has the option to share files, photos, videos with the business.
Users will also have the option to send a photo, video, or a GIF back to the business using Viber’s internal camera.
Media type | Media formats | Media max size |
---|---|---|
Photos | .jpg, .jpeg, .png, .bmp, .gif, .svg, .webp | No limit (gif - 24MB) |
Videos | .avi, .wmv, .mov, .mp4, .m4v, 3gpp, .3gpp2, .asf, .mkv, .mp2ts, .webm | 100MB |
ℹ️ There is no option to forward other photos or videos from other chats to the selected business chat.
ℹ️ Emojis can be added to the message using emoji codes. Please contact the Onboarding Team at support@tyntec.com for a complete list of emoji codes.
3. Send a message request
To send a simple Viber text message, you provide a recipient phone number (to), specify the channel and channel-specific data, such as your Service ID (from) and the text component of the message with content.
The rateType controls the charging by Viber and the available message types.
The most straightforward request with only required parameters looks as follows:
POST https://api.tyntec.com/conversations/v3/messages { "to": {{receiverPhoneNumber}}", "channel" : "viber", "from": "{{viberServiceId}}", "rateType": "transaction|promotion|session", "content": { "type": "text", "text": "Hello world!" } }
{ "messageId": "8fb360a1-f58c-4af1-932b-8f6651603cd4" }
ℹ️ Check our complete tutorial on how to send a message on Viber.