Viber въвежда задължителни шаблони за трансакционни съобщения от 1 юли 2026 г.

Ако вашият бизнес разчита на платформата на Infobip за изпращане на критични трансакционни съобщения във Viber (като потвърждения за поръчки, детайли за доставка, банкови известия или OTP кодове), предстои мащабна техническа промяна, която изисква незабавното ви внимание.

Считано от 1 юли 2026 г., Viber променя фундаментално своята политика. От тази дата всички трансакционни съобщения ще могат да се изпращат единствено посредством предварително създадени и одобрени шаблони (templates) в клиентските акаунти в Infobip.

За да избегнете прекъсване на комуникацията с вашите клиенти, е необходимо да подготвите и тествате своите шаблони навреме, преди крайния срок.

Какво представлява промяната?

До момента трансакционните съобщения можеха да се изпращат под формата на свободен текст в реално време, съдържайки всякаква информация. След 1 юли 2026 г. всяко съобщение трябва да следва предварително регистрирана и одобрена структура (шаблон), в която постоянният текст е фиксиран, а променливите данни (като име на клиент, номер на поръчка, дата или сума) се подават динамично чрез параметри.

Как се създават и одобряват шаблоните?

Процесът е оптимизиран и гъвкав. Можете да създадете своите шаблони по два начина:

1. През уеб интерфейса на платформата на Infobip (в менюто Channels and Numbers > Channels > Viber for Business).

2. Посредством API (чрез Viber Business Messages API endpoints).

Време за одобрение: Самият процес по одобрение е автоматизиран. Въпреки че официалният срок за преглед е до 24 часа, типично той отнема само няколко секунди до най-много няколко минути. Веднага след като статусът се промени на APPROVED, шаблонът е готов за употреба.

Критични изисквания и ограничения (Constraints)

За да премине интеграцията ви гладко, обърнете внимание на официалните изисквания:

• Запазване на ID номера (Template ID): На шаблоните не може да се задава текстово име. При създаването им системата автоматично генерира уникален ID номер. Изключително важно е да запазите този ID номер във вашите системи, тъй като той се използва за референция към конкретния шаблон при изпращане.

• Максимална дължина: До 875 символа.

• Брой параметри: Допускат се до 5 динамични променливи за персонализация на съобщението.

• Лимит на символите в параметъра: Стойността, подавана за всеки параметър, не трябва да надвишава 25 символа.

• Правило за разделител: Между два последователни параметъра трябва да има поне 3 знака, различни от интервали или пунктуация.

• Завършек на съобщението: Последната дума в шаблона не може да бъде параметър (променлива). След последния параметър трябва да има поне 3 знака.

 Внимание: Бъг при използването на точка (.) в параметрите и неговото решение

При технически тестове за интеграция, екипът ни в Wollow, специализиран в сложни API интеграции, се натъкна на неописан в документацията дефект (бъг). Проблемът е официално потвърден от екипа по поддръжка на Infobip и ескалиран директно към Viber.

Проблемът: Към момента Viber има проблем с обработката на символа точка (.), когато той е част от стойността на даден параметър в шаблона. Ако се опитате да изпратите динамична стойност, съдържаща точка – например сума като {"amount": "200.12"} – съобщението може да се провали или да не се визуализира коректно. Екипът на Viber работи по отстраняването на проблема, но все още няма конкретен срок (ETA) за фикса.

Заобиколно решение (Workaround): Докато бъгът бъде официално отстранен, съветваме ви при регистрацията и тестването на шаблоните да избягвате използването на точка в параметрите. Вместо това използвайте запетая (,) за разделяне на десетичните стойности (напр. 200,12). Уверете се, че вашите системи форматират данните по този начин, преди да ги подадат към Infobip.

Какво трябва да направите сега?

• Ревизирайте текущите си съобщения: Прегледайте всички трансакционни текстове, които изпращате в момента, и ги дефинирайте като шаблони.

• Създайте и регистрирайте шаблоните навреме: Направете го през уеб портала или през API преди 01.07.2026 г.

• Обновете кода си: Конфигурирайте системите си да подават съответното Template ID, съобразете се с ограниченията за параметрите и приложете споменатото по-горе заобиколно решение за десетичните знаци.

• Тествайте: Направете тестови изпращания, за да подсигурите, че всичко работи безпроблемно преди крайния срок.

Пълната техническа документация можете да разгледате на официалния линк на Infobip: Infobip Viber Template Overview.

Не чакайте последния момент – подсигурете стабилността на клиентската си комуникация още днес!