IOSOR База знань
Стани життєвого циклу повідомлень проти плейбуків доставлятивності
Детальний аналіз стейт-машини SMS від запиту до queued, sent та DLR із урахуванням утримань балансу, вебхуків та правил платформи.
Стани життєвого циклу повідомлень проти плейбуків доставлятивності.
Первинне приймання API та фіксація стану Queued
Під час передачі SMS запиту через API платформа виконує перевірку синтаксису та авторизацію рахунку. Номер отримувача має відповідати стандарту E.164 для надсилання транзакційних OTP повідомлень або сповіщень. До зарахування запису в стейт-машину система перевіряє наявність обов'язкового ліміту USD 20 prepaid floor. За умови успішної перевірки генерується унікальний ідентифікатор, здійснюється тимчасове утримання коштів, а статус змінюється на 'queued'. Це засвідчує успішну первинну аутентифікацію та перевірку схеми даних.
Обробка маршрутизації та перехід у статус Sent
Зі стану 'queued' диспетчер спрямовує запис у конвеєр відправки. На цьому етапі обробляються правила маршрутизації, перевіряється Sender ID та доступність мережевих каналів. Якщо трафік потребує прив'язки номера, система запускає JIT призначення для миттєвого підключення адреси до сесії. Зміна статусу з 'queued' на 'sent' підтверджує успішну передачу пакета до інфраструктури мобільного оператора. У цей момент тимчасове утримання конвертується в остаточне списання з балансу.
Асинхронний прийом DLR та аналіз кодів помилок
Перехід зі стану 'sent' до термінального статусу відбувається асинхронно через звіти про доставку (DLR). Мережа оператора повертає квитанцію зі статусом 'delivered', 'undelivered' або 'failed'. Якщо пристрій поза зоною досяжності, DLR очікує завершення таймерів повтору. Після отримання фінального статусу система фіксує відповідні коди помилок, враховуючи команди STOP та відповіді перевірки Verify OK. Чітке розмежування приймання ('queued'), відправки ('sent') та вручення ('delivered') забезпечує точний аудит.
Фінансові утримання та ліміти балансу
Усі зміни станів жорстко пов'язані з подіями у фінансовому реєстрі та періодичними списаннями MRC. Прийшовши в систему, запит викликает розрахунок резерву відповідно до тарифної сітки префікса та кількості сегментів. Якщо трафік зростає і місячний обсяг проходить soft review near USD 1,000/month, платформа здійснює фонову перевірку акаунта без зупинки черги. Якщо повідомлення відхиляється на етапі 'queued', утримувана сума негайно повертається на предоплачений баланс.
Моніторинг життєвого циклу та налаштування вебхуків
Інтеграція відстеження станів у клієнтські системи здійснюється через підписані HTTP вебхуки. Під час переходів між 'queued', 'sent' та отриманням DLR платформа надсилає сповіщення з ідентифікаторами повідомлень, часовими мітками та кодами помилок. Для вивчення деталей доставлятивності, API та процесів запуску читайте операційний гід з доставляності SMS, вебхуки й ключі на запуску та чекліст купівлі SMS API.
Почніть з IOSOR
Відкрийте консоль IOSOR та перевірте налаштування вебхуків для відстеження статусів E.164 повідомлень у реальному часі. Прослідкуйте шлях тестового запиту від стану 'queued' до фінального асинхронного DLR. Переконайтеся, що обробник подій у вашому додатку коректно фіксує коди помилок та відображає актуальний стан резервування коштів у реєстрі.
Підсумок IOSOR
Ця стаття доводить, що життєвий цикл повідомлення — це детермінований автомат станів, а не інструмент підвищення відсотка доставимості. Переходи від API-прийому до черги, відправки та підтвердження DLR зафіксовані жорсткою логікою системи, де кожен етап синхронізований із фінансовим реєстром та передачею асинхронних статусів.
Робіть фокус на обробці статусних колбеків, точній ідентифікації кодів помилок та синхронізації локальної бази даних із подіями вебхуків. Не плутайте технічне відстеження станів машини із сценаріями підвищення коефіцієнта доставки.
Чи був матеріал корисним?
Пов’язані гіди
- Повідомлення в черзі: холдування балансу замість списання
Дізнайтеся, як IOSOR обробляє черги повідомлень у білінгу. Повідомлення в черзі створює тимчасове резервування коштів, а остаточне списання відбувається лише після відправки.
- Різниця між Queued та Sent в IOSOR: єдиний шлях повідомлення
Дізнайтеся, як фінансовий та продуктовий відділи використовують єдину машину станів для SMS та OTP, від утримання балансу до DLR в IOSOR.