Contact UsGet started

Getting started with SMS in Yandex Cloud Notification Service

Written by
Updated at October 28, 2024

Note

The service is at the preview stage.

To enable Cloud Notification Service, request access to the service from your account manager or technical support.

Cloud Notification Service (CNS) is a service for multichannel notifications of users. The service's HTTP API is compatible with the Amazon SNS API.

With Cloud Notification Service, you can send text messages (SMS) using SMS notification channels. Russian phone numbers in E.164 format are supported, e.g., +79991112233. SMS messages are signed with sender text names. The maximum length of one SMS is 160 Latin characters or 70 Cyrillic characters. Longer texts are sent using multiple SMS messages.

To get started with SMS:

  1. Prepare your cloud.
  2. Create an SMS notification channel with a shared sender.
  3. Add a test phone number.
  4. Send a test SMS.
  5. Create a notification channel with an individual sender.
  6. Exit the sandbox.

Prepare your cloud

Sign up for Yandex Cloud and create a billing account:

  1. Go to the management console and log in to Yandex Cloud or create an account if you do not have one yet.
  2. On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one.

If you have an active billing account, you can go to the cloud page to create or select a folder for your infrastructure to operate in.

Learn more about clouds and folders.

Create an SMS notification channel with a shared sender

In Cloud Notification Service, messages to end users are sent through notification channels.

An SMS notification channel with a shared sender is a good option for testing the service's features and has the following advantages:

  • You do not have to register the sender's name with the telecom operator.
  • No monthly subscription fee is charged.

There are restrictions in place for this type of sender:

  • All SMS messages are signed with a shared service name.
  • Promotional SMS messages are not allowed.
  • A cloud can contain only one SMS notification channel with a shared sender.
  • A channel can only operate in a sandbox with a limited number of test phone numbers.

To create a channel with a shared sender:

  1. In the management console, select the folder you want to create a notification channel in.
  2. In the list of services, select Cloud Notification Service.
  3. Click Create notification channel.
  4. In the SMS messages tab, select the producer type: Shared sender. Then click Create channel.

Add a test phone number

A sandbox is a test environment, in which you can send SMS messages only to test phone numbers.

Each test phone number is registered in a channel using a confirmation code from an SMS. By adding a number, you agree to receive messages to it.

To add a test phone number:

  1. Select the notification channel you previously created.

  2. Go to the Test phone numbers tab.

  3. Click Add a test phone number.

  4. In the window that opens, enter a phone number and click Get code. An SMS with a confirmation code will be sent to the specified phone number.

    Russian phone numbers in E.164 format are supported, e.g., +79991112233.

  5. Enter the code from the SMS and click Confirm.

Send a test SMS

  1. Next to a test phone number you previously added, click and select Send message.
  2. In the window that opens, enter the message text and click Send.

Create a notification channel with an individual sender

After practicing on a channel with a shared sender, you can register an SMS notification channel with an individual sender.

An SMS notification channel with an individual sender is suitable for the product environment and has the following advantages:

  • All SMS messages are signed with the sender's unique text name.
  • After leaving the sandbox you can send SMS to any Russian phone numbers in E.164 format.

There are restrictions and rules in place for this type of sender:

  • The sender's text name will be registered with the service provider.
  • You will be charged a monthly subscription fee for using the sender's text name.
  • In the cloud, one sender's text name can correspond to one SMS notification channel.

To create a channel with an individual sender:

  1. In the management console, select the folder you want to create a notification channel in.
  2. In the list of services, select Cloud Notification Service.
  3. Click Create notification channel.
  4. In the SMS messages tab, select the sender type: Individual sender.
  5. Specify the sender’s desired name and click Create.

After that, a ticket to tech support for registration of the sender’s text name will be automatically generated.

Note

Registering a sender's text name may take from 2 to 4 weeks.

When your registration is complete, you will be notified by tech support that you now have access to an individual sender channel.

Exit the sandbox

The SMS notification channel with an individual sender is originally created in the sandbox.

After practicing on test phone numbers, you can apply to exit the sandbox mode:

  1. Select the individual sender notification channel you created earlier.

  2. Click Exit sandbox.

    With that done, a tech support ticket to exit the sandbox will be automatically generated.

    You can also request an increase in the service quotas together with your request to exit the sandbox mode.

Once your request is approved, you will be able to send SMS messages to any Russian phone numbers in E.164 format, e.g., +79991112233.

See also

Previous
Getting started with Push notifications
Next
Overview