Viber templates API (beta)

DecisionTelecom Viber API allows you to send and receive Viber business messages to and from any country in the world via API. Each message is identified by a unique random ID, so users can always check the status of a message using given endpoint.

The Viber templates API uses HTTPS with access key that is used as the API authorization. Request and response payloads are formatted as JSON using UTF-8 encoding.

API Authorization - Base64 access key.

Please contact your account manager to get an API key.

Auth

Basic Auth

Example:

$userHashKey = 'User Hash Key provided by your account manager';
$ch = curl_init('https://web.it-decision.com/v2/api/create-template-api');
curl_setopt($ch, CURLOPT_RETURNTRANSFER,1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
curl_setopt($ch, CURLOPT_USERPWD, "$userHashKey");
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($requestParams)); // 
$requestParams - raquest array with correct data 
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json')); 
$result = curl_exec($ch); 
curl_close($ch);

Create transactional Viber template

A Transactional Template is a standardized, pre-approved message format for notifications (e.g., order confirmations, shipping updates). It consists of: Fixed Text: Static content that remains constant. Placeholders (Variables): Dynamic fields replaced with recipient-specific data at the time of sending.

Use this request to submit a new template. After creation, the template enters moderation queue. You must await the Approved status before use.

Exceptions:

• The number of Placeholders (Variables) cannot be more than 8

• The number of characters in a Placeholder (Variable) is no more than 125

• Placeholders (Variables) CANNOT BE at the beginning of the text or at the end of the text

POST

https://web.it-decision.com/v2/api/create-viber-template-api

Request POST:

Example for trasactional Viber template:
{
    "name":"Custom name",
    "template":"Dear {{John Doe}}, your {{john_doe}} account expires on {{September 18, 2026}}. Please renew your account using the link https://customsite.com/.",
    "callback_url":"https://customsite.com/templates-callback"
}

Parameters

name: template name - cannot be more than 100 characters

template: A message with example phrases in {{...}} structures that will differ when subsequently sent as transactional messages. When forming a transactional message, these phrases will be used for sending in accordance with the new transactional message types 1701 and 1702. For example, the transactional message sent for the template from the example above would be: Dear Alex Cossack, your alex_cossack account expires on October 15, 2027. Please renew your account using the link https://customsite.com/. Here Alex Cossack, alex_cossack, October 15, 2027 are phrases that can vary in transactional messages of this template.

callback_url: The callback URL to which template approval statuses will be sent.

Response:

JSON (POST)

{
    "success": true,
    "message": "Template successfully created",
    "data": {
        "example": "Dear John Doe, your john_doe account expires on September 18, 2026. Please renew your account using the link https://customsite.com/.",
        "template_text": "Dear {{var1}}, your {{var2}} account expires on {{var3}}. Please renew your account using the link https://customsite.com/.",
        "name": "Custom Name",
        "lang": "en",
        "status_template": "Pending Approval",
        "template_id": "36568982-d84c-42ce-9c72-8caf62cd8b05",
        "created_at": "2026-06-10 06:58:00",
        "id": 46
    }
}

Values:

success: true/false

message: message about success or failure of template creation

data: Object with information about the created template. data.id: Internal ID of the template in the database. data.name: Name of the template. data.template_id: Unique template identifier for your Viber account. data.template_text: Template text with Placeholders (Variables) names. data.example: Generated example message. data.status_template: Current status of the template - Pending Approval, Created, Approved, Rejected. data.created_at: (datetime) Date the template was created. data.lang: Template language.

Receiving statuses at the specified callback_url:

JSON (POST)

{
    "template_id": "0aac888f-2ee2-4112-9659-1755a951966a",
    "status_template": "Approved"
}

template_id: ID received in the API response when creating the template.

status_template: state of template , can be: Pending Approval, Created, Approved, Rejected.

Get Viber template data

POST

 https://web.it-decision.com/v2/api/get-viber-template-api

Request POST:

{
    "id":4291235
}

Parameters

id:

The Internal ID of the template whose status you want to get

Response JSON:

{
    "success": true,
    "message": "Template received successfully",
    "data": {
        "id": 4291235,
        "template_id": "36568982-d84c-42ce-9c72-8caf62cd8b05",
        "name": "Custom Name",
        "template_text": "Dear {{var1}}, your {{var2}} account expires on {{var3}}. Please renew your account using the link https://customsite.com/.",
        "example": "Dear John Doe, your john_doe account expires on September 18, 2026. Please renew your account using the link https://customsite.com/.",
        "status_template": "Approved",
        "created_at": "2026-06-10 06:58:00",
        "lang": "en"
    }
}

Values

success: true/false

message: message about success or failure of get template

data: Object with information about the created template. data.id: Internal ID of the template in the database. data.name: Name of the template. data.template_id: Unique template identifier for your Viber account. data.template_text: Template text with Placeholders (Variables) names. data.example: Generated example message. data.status_template: Current status of the template - Pending Approval, Created, Approved, Rejected. data.created_at: (datetime) Date the template was created. data.lang: Template language.

Errors

Name	Too Many Requests
message	Rate limit exceeded
code	0
status	429

Name	Empty parameter or parameter validation error
message	Invalid Parameter: <param>
code	1
status	400

param:

callback_url is not url

callback_url url wrong scheme

Name	Internal server error
message	Error for template registration on Viber side: <Viber side error>
code	1
status	400

Name	Message Template error
message	Viber Business Account is not configured. Please contact your manager for clarification.
code	7
status	400

Name	Authorization error
message	Unauthorized access
code	6
status	401