×

Получите 5 готовых email-стратегий для любого бизнеса БЕСПЛАТНО!

После регистрации

меню
Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

Метод sendSms

Метод для простой отправки одного SMS-сообщения одному или нескольким адресатам.

Максимальное количество номеров для отправки SMS: 150 за вызов.

Принцип использования

Синтаксис и URL для вызова метода
sendSms (string phone, string sender, string text)
Пример с одним телефоном:

https://api.unisender.com/ru/api/sendSms?format=json&api_key=KEY&phone=TO&sender=FROM&text=TEXT

Пример с несколькими телефонами:

https://api.unisender.com/ru/api/sendSms?format=json&api_key=KEY&phone=PHONE1,PHONE2&sender=FROM&text=TEXT

Аргументы
api_key *Ключ доступа к API.
phone *Телефон получателя в международном формате с кодом страны (можно опускать ведущий «+»).

Пример:

phone=79092020303

Можно указывать несколько номеров адресатов через запятую.

Максимальное количество номеров за один вызов: 150.

Пример:

phone=79092020303,79002239878
sender *Отправитель –   строка от 3 до 11 латинских букв или цифр с буквами. Также возможны специальные символы – точка, дефис, тире и некоторые другие.

Пример:

     
sender=MyCompany
text *Текст сообщения, до 1000 символов. Символы подстановки типа игнорируются.

Пример:

text=Hello,+it's+a+test+message
text=SMS-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%
D0%B5%D0%BD%D0%B8%D0%B5%2C
Возвращаемое значение
В случае отправки на один номер возвращаемым значением является JSON-объект. Если указано несколько телефонов, то возвращаемым значением является массив JSON-объектов. Поля, составляющие JSON-объект:
currencyТрёхбуквенный международный код валюты, в которой посчитана цена сообщения. Валюта совпадает с валютой вашего счёта (RUB, USD, EUR, UAH).
priceЦена в валюте currency, число с десятичной точкой.
sms_idУникальный цифровой код сообщения. Может использоваться для контроля доставки методом checkSms.

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

Коды ошибок
dest_invalidДоставка невозможна, телефон получателя некорректен.
src_invalidДоставка невозможна, аргумент sender (поле «отправитель») некорректен.
has_been_sentSMS данному адресату уже был отправлен. Допустимый интервал между двумя отправками — 1 минута.
unsubscribed_globallyАдресат глобально отписан от рассылок.

Пример формирования URL-запроса

https://api.unisender.com/ru/api/sendSms?format=json&api_key=KEY
&phone=79998887766&sender=MyCompany&text=Hello,+World!

— отправить сообщение Hello, World на номер +7999887766 с указанием имени отправителя MyCompany.