Центр допомоги Бібліотеки змінних та унікальні промокоди (Variable Pools)

Бібліотеки змінних та унікальні промокоди (Variable Pools)

Бібліотеки змінних та унікальні промокоди (Variable Pools)

Функціонал Variable Pools (Бібліотека змінних) дозволяє автоматично підставляти унікальні значення (наприклад, промокоди, індивідуальні посилання, сертифікати або PIN-коди) у текст повідомлень без необхідності генерувати окремий текст для кожного одержувача на бекенді.

Змінні підставляються через синтаксис {{назва_змінної}} як у базовому тексті повідомлення, так і у каскадних резервних каналах (Viber, SMS).

1. Створення бібліотеки змінних у панелі Omni

  1. Увійдіть у панель SMSBAT Omni.
  2. Перейдіть у розділ Broadcasts -> вкладка Variable pools.
  3. Натисніть кнопку + Create.
  4. У модальному вікні вкажіть:
    • Organization: Оберіть вашу організацію.
    • Variable: Назва змінної без пробілів (наприклад, promo_code).
    • Values: Введіть значення вручну по одному або списком.
    • File: Завантажте CSV або TXT файл зі списком унікальних кодів.
  5. Натисніть Create.

2. Як це працює під час відправки API

Коли ви надсилаєте запит REST API з текстом, що містить {{promo_code}}, система SMSBAT:

  1. Автоматично бере вільне (Unused) значення з вибраного пулу змінної.
  2. Прив’язує його до номера телефону одержувача.
  3. Змінює статус значення на Used із фіксацією точного часу використання (Used at).
  4. Підставляє обраний код замість {{promo_code}} у первинний канал та всі каскадні резервні канали (Viber, SMS).

3. Приклад REST API запиту з використанням змінної

POST /bat/messagelist
Host: restapi.smsbat.com
Content-Type: application/json
X-Authorization-Key: YOUR_API_KEY

{
  "messages": [
    {
      "from": "MasterZoo",
      "to": "380936670003",
      "type": "viber_trans",
      "text": "Вітаю! Ваш промокод: {{promo_code}}\n\nВстигніть використати його до 30.08.2026.",
      "ttl": "30",
      "fallbacks": [
        {
          "from": "MasterZoo",
          "to": "380936670003",
          "type": "sms",
          "text": "Вітаю! Ваш промокод: {{promo_code}}\n\nВстигніть використати його до 30.08.2026."
        }
      ]
    }
  ]
}

4. Перегляд статусів у панелі Omni

У таблиці Variable pools ви можете в реальному часі відстежувати стан кожного коду:

  • Phone number: Номер телефону, який отримав даний код.
  • Value: Сам промокод або динамічне значення.
  • Used: Статус (Unused — вільний, Used — використано).
  • Used at: Точна дата та час прив’язки коду до відправлення.
  • Created At: Дата додавання значення у пул.

Переваги використання Variable Pools

  • 🔒 Захист від дублювання: Кожне значення використовується суворо один раз для одного номера.
  • ⚡ Простота інтеграції: Не потрібно збирати складні індивідуальні шаблони на стороні вашої CRM/ERP.
  • 📊 Прозорий контроль: Завжди видно залишок вільних кодів у пулі.