Как начать работать с 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 индивидуальным отправителем.
- Выйдите из песочницы.
Подготовьте облако к работе
Зарегистрируйтесь в 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 на любые российские телефонные номера в формате E.164, например +79991112233.