[Документация Yandex Cloud](../index.md) > [Yandex Cloud Notification Service](index.md) > Начало работы > Начало работы с SMS

# Как начать работать с SMS в Yandex Cloud Notification Service


Чтобы включить Cloud Notification Service, запросите доступ к сервису у вашего аккаунт-менеджера или в [технической поддержке](https://kz.center.yandex.cloud/support).

Cloud Notification Service (CNS) — сервис для мультиканальной отправки уведомлений пользователям. HTTP API сервиса совместим с [Amazon SNS API](https://docs.aws.amazon.com/sns/latest/api/welcome.html).

В Cloud Notification Service вы можете отправлять [SMS](https://ru.wikipedia.org/wiki/SMS) с помощью _каналов SMS-уведомлений_. Поддерживается отправка SMS на российские телефонные номера в формате [E.164](https://ru.wikipedia.org/wiki/E.164), например `+79991112233`. SMS подписываются текстовыми именами отправителя. Максимальная длина одного SMS — 160 символов латиницей или 70 символов кириллицей. Текст большей длины отправляется в нескольких SMS.


Чтобы начать работу с SMS:
1. [Подготовьте облако к работе](#before-you-begin).
1. [Создайте канал SMS-уведомлений c общим отправителем](#create-common-channel).
1. [Добавьте тестовый номер](#add-test-number).
1. [Отправьте тестовое SMS](#send-test-sms).
1. [Создайте канал SMS-уведомлений c индивидуальным отправителем](#create-individual-channel).
1. [Создайте шаблон SMS](#create-template).
1. [Выйдите из песочницы](#quit-from-sandbox).

## Подготовьте облако к работе {#before-you-begin}

Зарегистрируйтесь в Yandex Cloud и создайте [платежный аккаунт](../billing/concepts/billing-account.md):
1. Перейдите в [консоль управления](https://console.yandex.cloud), затем войдите в Yandex Cloud или зарегистрируйтесь.
1. На странице **[Yandex Cloud Billing](https://center.yandex.cloud/billing/accounts)** убедитесь, что у вас подключен платежный аккаунт, и он находится в [статусе](../billing/concepts/billing-account-statuses.md) `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](../billing/quickstart/index.md) и [привяжите](../billing/operations/pin-cloud.md) к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать [каталог](../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет работать ваша инфраструктура, на [странице облака](https://console.yandex.cloud/cloud).

[Подробнее об облаках и каталогах](../resource-manager/concepts/resources-hierarchy.md).

## Создайте канал SMS-уведомлений c общим отправителем {#create-common-channel}

В Cloud Notification Service сообщения конечным пользователям отправляются через [каналы уведомлений](concepts/index.md#channels).

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

Для такого типа отправителя действуют ограничения:
* все SMS подписываются общим сервисным именем;
* SMS рекламного характера запрещены;
* в [облаке](../resource-manager/concepts/resources-hierarchy.md#cloud) может быть только один канал SMS-уведомлений с общим отправителем;
* работа канала возможна только в [песочнице](concepts/sms.md#sandbox) с ограниченным количеством тестовых телефонных номеров.

Чтобы создать канал c общим отправителем:

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://console.yandex.cloud) выберите каталог, в котором вы хотите создать канал уведомлений.
  1. Перейдите в сервис **Cloud Notification Service**.
  1. Нажмите **Создать канал уведомлений**.
  1. На вкладке **SMS-сообщения** выберите [тип отправителя](concepts/sms.md#senders) **Общий отправитель** и нажмите **Создать**.

{% endlist %}


## Добавьте тестовый номер {#add-test-number}

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

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

Чтобы добавить тестовый номер:

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. Выберите канал уведомлений, созданный ранее.
  1. Перейдите на вкладку ![image](../_assets/console-icons/handset-arrow-in.svg) **Тестовые номера**.
  1. Нажмите кнопку **Добавить тестовый номер**.
  1. В открывшемся окне введите номер телефона и нажмите кнопку **Получить код**. На указанный телефон будет отправлено SMS с кодом подтверждения.

      Поддерживаются российские телефонные номера в формате [E.164](https://ru.wikipedia.org/wiki/E.164), например `+79991112233`.

  1. Введите код из SMS и нажмите кнопку **Подтвердить**.

{% endlist %}

## Отправьте тестовое SMS {#send-test-sms}

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. Напротив тестового номера, добавленного ранее, нажмите ![image](../_assets/console-icons/ellipsis.svg) и выберите ![image](../_assets/console-icons/comment.svg) **Отправить**.
  1. В открывшемся окне введите текст сообщения и нажмите кнопку **Отправить**.

{% endlist %}

## Создайте канал SMS-уведомлений c индивидуальным отправителем {#create-individual-channel}

{% note info %}

Зарегистрировать индивидуальное имя отправителя могут юридические лица или ИП.

{% endnote %}

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

Канал SMS-уведомлений с _индивидуальным отправителем_ подходит для продуктового окружения и имеет следующие преимущества:
* все SMS подписываются уникальным текстовым именем отправителя;
* после выхода из [песочницы](#sandbox) доступна отправка на любые российские телефонные номера в формате [E.164](https://ru.wikipedia.org/wiki/E.164).

Для такого типа отправителя действуют ограничения и правила:
* текстовое имя отправителя будет зарегистрировано у оператора связи;
* за использование текстового имени отправителя будет взиматься ежемесячная абонентская плата;
* в [облаке](../resource-manager/concepts/resources-hierarchy.md#cloud) одному текстовому имени отправителя может соответствовать один канал SMS-уведомлений.

Чтобы создать канал с индивидуальным отправителем:

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://console.yandex.cloud) выберите каталог, в котором вы хотите создать канал уведомлений.
  1. Перейдите в сервис **Cloud Notification Service**.
  1. Нажмите **Создать канал уведомлений**.
  1. На вкладке **SMS-сообщения** выберите тип отправителя **Индивидуальный отправитель**.
  1. Укажите желаемое текстовое имя отправителя и нажмите **Создать**.

{% endlist %}

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

{% note info %}

Регистрация текстового имени отправителя может занять от 2 до 4 недель.

{% endnote %}

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


## Создайте шаблон SMS {#create-template}

[Шаблоны SMS](concepts/sms.md#templates) позволяют разделять SMS-уведомления на различные типы, для каждого из которых установлена своя [стоимость](pricing.md) отправки, и таким образом более эффективно управлять расходами.

Чтобы создать шаблон SMS:

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. В [консоли управления](https://console.yandex.cloud) выберите каталог, в котором вы хотите создать шаблон.
  1. Перейдите в сервис **Cloud Notification Service**.
  1. На панели слева выберите ![route](../_assets/console-icons/route.svg) **Каналы уведомлений** и выберите канал с [индивидуальным отправителем](concepts/sms.md#individual-sender), в котором вы хотите создать шаблон.
  1. В меню слева выберите ![square-chart-bar](../_assets/console-icons/square-chart-bar.svg) **Шаблоны** и нажмите кнопку **Создать шаблон**. В открывшемся окне:

      1. В поле **Имя** задайте имя шаблона.
      1. В поле **Тип** выберите тип создаваемого шаблона:

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

      1. В поле **Шаблон** укажите тело шаблона.

          Текст SMS-уведомлений должен в точности соответствовать шаблону: совпадать должны регистр символов, количество и тип пробелов, а также в тексте не должно быть неописанных специальных символов.

          Подробнее о требованиях к шаблонам читайте в разделе [Содержание шаблона](concepts/sms.md#template-contents).
      1. В поле **Пример сообщения** введите пример текста SMS-уведомления, которое планируется отправлять и которое должно соответствовать создаваемому шаблону.

          Вы не сможете создать шаблон, если пример сообщения не будет соответствовать заданному выше шаблону.
      1. Нажмите кнопку **Создать**.

{% endlist %}

После создания новый шаблон SMS перейдет в [статус](concepts/sms.md#template-status) `Registering` и будет отправлен на регистрацию у операторов связи. При этом будет создано обращение в [службу поддержки](https://kz.center.yandex.cloud/support). Регистрация шаблона занимает от двух до четырех недель. По завершении регистрации шаблона всеми операторами связи шаблон перейдет в статус `Active`, и вы сможете им пользоваться.

## Выйдите из песочницы {#quit-from-sandbox}

Изначально канал SMS-уведомлений с индивидуальным отправителем создается в [песочнице](concepts/sms.md#sandbox).

После отработки функциональности на тестовых номерах вы можете подать заявку на выход из режима песочницы:

{% list tabs group=instructions %}

- Консоль управления {#console}

  1. Выберите канал уведомлений с индивидуальным отправителем, созданный ранее.
  1. Нажмите кнопку **Выйти из песочницы**.

      После этого будет автоматически сформирована заявка в техническую поддержку на выход из песочницы.

      Также вместе с заявкой на выход из режима песочницы можно запросить увеличение [квот](concepts/limits.md#quotas) сервиса.

{% endlist %}

После одобрения заявки вы сможете отправлять SMS на любые российские телефонные номера в формате [E.164](https://ru.wikipedia.org/wiki/E.164), например `+79991112233`.

#### Полезные ссылки {#see-also}

* [Как начать работать с push-уведомлениями](quickstart-sms.md)
* [Как начать работать с сервисом с помощью AWS CLI](tools/aws-cli.md)
* [Обзор сервиса](concepts/index.md)
* [Канал уведомлений SMS](concepts/sms.md)