Отчёт о доставке — это статус, который оператор возвращает для SMS: сообщение доставлено на телефон, завершилось ошибкой либо срок его действия истёк; иногда отчёт содержит код ошибки.
После того как сообщение передано оператору связи, центр коротких сообщений оператора (SMSC) пытается его доставить и сообщает результат обратно по маршруту: «Доставлено» (delivered), если телефон подтвердил получение; «Ошибка» (failed) с указанием причины, если доставить сообщение не удалось; «Срок истёк» (expired), если раньше закончился срок действия. Такое уведомление и есть отчёт о доставке, в терминологии связи — DLR. Именно оно меняет в записях шлюза статус «Отправлено» (sent) на «Доставлено», «Ошибка» или «Срок истёк».
Между операторами и шлюзами отчёты обычно передаются по SMPP в виде коротких текстовых записей с полями вроде stat:DELIVRD, stat:UNDELIV или stat:EXPIRED и кодом ошибки. На этом уровне каждая часть длинного сообщения получает собственный отчёт, поэтому шлюз должен свести их в один статус. Отчёты могут вернуться через несколько секунд, через несколько часов или пакетами, если оператор отправляет их именно так.
Отчёты честны ровно настолько, насколько честен маршрут. Одни операторы возвращают подтверждение доставки на телефон, другие ограничиваются подтверждением приёма, а серые маршруты подделывают отчёты. Чтобы правильно читать отчёт, необходимо знать, что действует в каждой стране. Условный пример: напоминание, отправленное на включённый телефон, через несколько секунд после статуса «Отправлено» получает статус «Доставлено»; то же напоминание, отправленное на телефон, выключенный на три дня, сначала получает статус «Отправлено», а после истечения 48-часового срока действия — «Срок истёк», и никакого «Доставлено» между ними нет.
Три неверных прочтения, которых стоит избегать:
- Принимать «Отправлено» за «Доставлено». Статус «Отправлено» означает лишь, что оператор связи принял сообщение.
- Принимать отсутствие отчёта за ошибку. В некоторых странах подтверждение доставки на телефон не приходит никогда.
- Позволять запоздавшему или повторно отправленному более раннему событию перезаписывать окончательный статус. Статусы меняются только вперёд.
В SMSMeteor: отчёты определяют статус каждого сообщения, а результат приходит к вам событием message.delivered, message.failed или message.expired через вебхук. Большинство направлений возвращают подтверждения доставки на телефон, поэтому «Доставлено» означает, что телефон получил сообщение; некоторые дают только подтверждение оператора связи, и там окончательный положительный статус — «Отправлено». На странице каждой страны указано, какой вариант действует.
