SMSЦЕНТР

Настройка

Для создания интеграции с SMSЦентр необходимо следующее:

Аккаунт на https://smsc.ru

Пароль или API ключ с доступом к HTTP/S, созданный на странице https://smsc.ru/passwords/

Пример

Имя отправителя, для отправки от него SMS-сообщений - https://smsc.ru/senders/ Для отправки SMS-сообщений абонентам операторов Мегафон (Йота) и МТС необходимо иметь собственное имя отправителя зарегистрированное у операторов связи на платной основе. Операторы Билайн и Теле2 не требуют обязательной регистрации, достаточно создать имя в личном кабинете SMSЦентр.

Полезные ссылки

API документация SMSЦентр: https://smsc.ru/api/#menu История отправленных сообщений: https://smsc.ru/sms/ Здесь вы можете добавлять IP-адреса или e-mail адреса для ограничения входа в личный кабинет и к API сервиса: https://smsc.ru/ips/

Отправка SMS-сообщения

Пример сценария отправки SMS сообщения

Для отправки SMS необходимо вызвать методом GET или POST адрес:

https://smsc.ru/sys/send.php?login=<login>&psw=<password>&phones=<phones>&mes=<message>

Для отправки SMS с передачей параметров в формате json в теле запроса необходимо вызвать методом POST адрес: https://smsc.ru/rest/send/

После принятия и обработки данных Сервер возвращает Клиенту подтверждение с указанием результата обработки.

⚠️

Все параметры, которые содержат специальные символы (плюс, пробел и т.д.), должны быть закодированы при помощи функции urlencode для передачи в HTTP-запросе.

Описание параметров, передаваемых Серверу :

Параметр	Значение
login	Логин Клиента.
psw	Пароль Клиента (можно добавить или изменить на данной странице).
apikey	Специальный API-ключ, используемый для упрощенной авторизации вместо пары "логин+пароль" (можно создать на данной странице).
phones	Номер или разделенный запятой или точкой с запятой список номеров мобильных телефонов в международном формате, на которые отправляется сообщение. Номера могут передаваться без знака "+". Если номер передан без знака "+", то он может быть исправлен автоматическим форматированием и приведен к правильному международному формату.
mes	Текст отправляемого сообщения. Максимальный размер – 1000 символов. Сообщение при необходимости будет разбито на несколько SMS, отправленных абоненту и оплаченных по отдельности. Размер одного SMS – 160 символов в латинице или 70 символов в кириллице.

⚠️

Сервер не принимает более одного одинакового запроса на отправку SMS-сообщений в течение минуты.

Коды ошибок в ответе сервера

Номер ошибки может принимать следующие значения:

Значение	Описание
1	Ошибка в параметрах.
2	Неверный логин или пароль. Также возникает при попытке отправки сообщения с IP-адреса, не входящего в список разрешенных Клиентом (если такой список был настроен Клиентом ранее).
3	Недостаточно средств на счете Клиента.
4	IP-адрес временно заблокирован из-за частых ошибок в запросах. Подробнее
5	Неверный формат даты.
6	Сообщение запрещено (по тексту или по имени отправителя). Также данная ошибка возникает при попытке отправки массовых и (или) рекламных сообщений без заключенного договора.
7	Неверный формат номера телефона.
8	Сообщение на указанный номер не может быть доставлено.
9	Отправка более одного одинакового запроса на передачу SMS-сообщения либо более пяти одинаковых запросов на получение стоимости сообщения в течение минуты. Данная ошибка возникает также при попытке отправки пятнадцати и более запросов одновременно с разных подключений под одним логином (too many concurrent requests).