Viber Business

Как подключить Viber Business Messages через собственный аккаунт Infobip: базовый URL, API-ключ и зарегистрированный отправитель.

Viber Business — официальный бизнес-отправитель в Viber: вы пишете клиентам по номеру телефона, а их ответы приходят в общий список чатов. Канал работает через Infobip — партнёра Viber, и аккаунт Infobip принадлежит вам: Lalexi подключается к нему вашим ключом.

Это не то же самое, что Viber-бот. Бот отвечает только тем, кто написал ему первым, и номеров не знает. Viber Business — наоборот: может написать первым по номеру, но списка чатов у него нет.

Что нужно

Свой аккаунт Infobip с зарегистрированным отправителем Viber Business. Заявку на отправителя подаёт Infobip, а одобряет Viber — без этого подключать нечего, см. ниже.
API-ключ этого аккаунта со скоупами Viber и Subscriptions.
Базовый URL API вашего аккаунта — вида xxxxx.api.infobip.com.
Свободный слот в лимите подключений.

Заявка на отправителя

Это самая долгая часть, и делается она до всего остального. Заявку оформляет партнёр, но собирает данные компания:

Что нужно	Подробности
Письмо гарантий (Warranty Letter)	Обязательства перед Viber: писать только тем, кто дал согласие и не отозвал его; соблюдать законы и правила Viber; не передавать канал третьим лицам; не рекламировать конкурирующие мессенджеры. Подписывает уполномоченное лицо компании; в шапке — юрлицо, адрес штаб-квартиры как в регистрационных документах и бенефициарный владелец (доля от 25%).
Анкета сервиса (Service Qualification Form)	Название сервиса на родном языке и по-английски, сайт, описание, страна регистрации, отрасль.
Логотипы	PNG в шести размерах: 50×50, 65×65, 100×100, 130×130, 256×256 и 360×280.
Страны	Куда будут уходить сообщения.
Объём	Ожидаемое число сообщений в месяц.
Тип сообщений	Рекламные или сервисные, плюс пример вступительного сообщения — без рекламы в нём.
Способ работы	Односторонняя отправка или двусторонняя переписка (нам нужна двусторонняя).

Viber рассматривает заявку обычно два-три дня и выдаёт сервису собственный Service ID. После этого подписывается договор с Infobip, и отправитель включают.

Письмо гарантий — не формальность. По жалобе на спам Viber ждёт ответа в считанные дни и подтверждения согласия того, кому вы написали, а за каждый случай предусмотрен штраф. Собирайте и храните opt-in заранее — восстановить его задним числом не выйдет.

Соберите данные в Infobip

Войдите в личный кабинет Infobip.
Базовый URL API показан на дашборде — скопируйте хост целиком, например xxxxx.api.infobip.com.
API-ключ создайте в разделе Developer tools → API keys, выдав ему скоупы Viber и Subscriptions. Без них Lalexi не сможет ни отправлять сообщения, ни подписаться на входящие.
Отправитель — имя зарегистрированного Viber Business sender, ровно как оно зарегистрировано в вашем аккаунте.

Как подключить

В Lalexi откройте Настройки → Источники (Settings → Inboxes), нажмите Добавить источник (Add Inbox) и выберите плитку Viber Business (Infobip).
Нажмите Подключить — откроется вкладка с формой.
Заполните API base URL, API key и Sender и нажмите Connect. Ключ сразу проверяется запросом к Infobip: если он не подойдёт или у него не хватит скоупов, форма скажет об этом.
Когда появится «Connected», закройте вкладку и вернитесь в Lalexi: источник появится со статусом Подключено.

Форма подключения Viber Business: базовый URL, API-ключ и отправитель

API-ключ — это доступ к вашему аккаунту Infobip. Lalexi хранит его в зашифрованном виде и использует только для отправки и приёма сообщений этого отправителя. Если ключ утёк — отзовите его в Infobip, создайте новый и подключите канал заново.

Что канал умеет и чего не умеет

Может написать первым по номеру телефона — канал доступен в «Новое сообщение», рассылках и прогреве.
Нет списка чатов и истории. Viber не отдаёт бизнес-отправителю список переписок, поэтому настраивать синхронизацию нечего: диалог появляется сам — с первым входящим или после вашего первого сообщения. Переписка до подключения не подтягивается.
Только личные диалоги один-на-один.
Вложения: картинки и видео уходят как медиа, остальные файлы — как файл. Входящее вложение крупнее 25 МБ не зеркалируется.
Длинное сообщение не отклоняется, а режется на части по 1000 символов — это ограничение Viber.

Сколько это стоит

Сообщения этого канала тарифицирует Infobip по вашему договору, а не Lalexi. Ответ оператора в пределах окна после последнего сообщения клиента уходит по более дешёвому диалоговому тарифу; сообщение, начинающее разговор, стоит дороже — точные ставки смотрите в своём кабинете Infobip.

В Расходе и лимитах Lalexi сообщения канала учитываются как обычно: подключение занимает слот, отправленные сообщения считаются платными.

Если что-то не так

Симптом	Что делать
Форма пишет, что ссылка больше не действует	Ссылка живёт 30 минут. Вернитесь в «Добавить источник» и выберите Viber Business (Infobip) заново.
Ключ не принимается	Проверьте базовый URL (только хост, без `https://` и без пути) и скоупы ключа — нужны Viber и Subscriptions.
«Отправитель не найден»	Имя отправителя должно совпадать с зарегистрированным в Infobip посимвольно, включая регистр и пробелы.
Подключено, но диалогов нет	Так и должно быть: списка чатов у канала нет. Диалог появится с первым входящим или после вашего первого сообщения.
Сообщение не дошло	Убедитесь, что у клиента установлен Viber и номер указан в международном формате.