SMS в Yandex Cloud Notification Service

В Cloud Notification Service вы можете отправлять SMS с помощью каналов SMS-уведомлений. Поддерживается отправка SMS на российские телефонные номера в формате E.164, например +79991112233. SMS подписываются текстовыми именами отправителя. Максимальная длина одного SMS — 160 символов латиницей или 70 символов кириллицей. Текст большей длины отправляется в нескольких SMS.

Вы можете создать несколько каналов SMS-уведомлений с разными отправителями. Один из каналов настраивается в качестве канала по умолчанию. Этот канал будет использоваться для отправки SMS, если в запросе API или команде AWS CLI не будет указан конкретный канал.

ОтправителиОтправители

Для каналов SMS-уведомлений предусмотрены следующие типы отправителей:

• общий отправитель;
• индивидуальный отправитель.

Общий отправительОбщий отправитель

Канал SMS-уведомлений с общим отправителем подходит для тестирования функциональности сервиса и имеет следующие преимущества:

• не требуется регистрация имени отправителя у оператора связи;
• не взимается ежемесячная абонентская плата.

Для такого типа отправителя действуют ограничения:

• все SMS подписываются общим сервисным именем;
• SMS рекламного характера запрещены;
• в облаке может быть только один канал SMS-уведомлений с общим отправителем;
• работа канала возможна только в песочнице с ограниченным количеством тестовых телефонных номеров.

Индивидуальный отправительИндивидуальный отправитель

Канал SMS-уведомлений с индивидуальным отправителем подходит для продуктового окружения и имеет следующие преимущества:

• все SMS подписываются уникальным текстовым именем отправителя;
• после выхода из песочницы доступна отправка на любые российские телефонные номера в формате E.164.

Для такого типа отправителя действуют ограничения и правила:

• текстовое имя отправителя будет зарегистрировано у оператора связи;
• за использование текстового имени отправителя будет взиматься ежемесячная абонентская плата;
• в облаке одному текстовому имени отправителя может соответствовать один канал SMS-уведомлений.

Регистрация текстового имени отправителя осуществляется через техническую поддержку.

Изначально канал SMS-уведомлений с индивидуальным отправителем создается в песочнице.

Шаблоны SMSШаблоны SMS

Шаблоны SMS помогают оптимизировать затраты: они определяют тип SMS‑уведомления, от которого зависит стоимость отправки:

• Транзакционный — используется для уведомления о финансовых операциях. Например, о зачислении, списании, переводе и резервировании денежных средств, о начислении процентов по вкладу и т.п.
• Сервисный — используется для уведомления пользователей о статусе услуг, технических работах, изменениях условий обслуживания и т.п.
• Авторизационный — используется для отправки сведений, необходимых для прохождения различных процедур авторизации, верификации, подтверждения каких-либо действий/операций или предоставления согласий.

Если SMS-уведомление не отнесено ни к одному из этих типов, оно по умолчанию считается рекламным.

Шаблоны SMS применяются только в каналах SMS-уведомлений с индивидуальным отправителем.

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

Чтобы удалить шаблон в статусе Active, необходимо предварительно дерегистрировать его на стороне операторов связи. При этом статус шаблона меняется на Deregistering. По завершении дерегистрации шаблона на стороне всех операторов связи шаблон переходит в статус Deregistered, после чего его можно удалить на стороне Cloud Notification Service.

Если вы хотите удалить шаблон в статусе Registering, предварительно отмените его регистрацию. Для этого напишите о вашем намерении в существующем обращении в службу поддержки, сформированном ранее при создании шаблона.

Если шаблон не использовался в течение двух месяцев, он может быть автоматически дерегистрирован на стороне операторов связи и удален из Cloud Notification Service.

Содержание шаблонаСодержание шаблона

Текст шаблона SMS может содержать буквы, цифры и специальные символы¹. Текст шаблона не должен:

• содержать нестандартные пробелы (например, неразрывные);
• начинаться с пробела или заканчиваться пробелом;
• содержать два и более пробела подряд;
• содержать специальные символы, кроме символов, доступных в элементах автоподстановки¹.

Шаблон может содержать следующие элементы автоподстановки (переменные):

¹ Наборы букв и цифр, соответствующие переменным %d и %w, могут также содержать следующие специальные символы: !, №, #, %, ., ,, :, ;, ?, \, /, (, ), +, -, “, ”, ―, _, ', ", `, &, ^, {, }, [, ], <, >, |, @, $, =, ~ и *.

Операция: списание %d руб. Карта *%d. Баланс: %d руб. %w

Операция: списание 1500 руб. Карта *4321. Баланс: 8500 руб. Магазин

Уважаемый клиент! %d с %d до %d проводятся технические работы. Услуга %w будет недоступна.

Уважаемый клиент! 20.03.2026 с 02:00 до 06:00 проводятся технические работы. Услуга интернет-банкинг будет недоступна.

Код подтверждения: %d. Никому не сообщайте этот код.

Код подтверждения: 123456. Никому не сообщайте этот код.

Определение типа SMS-уведомления по шаблонуОпределение типа SMS-уведомления по шаблону

При отправке SMS-уведомления Cloud Notification Service автоматически соотносит текст уведомления с тем или иным шаблоном и тарифицирует сообщение в зависимости от типа шаблона. Для проверки соответствия используются только шаблоны в статусе Active. Проверка на соответствие текста SMS-уведомления шаблону выполняется в следующем порядке:

• Шаблоны сервисных уведомлений;
• Шаблоны авторизационных уведомлений;
• Шаблоны транзакционных уведомлений.

При этом текст уведомления должен в точности соответствовать шаблону: учитывается регистр символов, количество и тип пробелов, также в тексте не должно быть неописанных специальных символов.

Тип SMS‑уведомления определяется по первому подошедшему шаблону. Если шаблон не найден, сообщение считается рекламным.

При отправке можно указать идентификатор конкретного шаблона через атрибут CNS.SMS.TemplateARN. Если текст не соответствует этому шаблону, сообщение не отправится.

Статус шаблонаСтатус шаблона

Шаблон может находиться в одном из следующих статусов:

• Registering — шаблон находится в процессе регистрации у операторов связи.
• Active — шаблон может использоваться при отправке SMS-уведомлений.
• Deregistering — шаблон находится в процессе дерегистрации (прекращения регистрации) у операторов связи. Дерегистрация необходима для удаления шаблона из Cloud Notification Service.
• Deregistered — дерегистрация шаблона у операторов связи завершена. Шаблон может быть удален на стороне Cloud Notification Service.

ПесочницаПесочница

Песочница — это тестовая среда, в которой вы можете отправлять SMS только на тестовые телефонные номера.

Каждый тестовый телефонный номер регистрируется в канале с помощью SMS c кодом подтверждения. Добавляя номер, вы соглашаетесь принимать на него сообщения.

Тестовый номер можно будет удалить спустя 24 часа после его добавления. Чтобы в дальнейшем снова добавить этот номер, потребуется его повторное подтверждение.

Для каналов с индивидуальным отправителем доступен выход из режима песочницы через обращение в техническую поддержку.

Также вместе с заявкой на выход из режима песочницы можно запросить увеличение квот сервиса.

См. такжеСм. также

• Обзор сервиса
• Как начать работать с SMS
• Как начать работать с сервисом с помощью AWS CLI
• Push-уведомления