# Отправка SMS, Viber, Flash SMS, WAP-Push

## Отправка SMS, Viber, Flash SMS, WAP-Push

<mark style="color:green;">`POST`</mark> `http://lk.mysmpp.ru/json`

#### Headers

| Name                                           | Type   | Description                     |
| ---------------------------------------------- | ------ | ------------------------------- |
| Content-type<mark style="color:red;">\*</mark> | String | **`text/json; charset=utf-8;`** |

#### Request Body

| Name                                                    | Type   | Description                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| login<mark style="color:red;">\*</mark>                 | String | Ваш логин в системе                                                                                                                                                                                                                                                                                                                                         |
| password<mark style="color:red;">\*</mark>              | String | Ваш пароль в системе                                                                                                                                                                                                                                                                                                                                        |
| token<mark style="color:red;">\*</mark>                 | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру.                                                                                                                                                                                                                                                         |
| message.type\_send\_1<mark style="color:red;">\*</mark> | String | Тип отправляемого сообщения **`viber`** или **`sms`**                                                                                                                                                                                                                                                                                                       |
| message.sender<mark style="color:red;">\*</mark>        | String | <p>Отправитель SMS. 
<br><mark style="color:orange;">Именно это значение будет выводиться на телефоне абонента в поле от кого SMS</mark></p>                                                                                                                                                                                                                |
| message.phones.phone<mark style="color:red;">\*</mark>  | Int    | Номер абонента, которому адресована SMS                                                                                                                                                                                                                                                                                                                     |
| message.phones.client\_id\_sms                          | Int    | <p>число присваиваемое клиентом <br><mark style="color:orange;">Позволяет избежать повторной отправки. Если раннее с этого аккаунта уже было отправлено SMS с таким номером, то повторная отправка не производится, а возвращается номер ранее отправленного SMS</mark></p>                                                                                 |
| message.text<mark style="color:red;">\*</mark>          | String | Текст обычного SMS или описание WAP-ссылки                                                                                                                                                                                                                                                                                                                  |
| message.phones.validity\_period                         | Date   | <p>Дата и время, после которых не будут делаться попытки доставить SMS в формате:</p><p><em>YYYY-MM-DD HH:MM:SS</em></p><p>где,<br>    YYYY - год,<br>    MM - месяц,<br>    DD - день,<br>    HH - часы, </p><p>    MM - минуты</p><p>    SS - секунды</p><p><mark style="color:orange;">Если не задано, то SMS имеет максимальный срок жизни.</mark> </p> |

{% tabs %}
{% tab title="200: OK В случае получения правильного JSON докмента" %}

```json
{
    "information":
        [
            {
                "state": "Статус", 
                "id_sms": "ID SMS в системе для проверки статуса",
                "error": "Сообщение об ошибке."
            },
            {
                "state": "Статус", 
                "id_sms": "ID SMS в системе для проверки статуса",
                "error": "Сообщение об ошибке."
            }
        ]
}
```

{% endtab %}

{% tab title="400: Bad Request В случае возникновения ошибки в отправленном JSON-документе" %}

```json
{
    "error": "Текст ошибки."
}
```

{% endtab %}
{% endtabs %}

### Расшифровка параметров в ответах на запрос

<table><thead><tr><th width="144.33333333333331">Параметр</th><th width="133">Тип данных</th><th>Описание</th></tr></thead><tbody><tr><td>state</td><td>String</td><td>Статус сообщения («send»), если SMS была отправлена</td></tr><tr><td>id_sms</td><td>Int</td><td><p>Номер SMS сообщения. Используется для проверки статуса SMS.</p><p><mark style="color:orange;">Если в процессе отправки SMS произошла ошибка, то id_sms не передается</mark></p></td></tr><tr><td>error</td><td>String</td><td><p>Текст ошибки при статусе ответа <mark style="color:green;"><strong>200</strong></mark>:</p><ul><li>Неправильный формат JSON документа </li><li>Ваш аккаунт заблокирован</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul><p></p><p>Текст ошибки при статусе ответа <mark style="color:red;"><strong>400</strong></mark>:</p><ul><li>У нас закончились SMS. Для разрешения проблемы свяжитесь с менеджером</li><li>Закончились SMS</li><li>Аккаунт заблокирован</li><li>Укажите номер телефона</li><li>Номер телефона присутствует в стоп-листе</li><li>Данное направление закрыто для вас</li><li>Данное направление закрыто</li><li>Текст SMS отклонен модератором</li><li>Нет отправителя</li><li>Отправитель не должен превышать 15 символов для цифровых номеров и 11 символов для буквенно-числовых</li><li>Номер телефона должен быть меньше 15 символов</li><li>Нет текста сообщения</li><li>Нет ссылки</li><li>Укажите название контакта и хотя бы один параметр для визитной карточки</li><li>Такого отправителя нет</li><li>Отправитель не прошел модерацию</li></ul></td></tr></tbody></table>

### Пример запроса на отправку&#x20;

{% code lineNumbers="true" fullWidth="false" %}

```json
{
    "login": "логин",
    "password": "пароль",
    "token": "токен",
    "message": [
        {
            "type_send_1":"sms",
            "sender":" Отправитель 1",
            "text":"Текст сообщения 1",
            "phones":[
                {
                    "phone":"79612242243",
                    "client_id_sms":"101",
                    "validity_period":"2001-12-31 15:34:54"
                },
                {
                    "phone":"79612242244",
                    "client_id_sms":"102",
                    "validity_period":"2001-12-31 15:34:54"
                }
            ]
        },
        {
            "type_send_1":"sms",
            "sender":" Отправитель 2",
            "text":"Текст сообщения 2",
            "phones":[
                {
                "phone":"79612242245",
                    "client_id_sms":"103",
                    "validity_period":"2001-12-31 15:34:54"
                }
            ]
        }
    ]
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.webcom.mobi/ru2/type/specifikaciya-json/otpravka-sms-viber-flash-sms-wap-push.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.