Как начать работать с SMS в Yandex Cloud Notification Service
Примечание
Сервис находится на стадии Preview.
Чтобы включить Cloud Notification Service, запросите доступ к сервису у вашего аккаунт-менеджера или в технической поддержке.
Cloud Notification Service (CNS) — сервис для мультиканальной отправки уведомлений пользователям. HTTP API сервиса совместим с Amazon SNS API.
В Cloud Notification Service вы можете отправлять SMS с помощью каналов SMS-уведомлений. Поддерживается отправка SMS на российские телефонные номера в формате E.164, например +79991112233. SMS подписываются текстовыми именами отправителя. Максимальная длина одного SMS — 160 символов латиницей или 70 символов кириллицей. Текст большей длины отправляется в нескольких SMS.
Чтобы начать работу с SMS:
- Подготовьте облако к работе.
- Создайте канал SMS-уведомлений c общим отправителем.
- Добавьте тестовый номер.
- Отправьте тестовое SMS.
- Создайте канал SMS-уведомлений c индивидуальным отправителем.
- Создайте шаблон SMS.
- Выйдите из песочницы.
Подготовьте облако к работе
Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:
- Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
- На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе
ACTIVEилиTRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.
Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.
Подробнее об облаках и каталогах.
Создайте канал SMS-уведомлений c общим отправителем
В Cloud Notification Service сообщения конечным пользователям отправляются через каналы уведомлений.
Канал SMS-уведомлений с общим отправителем подходит для тестирования функциональности сервиса и имеет следующие преимущества:
- не требуется регистрация имени отправителя у оператора связи;
- не взимается ежемесячная абонентская плата.
Для такого типа отправителя действуют ограничения:
- все SMS подписываются общим сервисным именем;
- SMS рекламного характера запрещены;
- в облаке может быть только один канал SMS-уведомлений с общим отправителем;
- работа канала возможна только в песочнице с ограниченным количеством тестовых телефонных номеров.
Чтобы создать канал c общим отправителем:
- В консоли управления выберите каталог, в котором вы хотите создать канал уведомлений.
- Перейдите в сервис Cloud Notification Service.
- Нажмите Создать канал уведомлений.
- На вкладке SMS-сообщения выберите тип отправителя Общий отправитель и нажмите Создать.
Добавьте тестовый номер
Песочница — это тестовая среда, в которой вы можете отправлять SMS только на тестовые телефонные номера.
Каждый тестовый телефонный номер регистрируется в канале с помощью SMS c кодом подтверждения. Добавляя номер, вы соглашаетесь принимать на него сообщения.
Чтобы добавить тестовый номер:
-
Выберите канал уведомлений, созданный ранее.
-
Перейдите на вкладку Тестовые номера.
-
Нажмите кнопку Добавить тестовый номер.
-
В открывшемся окне введите номер телефона и нажмите кнопку Получить код. На указанный телефон будет отправлено SMS с кодом подтверждения.
Поддерживаются российские телефонные номера в формате E.164, например
+79991112233. -
Введите код из SMS и нажмите кнопку Подтвердить.
Отправьте тестовое SMS
- Напротив тестового номера, добавленного ранее, нажмите и выберите Отправить.
- В открывшемся окне введите текст сообщения и нажмите кнопку Отправить.
Создайте канал SMS-уведомлений c индивидуальным отправителем
Примечание
Зарегистрировать индивидуальное имя отправителя могут юридические лица или ИП.
После ознакомления с функциональностью сервиса на канале с общим отправителем, вы можете зарегистрировать канал SMS-уведомлений c индивидуальным отправителем.
Канал SMS-уведомлений с индивидуальным отправителем подходит для продуктового окружения и имеет следующие преимущества:
- все SMS подписываются уникальным текстовым именем отправителя;
- после выхода из песочницы доступна отправка на любые российские телефонные номера в формате E.164.
Для такого типа отправителя действуют ограничения и правила:
- текстовое имя отправителя будет зарегистрировано у оператора связи;
- за использование текстового имени отправителя будет взиматься ежемесячная абонентская плата;
- в облаке одному текстовому имени отправителя может соответствовать один канал SMS-уведомлений.
Чтобы создать канал с индивидуальным отправителем:
- В консоли управления выберите каталог, в котором вы хотите создать канал уведомлений.
- Перейдите в сервис Cloud Notification Service.
- Нажмите Создать канал уведомлений.
- На вкладке SMS-сообщения выберите тип отправителя Индивидуальный отправитель.
- Укажите желаемое текстовое имя отправителя и нажмите Создать.
После этого будет автоматически сформирована заявка в техническую поддержку на регистрацию текстового имени отправителя.
Примечание
Регистрация текстового имени отправителя может занять от 2 до 4 недель.
Когда регистрация завершится, вы получите ответ от технической поддержки о предоставлении доступа к каналу с индивидуальным отправителем.
Создайте шаблон SMS
Шаблоны SMS позволяют разделять SMS-уведомления на различные типы, для каждого из которых установлена своя стоимость отправки, и таким образом более эффективно управлять расходами.
Чтобы создать шаблон SMS:
-
В консоли управления выберите каталог, в котором вы хотите создать шаблон.
-
Перейдите в сервис Cloud Notification Service.
-
На панели слева выберите Каналы уведомлений и выберите канал с индивидуальным отправителем, в котором вы хотите создать шаблон.
-
В меню слева выберите Шаблоны и нажмите кнопку Создать шаблон. В открывшемся окне:
-
В поле Имя задайте имя шаблона.
-
В поле Тип выберите тип создаваемого шаблона:
Транзакционный— используется для уведомления о финансовых операциях. Например, о зачислении, списании, переводе и резервировании денежных средств, о начислении процентов по вкладу и т.п.Сервисный— используется для уведомления пользователей о статусе услуг, технических работах, изменениях условий обслуживания и т.п.Авторизационный— используется для отправки сведений, необходимых для прохождения различных процедур авторизации, верификации, подтверждения каких-либо действий/операций или предоставления согласий.
Если SMS-уведомление не отнесено ни к одному из этих типов, оно по умолчанию считается рекламным.
-
В поле Шаблон укажите тело шаблона.
Текст SMS-уведомлений должен в точности соответствовать шаблону: совпадать должны регистр символов, количество и тип пробелов, а также в тексте не должно быть неописанных специальных символов.
Подробнее о требованиях к шаблонам читайте в разделе Содержание шаблона.
-
В поле Пример сообщения введите пример текста SMS-уведомления, которое планируется отправлять и которое должно соответствовать создаваемому шаблону.
Вы не сможете создать шаблон, если пример сообщения не будет соответствовать заданному выше шаблону.
-
Нажмите кнопку Создать.
-
После создания новый шаблон SMS перейдет в статус Registering и будет отправлен на регистрацию у операторов связи. При этом будет создано обращение в службу поддержки. Регистрация шаблона занимает от двух до четырех недель. По завершении регистрации шаблона всеми операторами связи шаблон перейдет в статус Active, и вы сможете им пользоваться.
Выйдите из песочницы
Изначально канал SMS-уведомлений с индивидуальным отправителем создается в песочнице.
После отработки функциональности на тестовых номерах вы можете подать заявку на выход из режима песочницы:
-
Выберите канал уведомлений с индивидуальным отправителем, созданный ранее.
-
Нажмите кнопку Выйти из песочницы.
После этого будет автоматически сформирована заявка в техническую поддержку на выход из песочницы.
Также вместе с заявкой на выход из режима песочницы можно запросить увеличение квот сервиса.
После одобрения заявки вы сможете отправлять SMS на любые российские телефонные номера в формате E.164, например +79991112233.