Як налаштувати відправку SMS через Alpha SMS

Alpha SMS дозволяє відправляти SMS повідомлення, зокрема OTP (one-time-password) для верифікації клієнтів. Це корисно для надання доступу до широкого набору послуг (знижки, особистий кабінет, можливість онлайн-оплати та інше).

📖 Документація: Детальніше про Alpha SMS API читайте на офіційному сайті.

Передумови

Активний обліковий запис Alpha SMS
API-ключ від Alpha SMS
Зареєстроване alpha ім'я для розсилок

Отримання API ключа

Увійдіть у панель управління Alpha SMS
Перейдіть до розділу API
Створіть або скопіюйте API-ключ

Отримання alpha імені

У панелі Alpha SMS перейдіть до розділу налаштувань
Зареєструйте alpha ім'я для розсилок
Очікуйте на схвалення

Налаштування action sms_alphasms_send

Для відправки SMS використовується action sms_alphasms_send.

Конфігурація

Заповніть JSON-конфіг:

{
  "auth": "635f14be894033beded246d3adf9b199fdd51e06",
  "url": "https://alphasms.ua/api/http.php",
  "sms_signature": "Alpha"
}

Параметри:

auth — ваш API-ключ до сервісу Alphasms
url — API-url для запитів до сервісу Alphasms
sms_signature — alpha ім'я для розсилок (отримується за допомогою сервісу Alphasms)

Необхідні змінні

Для коректної роботи action потрібно мати 3 змінні в state:

otp — згенерований на боці ConnectiveOne OTP
phone — номер користувача, на який буде відправлене SMS повідомлення
id — порядковий номер повідомлення (повинен бути унікальним)

⚠️ Важливо: Змінні повинні бути встановлені в state перед викликом action.

Приклад налаштування сценарію для відправки OTP

Крок 1: Генерація OTP та ID

Використовуйте action для генерації:

{
  "id": "roundTo(random(1)*1000000,0)",
  "otp": "roundTo(random(1)*10000,0)"
}

Пояснення:

id — 6-значний номер повідомлення (генерується випадкове число від 0 до 1, множиться на 1000000, округлюється)
otp — 4-значний OTP для надсилання користувачу (генерується випадкове число від 0 до 1, множиться на 10000, округлюється)

Крок 2: Отримання номера телефону

Отримайте номер телефону користувача через блок "Очікування відповіді користувача" з налаштуванням валідації на номер телефону.

Крок 3: Використання sms_alphasms_send

Після генерації OTP та отримання номера телефону використовуйте action sms_alphasms_send.

Результат: В разі успіху на вказаний номер користувача прийде згенерований раніше OTP-код.

Крок 4: Перевірка введеного коду

Після успішної відправки додайте блок перевірки введеного користувачем коду.

Налаштування json-конфігу для дії if_else:

{
  "if": {
    "{{sended_otp}}=={{otp}}": "ok",
    "event": "ok"
  }
}

Логіка:

Якщо sended_otp дорівнює otp — перехід по події ok
В разі успіху користувач отримує доступ до інформації
А якщо верифікацію не пройдено — йому буде запропоновано повторити спробу чи зв'язатися з оператором

Обробка помилок

Якщо відправка SMS завершилася помилкою, action повертає "error". В сценарії можна обробити цю подію для:

Повторної спроби
Відправки повідомлення користувачу
Передачі до оператора

Обмеження

Налаштування action потребує доступу до API стороннього сервісу відправки SMS та базове знання JSON
Номер телефону повинен бути в правильному форматі (залежить від вимог Alphasms)
OTP код має бути числовим
ID повідомлення повинен бути унікальним

Пов'язані статті

AlphaSMS API Documentation — офіційна документація AlphaSMS
Створити кастомний action — створення кастомних actions через ActionJail