База знаний

В Messaggio создание и отправка сообщений выполняются с использованием зарегистрированных шаблонов Viber. Для этого перейдите в раздел «Шаблоны», выберите канал Viber и тип шаблона «Транзакционный».

Требования к шаблонам

Транзакционный шаблон может содержать:

• до 1000 символов;
• до 8 переменных;
• каждое значение переменной - до 125 символов.

Переменные задаются в двойных фигурных скобках:

{{name}}
{{account}}
{{debt}}

Ограничения:

• одна и та же переменная может использоваться несколько раз в одном шаблоне;
• транзакционный шаблон не может начинаться или заканчиваться переменной;
• при этом, между первой или последней переменной и текстом должен быть минимум один пробел;
• между двумя переменными обязательно должен присутствовать текст;
• для каждой переменной необходимо указать пример значения;
• OTP-шаблон не может начинаться с переменной;
• OTP-шаблон обязательно должен содержать переменную {{pin}}.

Пример шаблона:

Здравствуйте, {{name}}.
Ваш долг по счёту {{account}} составляет {{debt}}.
Пожалуйста, погасите задолженность в текущем расчётном периоде.

Создание шаблона

Для создания шаблона:

1. Перейдите в раздел «Шаблоны».
2. Выберите канал Viber.
3. Выберите тип шаблона «Транзакционный».
4. Введите текст шаблона.
5. Добавьте переменные вручную (например, {{name}}) либо воспользуйтесь кнопкой добавления переменной.
6. Для каждой переменной укажите пример значения.
7. Сохраните шаблон.
8. Подайте шаблон на модерацию.

После создания шаблона в его карточке будут доступны:

• идентификатор шаблона (Template ID);
• имена всех переменных;
• примеры их значений.

Эти данные используются при отправке сообщений через API.

Отправка сообщений по шаблону

Для отправки сообщения необходимо указать:

• идентификатор зарегистрированного Viber-шаблона;
• значения всех используемых переменных.

Пример тела запроса:

{
    "recipients": [
        {
            "phone": "123456789"
        }
    ],
    "channels": [
        "viber"
    ],
    "viber": {
        "from": "ViberName",
        "label": "transaction",
        "content": [
            {
                "type": "template",
                "template": {
                    "template_id": "b9gff5f38b6c0961",
                    "parameters": {
                        "name": "Алекс",
                        "account": "19888-2",
                        "debt": "80 EUR"
                    }
                }
            }
        ]
    }
}

Если шаблон не содержит переменных, необходимо передать только идентификатор шаблона. Объект parameters в этом случае передавать не нужно.

Использование переменных

Переменные передаются отдельно от текста шаблона.

Шаблон:

Здравствуйте, {{name}}! Ваш заказ приехал.

Параметры:

{
    "name": "Алекс"
}

Получатель увидит:

Здравствуйте, Алекс! Ваш заказ приехал.

Ограничения при использовании ссылок

В значениях переменных нельзя передавать ссылки или полные доменные имена. Такие сообщения могут быть отклонены Viber.

Некорректный пример

Шаблон:

Сайт: {{site}}

Параметры:

{
    "site": "messaggio.com"
}

В данном случае вся ссылка передаётся через переменную, что является недопустимым.

Корректный пример

Шаблон:

Сайт: {{site}}.com

Параметры:

{
    "site": "messaggio"
}

Получатель увидит:

Сайт: messaggio.com

В этом случае переменная содержит только часть текста, а окончание доменного имени является частью самого шаблона, поэтому сообщение проходит проверку.