Код ошибки оператора указывает причину недоставки SMS — например неизвестный или временно недоступный абонент, запрет либо фильтрацию; шлюз сопоставляет такие коды с понятными описаниями ошибок.
Если оператор не может доставить сообщение, ошибка возвращается с кодом от систем, которые пытались это сделать: это могут быть ошибки сигнализации мобильной сети с названиями вроде unknown subscriber, absent subscriber или call barred, значения статуса в отчёте SMPP или собственная нумерация оператора. Коды различаются у разных операторов, протоколов, а иногда и версий программного обеспечения, и один и тот же выключенный телефон в двух сетях может дать разные коды. Поэтому шлюзы сводят их к дюжине или около того устойчивых причин — неизвестный номер, абонент недоступен, запрет, фильтрация, не поддерживается, сетевая ошибка — и сохраняют исходный код на случай, когда он понадобится службе поддержки.
Причина определяет действие, поэтому сопоставление кодов с причинами важнее самого кода:
- Удаляйте неизвестные номера сразу, а заблокированные — если ошибки повторяются.
- Повторяйте позже отправку недоступным абонентам и при временных сетевых ошибках.
- Меняйте что-то в отфильтрованных сообщениях: отправителя, формулировку или ссылку.
- Передавайте в поддержку сетевые ошибки, которые скапливаются у одного оператора.
Условный пример: в кампании 150 ошибок с причиной «сетевая ошибка», 140 из них у одного оператора и все с одним и тем же исходным кодом. Сама причина подсказывает повторить позже; скопление говорит, что проблему нужно передать в поддержку, а исходный код позволяет проверить маршрут. Каждую причину по очереди разбирает руководство о причинах недоставки SMS.
В коде часто допускают две ошибки:
- Строить ветвления логики приложения на исходных кодах. Они различаются у разных операторов; ветвитесь по понятной причине, а исходный код храните рядом.
- Считать каждую ошибку постоянной и удалять номера, абоненты которых были лишь временно недоступны.
В SMSMeteor: каждое сообщение со статусом «Ошибка» содержит исходный код оператора и понятную причину на английском языке: в объекте сообщения API — как carrier_code и failure_reason, как carrier_code и reason — в вебхуке message.failed, а также в отчёте, где ошибки сгруппированы примерно в двенадцать понятных причин. Выгрузки в CSV и JSON содержат код оператора для каждого сообщения.
Связанные термины
- Статусы «ошибка» и «отклонено»
- Неизвестный абонент
- Абонент временно недоступен
- Фильтрация оператором
