Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

Метод sendSms

Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages

Метод для простой отправки одного 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 латинских букв или цифр с буквами. Также возможны специальные символы – точка, дефис, тире и некоторые другие.

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

Пример:

     
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 (поле «отправитель») некорректен.
invalid_arg Доставка невозможна, аргумент sender некорректен (альфа-имя отправителя не зарегистрировано).
has_been_sent SMS данному адресату уже был отправлен. Допустимый интервал между двумя отправками — 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.

Оцените, на сколько вам показалась полезной статья «Метод sendSms»
(4)

Вы нашли ответ?

0
0