Как отправить СМС, сгенерированные системой

Введение

Каждое сообщение «Ваш OTP — 4821», уведомление о доставке или напоминание о встрече, которое вы когда-либо получали, почти наверняка никогда не печаталось человеком. Это был SMS, генерируемое системой — текстовое сообщение, которое часть программного обеспечения отправляет автоматически в момент возникновения определенного события, без необходимости открытия телефона или входа в панель управления. Компании полагаются на это по простой причине: это самый быстрый и надежный способ связаться с клиентом в тот момент, когда происходит что-то, что его волнует.

В этом руководстве подробно описано, что такое SMS-сообщение, генерируемое системой, как на самом деле работает автоматизация, наиболее распространенные способы его использования в компаниях, а также практический, пошаговый путь к отправке вашего первого SMS, включая то, как это выглядит на Питон и PHP, о которых больше всего спрашивают разработчики этих двух языков.

Ключевые выводы

• Сгенерированное системой SMS-сообщение автоматически отправляется программным обеспечением через СМС API — не требуется ввод вручную или вход в систему.
• Три вещи заставляют его работать: триггер (событие), вызов API и шлюз SMS, который доставляет текст.
• Чаще всего используются OTP-коды, обновления о доставке, напоминания о встречах и оповещения учетной записи.
• Для отправки требуется ключ API, конечная точка REST и несколько строк кода практически на любом языке, включая Python и PHP.
• Обработка согласия и отказа (STOP) не является обязательной — именно она обеспечивает законность автоматических SMS и защиту ваших номеров от блокировки.

Что такое SMS, генерируемое системой?

Сгенерированное системой SMS (также называемое автоматическим текстовым сообщением или транзакционным SMS) — это сообщение, созданное и отправленное приложением, а не человеком. Вместо того, чтобы кто-то открывал приложение для обмена сообщениями и набирал «Ваш заказ отправлен», фрагмент кода обнаруживает, что статус заказа изменился на «отправлен», и сам выдает этот точный текст за миллисекунды.

Разница, которая на самом деле имеет значение, заключается не в формулировке сообщения — человек может напечатать то же самое предложение. Его кто или что нажимает отправить. SMS-сообщение, формируемое системой, запускается по коду, реагирующему на событие: попытка входа в систему, совершенный платеж, доведение обратного отсчета до нуля, изменение статуса в базе данных. Никто не готов отправить его вручную, и именно поэтому он может дойти до кого-то за секунды, 24 часа в сутки, в любом масштабе.

Как работают SMS, генерируемые системой?

Каждый автоматизированный текст — независимо от платформы, на которой он стоит — сводится к одним и тем же трем движущимся частям:

• Триггер. Событие, за которым отслеживает ваше программное обеспечение: новая регистрация, подтверждение оплаты, обновление статуса доставки или просто запланированное время (например, «за 24 часа до встречи»).
• Вызов SMS API. Когда триггер срабатывает, ваше приложение отправляет HTTP-запрос на шлюз SMS — номер получателя, текст сообщения и ваш ключ API, упакованные в формате JSON.
• Доставка через шлюз. Шлюз передает сообщение оператору мобильной связи получателя и — для таких платформ, как SMSLocal — сообщает, было ли оно доставлено.

Этот средний шаг и есть та часть, которая фактически делает автоматизацию возможной: СМС API. SMS API — это всего лишь определенный способ, с помощью которого одна часть программного обеспечения может запросить другую — «отправить этот текст на этот номер» — посредством стандартного веб-запроса, точно так же, как браузер запрашивает у сервера веб-страницу. Собственный API-интерфейс HTTP-to-SMS SMSLocal — это REST API: он принимает простой HTTP-запрос с входным и выходным JSON, авторизуемый с помощью ключа доступа вместо имени пользователя и пароля — та же форма. Собственная документация Twilio по SMS API. описывает. Если ваше программное обеспечение может отправлять HTTP-запросы — а практически все современные программы могут — оно может отправлять сгенерированные системой SMS.

Распространенные типы SMS, генерируемых системой

Почти каждое автоматическое сообщение, которое отправляет компания, попадает в одну из нескольких категорий. Вот для чего предназначен каждый из них:

Сообщения OTP заслуживают отдельного внимания: они имеют самую высокую срочность среди всех автоматических текстовых сообщений (код, срок действия которого истекает через несколько минут), поэтому они обычно направляются по выделенному пути отправки с высоким приоритетом, а не по той же очереди, что и рекламные сообщения.

Как отправить SMS, сгенерированное системой: шаг за шагом

1. Выберите поставщика SMS API. Ищите REST API с поддержкой JSON, четкими ценами за каждое сообщение и отчетами о доставке — вам нужно будет подтвердить, что текст действительно прибыл, а не просто был отправлен.
2. Получите ключ API. После создания учетной записи сгенерируйте ключ доступа на панели управления. Этот ключ авторизует каждый запрос вместо входа в систему по имени пользователя и паролю — именно это исключает этап «входа вручную» из процесса.
3. Определите свой триггер. Решите в своем приложении, какое именно событие должно вызывать появление текста — срабатывание веб-перехватчика, изменение строки базы данных или выполнение запланированного задания.
4. Создайте шаблон сообщения. Напишите текст один раз, добавив заполнители для изменяющихся частей — имени, номера заказа, кода — чтобы один и тот же шаблон мог обслуживать каждого получателя.
5. Отправьте запрос. Когда триггер срабатывает, ваш код отправляет HTTP POST в конечную точку API с номером получателя, заполненным сообщением и вашим ключом API.
6. Подтвердите доставку и запишите результат. Проверьте отчет о доставке, который возвращает API, и сохраните его — если сообщение не удалось, вы хотите узнать об этом немедленно, а не тогда, когда клиент пожалуется.

Отправка сгенерированных системой SMS с помощью Python и PHP

Поскольку базовый API — это всего лишь HTTP и JSON, программная отправка текста выглядит почти одинаково, независимо от того, на каком языке написано ваше приложение — меняется только синтаксис для выполнения запроса.

Питон

Python не нуждается в специализированной библиотеке SMS для отправки сгенерированного системой текста — стандарт запросы пакета достаточно. Вы создаете небольшой словарь с номером получателя, сообщением и вашим ключом API, отправляете его POST в конечную точку API как JSON и считываете ответ JSON, чтобы подтвердить, что сообщение было принято. Это шаблон, лежащий в основе большинства сценариев автоматизации «Python send message»: запланированное задание или обработчик событий, который вызывает одну и ту же функцию каждый раз, когда ему нужно отправить кому-то сообщение.

PHP

Наиболее распространенный путь PHP — встроенный КУЛЬ расширение: инициализируйте сеанс cURL, указывающий на конечную точку API, прикрепите полезные данные JSON и ключ API в качестве заголовка, выполните запрос и декодируйте ответ. Поскольку для этого не требуется ничего, кроме того, что уже поставляется со стандартной установкой PHP, именно поэтому в документации SMSLocal отмечается, что «если вы способны создать веб-страницу с формой, поддерживаемой языком сценариев, таким как PHP, вы уже готовы отправлять автоматические SMS-сообщения».

Node.js и Java имеют одинаковую форму — HTTP-клиент, тело JSON и ваш ключ API в запросе. После того как вы отправили одно SMS-сообщение, сгенерированное системой, на любом языке, отправка следующего на другом языке в основном представляет собой замену синтаксиса.

Преимущества SMS, генерируемых системой

• Скорость. Путь от триггера до доставки измеряется в секундах, а не в минутах или часах, которые занимает ручной процесс.
• Последовательность. Одно и то же событие всегда выдает одно и то же сообщение, при этом ни одна из опечаток или пропущенных ошибок не приводит к рискам обработки вручную.
• Шкала. Отправка 10 автоматических текстовых сообщений требует тех же усилий, что и отправка 10 000 — в любом случае код работает одинаково.
• Круглосуточное освещение. OTP или оповещение о доставке срабатывает в 3 часа ночи точно так же надежно, как и в 15:00.
• Меньшая опорная нагрузка. Проактивные обновления («ваш заказ отправлен») предотвращают вопрос «где мой заказ?» билет до того, как он будет написан.

Лучшие практики для автоматических текстовых сообщений

• Сначала получите явное согласие. Достаточно формы регистрации или ответа по ключевому слову, но автоматические текстовые сообщения должны отправляться только на те номера, которые согласились их получать.
• Всегда поддерживайте СТОП. Для каждого сообщения нужен работающий и немедленный способ отказаться от рассылки — это одновременно требование соответствия и элементарное уважение к получателю.
• Делайте шаблоны короткими и конкретными. «Ваш заказ № 4482 отправлен, прибывает в четверг» — это больше, чем абзац: SMS — это канал быстрого доступа.
• Отделяйте срочное от рекламного. Направляйте одноразовые пароли и оповещения системы безопасности по отдельному пути с более высоким приоритетом, чем для маркетинговых сообщений.
• Отслеживайте отчеты о доставке. Незаметный сбой в сообщении OTP означает блокировку клиента — проверьте статус, не предполагайте успеха.

Подведение итогов

Сгенерированное системой SMS — это не что иное, более экзотическое, чем код, реагирующий на событие и отправляющий HTTP-запрос, но именно эта простота делает его мощным. После установки триггера, API SMS и шаблона сообщения OTP, уведомление о доставке или напоминание могут быть доставлены клиенту за считанные секунды, в любой час и в любом масштабе, при этом ни один человек не нажмет кнопку «Отправить». Независимо от того, исходит ли этот запрос от Python, PHP, Node.js или Java, форма работы одинакова: определить событие, шаблонизировать сообщение, вызвать API и подтвердить его получение.