Рассылайте SMS, WhatsApp и Viber и проверяйте доставку в чате

Агент ходит в шлюз SMS Aero по адресу https://gate.smsaero.ru/v2 и работает с тем, что этот API умеет: отправка по номеру или списку номеров сразу, история отправленного, статус каждого сообщения, группы и карточки контактов, чёрный список, проверка живости номера и оператора, остаток и тариф, а также отдельные каналы WhatsApp, Viber и кода в Telegram. Массовая рассылка уходит одним запросом со списком номеров, а не циклом по одному, — так не бывает наполовину отправленной рассылки.

Цена считается по частям: длинный текст разбивается на несколько сообщений, каждое оплачивается отдельно, кириллица укорачивает часть сильнее латиницы, а смешение кириллицы и латиницы внутри одного слова сервис вовсе не пропускает. Числа частей API в ответе не возвращает, поэтому агент считает его сам по длине текста, а цену берёт из тестовой отправки — она возвращает стоимость, но не списывает деньги и не идёт абоненту.

Отправка — действие с деньгами и с чужими телефонами, поэтому агент не запускает её сам. Сначала он показывает текст, подпись отправителя, размер списка и стоимость, и только после вашего подтверждения уходит в рассылку. Дальше он собирает результат по каждому номеру отдельно и отдельным списком выносит те, до которых сообщение не дошло, — с причиной отказа, а не общей фразой об ошибке. Так же он ведёт себя и с необратимым: очистка всех групп или контактов и пополнение баланса с карты идут только по явному подтверждению.

Статус приходит не сразу и не одним шагом: без договора каждое сообщение проходит ручную модерацию до десяти минут, и «на модерации» — это штатное состояние, а не сбой. «Передано оператору» тоже не равно «доставлено», поэтому агент перечитывает статус позже, а не выдаёт одно за другое. Подпись отправителя может быть одобрена не у всех операторов сразу — агент смотрит на разбивку по операторам и предупреждает, если у части абонентов рассылка отобьётся.

Отдельного токена шлюз не выдаёт: каждый запрос подписывается парой значений из кабинета, поэтому перевыпуск ключа обрывает доступ мгновенно — и агент сразу скажет, что подключение нужно обновить, вместо молчаливых повторов. Если в кабинете включён белый список адресов, сервис отвечает отказом, который легко принять за «данных нет», — агент называет причину прямо и не уходит в бесполезные повторы. Списки он дочитывает до конца постранично, а о нехватке данных или прав говорит прямо.