> For the complete documentation index, see [llms.txt](https://sms-club.gitbook.io/smsclub24ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sms-club.gitbook.io/smsclub24ru/otpravka-soobsheniya.md).

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

{% tabs %}
{% tab title="XML" %}
Метод отправки **`POST`**

Кодировка XML-документов: **`UTF-8`**

Обязательный заголовок: **`Content-type: text/xml; charset=utf-8;`**

Адрес для запроса: **`https://my.smsclub24.ru/xml`**

## Примеры

[Пример отправки SMS сообщения](#primer-xml-dokumenta-dlya-otpravki-sms-soobsheniya)

[Пример отправки Viber сообщения](#primer-xml-dokumenta-dlya-otpravki-viber-soobsheniya)

[Пример отправки Каскадного сообщения](#primer-xml-dokumenta-dlya-otpravki-kaskadnogo-soobsheniya)

## Параметры запроса на отправку сообщения

|                                                                                                                                                                                       |        |                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>request</p><p><mark style="color:red;">.security</mark></p><p><mark style="color:yellow;">.login</mark></p><p><mark style="color:green;">\[value]\*</mark></p>                     | String | <p>Ваш логин в системе<br></p>                                                                                                                                                                                                                                                                                                          |
| <p>request</p><p><mark style="color:red;">.security</mark></p><p><mark style="color:yellow;">.password</mark></p><p><mark style="color:green;">\[value]\*</mark></p>                  | String | <p>Ваш логин в системе<br></p>                                                                                                                                                                                                                                                                                                          |
| <p>request</p><p><mark style="color:red;">.security</mark></p><p><mark style="color:yellow;">.token</mark></p><p><mark style="color:green;">\[value]\*</mark></p>                     | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру                                                                                                                                                                                                                                      |
| <p>request</p><p><mark style="color:red;">.message</mark></p><p><mark style="color:green;">\[type\_send\_1]\*</mark></p>                                                              | String | <p></p><p>Тип отправляемого сообщения</p><ul><li>viber</li><li>sms</li><li>flashcall</li><li>hlr</li></ul>                                                                                                                                                                                                                              |
| <p>request</p><p><mark style="color:red;">.message</mark></p><p><mark style="color:green;">\[type\_send\_2]</mark></p>                                                                | String | <p></p><p>Тип досылаемого сообщения, в случае если отправляемое сообщение не будет доставлено по первому типу направления <em>request.message\[type\_send\_1]</em>, применяется для каскадной отправки</p><ul><li>viber</li><li>sms</li></ul>                                                                                           |
| <p>request</p><p><mark style="color:red;">.message</mark></p><p><mark style="color:green;">\[type]</mark></p>                                                                         | String | <p></p><p>Тип сообщения:</p><ul><li>silence – невидимые SMS (для проверки статуса абонента)</li><li>sms – обычная SMS</li><li>flashcall</li><li>hlr</li></ul>                                                                                                                                                                           |
| <p>request</p><p><mark style="color:red;">.message</mark></p><p><mark style="color:green;">.sender\*</mark></p>                                                                       | String | <p>Отправитель SMS, HLR, FlashCall сообщения</p><p><br>!<em>Именно это значение будет выводиться на телефоне абонента в поле от кого сообщение</em></p>                                                                                                                                                                                 |
| <p>request</p><p><mark style="color:red;">.message</mark></p><p><mark style="color:green;">.text\*</mark></p>                                                                         | String | Текст SMS, HLR, FlashCall сообщения                                                                                                                                                                                                                                                                                                     |
| <p>request</p><p><mark style="color:red;">.message</mark></p><p><mark style="color:yellow;">.abonent</mark></p><p><mark style="color:green;">\[phone]\*</mark></p>                    | Int    | Номер абонента, которому адресовано сообщение                                                                                                                                                                                                                                                                                           |
| <p>request</p><p><mark style="color:red;">.message</mark></p><p><mark style="color:yellow;">.abonent</mark></p><p><mark style="color:green;">\[number\_sms]</mark></p>                | Int    | Номер сообщения в пределах отправляемого XML документа                                                                                                                                                                                                                                                                                  |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.abonent</mark></p><p><mark style="color:green;">\[client\_id\_sms]</mark></p>         | Int    | <p>Число присваиваемое клиентом </p><p>!<em>Необязательный параметр, позволяет избежать повторной отправки. Если раннее с этого аккаунта уже было отправлено SMS с таким номером, то повторная отправка не производится, а возвращается номер ранее отправленного SMS</em></p>                                                          |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.abonent</mark></p><p><mark style="color:green;">\[time\_send]</mark></p>              | date   | <p>Дата и время отправки в формате:</p><p>YYYY-MM-DD HH:MM</p><p>где, </p><p>YYYY-год, </p><p>MM-месяц, </p><p>DD-день, </p><p>HH-часы,</p><p>MM-минуты</p><p><em>!Если не задано, то сообщение имеет максимальный срок жизни (один день)</em></p>                                                                                      |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.abonent</mark></p><p><mark style="color:green;">\[validity\_period]</mark></p>        | date   | <p>Дата и время, после которых не будут делаться попытки доставить SMS в формате:</p><p><em>YYYY-MM-DD HH:MM:SS</em></p><p>где, </p><p>YYYY - год, </p><p>MM - месяц, </p><p>DD - день, </p><p>HH - часы,</p><p>MM - минуты</p><p>SS - секунды</p><p><em>!Если не задано, то SMS имеет максимальный срок жизни (один день)</em></p>     |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.abonent</mark></p><p><mark style="color:green;">\[validity\_period\_viber]</mark></p> | date   | <p>Дата и время, после которых не будут делаться попытки доставить Viber в формате:</p><p><em>YYYY-MM-DD HH:MM:SS</em></p><p>где, </p><p>YYYY - год, </p><p>MM - месяц, </p><p>DD - день, </p><p>HH - часы,</p><p>MM - минуты</p><p>SS - секунды</p><p><em>!Если не задано, то Viber имеет максимальный срок жизни (один день)</em></p> |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.sender\_viber</mark></p>                                                              | String | Отправитель Viber сообщения                                                                                                                                                                                                                                                                                                             |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.text\_viber</mark></p>                                                                | String | Текст Viber сообщения                                                                                                                                                                                                                                                                                                                   |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.button\_viber</mark></p>                                                              | String | Текст кнопки Viber сообщения                                                                                                                                                                                                                                                                                                            |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.action\_viber</mark></p>                                                              | String | Ссылка для кнопки Viber сообщения                                                                                                                                                                                                                                                                                                       |
| <p>request</p><p><mark style="color:orange;">.message</mark></p><p><mark style="color:yellow;">.image\_viber</mark></p>                                                               | String | Адрес картинки для Viber сообщения                                                                                                                                                                                                                                                                                                      |

\*-обязательный параметр

## В случае получения правильного XML-документа

```xml
<?xml  version="1.0" encoding="utf-8" ?>
<response>
     <information number_sms="1" id_sms="ID SMS в системе для проверки статуса" parts="2">Статус/сообщение об ошибке</information>
     <information number_sms="2" id_sms="ID SMS в системе для проверки статуса" parts="2">Статус/сообщение об ошибке</information>
     <information number_sms="3" id_sms="ID SMS в системе для проверки статуса" parts="2">Статус/сообщение об ошибке</information>
…
</response>
```

| Параметр                                                                                                                      | Тип    | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>response</p><p><mark style="color:orange;">.information</mark></p><p><mark style="color:yellow;">\[number\_sms]</mark></p> | Int    | Номер сообщения, указанный при отправке XML документа                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p>response</p><p><mark style="color:orange;">.information</mark></p><p><mark style="color:yellow;">\[id\_sms]</mark></p>     | String | <p>Номер SMS сообщения. Используется для проверки статуса SMS.</p><p><em>!Если в процессе отправки SMS произошла ошибка, то id\_sms не передается</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p>response</p><p><mark style="color:orange;">.information</mark></p><p><mark style="color:yellow;">\[parts]</mark></p>       | Int    | Количество частей SMS                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <p>response</p><p><mark style="color:orange;">.information</mark></p>                                                         | String | <p></p><p>Статус сообщения («send»), если была отправлена, или сообщение об ошибке, если в процессе отправки произошла ошибка:</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> |

## В случае возникновения ошибки в отправленном XML-документе

```xml
<?xml version="1.0" encoding="utf-8"?>
<response>
     <error>Текст ошибки</error>
</response>
```

| Параметр                     |        |                                                                                                                                                                                                                          |
| ---------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <p>response</p><p>.error</p> | String | <p></p><p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат XML документа</li><li>Ваш аккаунт заблокирован</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul> |

## Пример XML-документа для отправки SMS сообщения

```xml
<?xml version="1.0" encoding="utf-8" ?>
<request>
     <message type_send_1="sms" type="sms">
          <sender>Отправитель</sender>
          <text>Текст сообщения</text>
          <abonent phone="79033256699" number_sms="1" client_id_sms="101" time_send="2001-12-31 12:34:54" validity_period="2001-12-31 15:34:54" />
          <abonent phone="79033256699" number_sms="2" client_id_sms="102" time_send="2001-12-31 12:35:54" />
          ...
          <abonent phone="79033256699" number_sms="10" client_id_sms="110" time_send="" />
     </message>
     <security>
          <login value="логин" />
          <password value="пароль" />
     </security>
</request>
```

## Пример XML-документа для отправки Viber сообщения

```xml
<?xml version="1.0" encoding="utf-8" ?>
<request>
    <message type_send_1="viber" type="sms">
        <sender_viber>Отправитель Viber сообщения</sender_viber>
        <text_viber>Текст сообщения</text_viber>
        <button_viber>Текст кнопки</button_viber>
        <action_viber>Ссылка для кнопки</action_viber>
        <image_viber>Адрес картинки</image_viber>
        <abonent phone="79033256699" number_sms="1" client_id_sms="101" time_send="2001-12-31 12:34:54" validity_period_viber="2001-12-31 15:34:54" />
        <abonent phone="79033256699" number_sms="2" client_id_sms="102" time_send="2001-12-31 12:35:54" />
        ...
        <abonent phone="79033256699" number_sms="10" client_id_sms="110" time_send="" />
    </message>
    <security>
        <login value="логин" />
        <password value="пароль" />
    </security>
</request>
```

## Пример XML-документа для отправки Каскадного сообщения

```xml
<?xml version="1.0" encoding="utf-8" ?>
<request>
    <message type_send_1="viber" type_send_2="sms" type="sms">
        <sender_viber>Отправитель Viber сообщения</sender_viber>
        <text_viber>Текст сообщения Viber</text_viber>
        <button_viber>Текст кнопки Viber</button_viber>
        <action_viber>Ссылка для кнопки Viber</action_viber>
        <image_viber>Адрес картинки Viber</image_viber>
        <sender>Отправитель SMS сообщения</sender>
        <text>Текст сообщения SMS</text>
        <abonent phone="79033256699" number_sms="1" client_id_sms="101" time_send="2001-12-31 12:34:54" validity_period="2001-12-31 15:34:54" validity_period_viber="2001-12-31 15:34:54" />
        <abonent phone="79033256699" number_sms="2" client_id_sms="102" time_send="2001-12-31 12:35:54" />
        ...
        <abonent phone="79033256699" number_sms="10" client_id_sms="110" time_send="" />
    </message>
    <security>
        <login value="логин" />
        <password value="пароль" />
    </security>
</request>
```

{% endtab %}

{% tab title="JSON" %}
Метод отправки **`POST`**

Кодировка JSON-документов: **`UTF-8`**

Обязательный заголовок: **`Content-type: text/json; charset=utf-8;`**

Адрес для запроса: **`https://my.smsclub24.ru/json`**

## Примеры

[Пример отправки SMS сообщения](#primer-json-dokumenta-dlya-otpravki-sms-soobsheniya)

[Пример отправки Viber сообщения](#primer-json-dokumenta-dlya-otpravki-viber-soobsheniya)

[Пример отправки Каскадного сообщения](#primer-json-dokumenta-dlya-otpravki-kaskadnogo-soobsheniya)

## Параметры запроса на отправку сообщения

| Параметр                                                                                                                 | Тип    | Описание                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------------------------------ | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| login\*                                                                                                                  | String | Ваш логин в системе                                                                                                                                                                                                                                                                                                                             |
| password\*                                                                                                               | String | Ваш пароль в системе                                                                                                                                                                                                                                                                                                                            |
| token\*                                                                                                                  | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру                                                                                                                                                                                                                                              |
| <p>message</p><p><mark style="color:orange;">.type\_send\_1\*</mark></p>                                                 | String | <p></p><p>Тип отправляемого сообщения</p><ul><li>viber</li><li>sms</li><li>flashcall</li><li>hlr</li></ul>                                                                                                                                                                                                                                      |
| <p>message</p><p><mark style="color:orange;">.type\_send\_2</mark></p>                                                   | String | <p></p><p>Тип досылаемого сообщения, в случае если отправляемое сообщение не будет доставлено по первому типу направления <em><mark style="color:green;">message.type\_send\_1</mark></em>, применяется для каскадной отправки</p><ul><li>viber</li><li>sms</li></ul>                                                                           |
| <p>message</p><p><mark style="color:orange;">.sender\*</mark></p>                                                        | String | <p>Отправитель сообщения</p><p><em>!Именно это значение будет выводиться на телефоне абонента в поле от кого сообщение</em></p>                                                                                                                                                                                                                 |
| <p>message</p><p><mark style="color:orange;">.text\*</mark></p>                                                          | String | Текст сообщения                                                                                                                                                                                                                                                                                                                                 |
| <p>message</p><p><mark style="color:orange;">.phones</mark></p><p><mark style="color:green;">.phone\*</mark></p>         | Int    | Номер абонента, которому адресовано сообщение                                                                                                                                                                                                                                                                                                   |
| <p>message</p><p><mark style="color:orange;">.phones</mark></p><p><mark style="color:green;">.number\_sms</mark></p>     | Int    | Номер сообщения в пределах отправляемого XML документа                                                                                                                                                                                                                                                                                          |
| <p>message</p><p><mark style="color:orange;">.phones</mark></p><p><mark style="color:green;">.client\_id\_sms</mark></p> | Int    | <p>Число присваиваемое клиентом</p><p><em>!Необязательный параметр, позволяет избежать повторной отправки. Если раннее с этого аккаунта уже было отправлено</em> сообщение <em>с таким номером, то повторная отправка не производится, а возвращается номер ранее отправленного</em> сообщения</p>                                              |
| <p>message</p><p><mark style="color:orange;">.phones</mark></p><p><mark style="color:green;">validity\_period</mark></p> | date   | <p>Дата и время, после которых не будут делаться попытки доставить сообщение в формате:</p><p><em>YYYY-MM-DD HH:MM:SS</em></p><p>где, </p><p>YYYY - год, </p><p>MM - месяц, </p><p>DD - день, </p><p>HH - часы,</p><p>MM - минуты</p><p>SS - секунды</p><p><em>!Если не задано, то сообщение имеет максимальный срок жизни (один день)</em></p> |
| <p>message</p><p><mark style="color:orange;">.sender\_viber</mark></p>                                                   | String | Отправитель Viber сообщения                                                                                                                                                                                                                                                                                                                     |
| <p>message</p><p><mark style="color:orange;">.text\_viber</mark></p>                                                     | String | Текст Viber сообщения                                                                                                                                                                                                                                                                                                                           |
| <p>message</p><p><mark style="color:orange;">.button\_viber</mark></p>                                                   | String | Текст кнопки Viber сообщения                                                                                                                                                                                                                                                                                                                    |
| <p>message</p><p><mark style="color:orange;">.action\_viber</mark></p>                                                   | String | Ссылка для кнопки Viber сообщения                                                                                                                                                                                                                                                                                                               |
| <p>message</p><p><mark style="color:orange;">.image\_viber</mark></p>                                                    | String | Адрес картинки для Viber сообщения                                                                                                                                                                                                                                                                                                              |

\*-обязательный параметр

## В случае получения правильного JSON-документа

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

| Параметр                                                            | Тип    | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>information</p><p><mark style="color:green;">.state</mark></p>   | String | Статус сообщения («send»), если сообщение было отправлено                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p>information</p><p><mark style="color:green;">.id\_sms</mark></p> | String | <p>Номер сообщения. Используется для проверки статуса сообщения.</p><p><em>!Если в процессе отправки</em> сообщения <em>произошла ошибка, то id\_sms не передается</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p>information</p><p><mark style="color:green;">.error</mark></p>   | String | <p></p><p>Сообщение об ошибке, если в процессе отправки произошла ошибка:</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> |

## В случае возникновения ошибки в отправленном JSON-документе

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

| Параметр                              | Тип    | Описание                                                                                                                                                                                                                  |
| ------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:red;">error</mark> | String | <p></p><p>Текст ошибки может принимать следующие значения:</p><ul><li>Неправильный формат JSON документа</li><li>Ваш аккаунт заблокирован</li><li>Неправильный логин или пароль</li><li>POST данные отсутствуют</li></ul> |

## Пример JSON-документа для отправки SMS сообщения

```json
{
    "login":"логин",
    "password":"пароль",
    "token":"или токен",
    "message":
        [
            {
                "type_send_1":"sms",
                "sender":" Отправитель",
                "text":"Текст сообщения",
                "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"
                        }
                    ]
            },
        ]
}
```

## Пример JSON-документа для отправки Viber сообщения

```json
{
    "login":"логин",
    "password":"пароль",
    "token":"или токен",
    "message":
        [
            {
                "type_send_1": "viber",
                "sender_viber": "Отправитель",
                "text_viber": "Текст сообщения",
                "button_viber": "Текст кнопки",
                "action_viber": "Ссылка для кнопки",
                "image_viber": "Адресс картинки",
                "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"
                        }
                    ]
            },
        ]
}
```

## Пример JSON-документа для отправки Каскадного сообщения

```json
{
    "login":"логин",
    "password":"пароль",
    "token":"или токен",
    "message":
        [
            {
                "type_send_1":"viber",
                "type_send_2":"sms",
                "sender":" Отправитель SMS",
                "text":"Текст сообщения SMS",
                "sender_viber": "Отправитель Viber",
                "text_viber": "Текст сообщения Viber",
                "button_viber": "Текст кнопки Viber",
                "action_viber": "Ссылка для кнопки Viber",
                "image_viber": "Адресс картинки Viber",
                "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"
                        }
                    ]
            },
        ]
}
```

{% endtab %}

{% tab title="HTTP GET" %}
Метод отправки **`GET`**

Адрес для запроса: **`https://my.smsclub24.ru/sendsms.php`**

Все передаваемые значение необходимо закодировать.

## Примеры

[Пример отправки SMS сообщения](#primer-zaprosa-dlya-otpravki-sms-soobsheniya)

[Пример отправки Viber сообщения](#primer-zaprosa-dlya-otpravki-viber-soobsheniya)

[Пример отправки Каскадного сообщения](#primer-zaprosa-dlya-otpravki-kaskadnogo-soobsheniya)

## Параметры запроса на отправку сообщения

| Параметр         | Тип    | Описание                                                                                                                                                                                                                                                                                                                                                 |
| ---------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| user\*           | String | Ваш логин в системе                                                                                                                                                                                                                                                                                                                                      |
| pwd\*            | String | Ваш пароль в системе                                                                                                                                                                                                                                                                                                                                     |
| token\*          | String | Вместо логина и пароля можно использовать секретный ключ. Для его получения обратитесь к менеджеру                                                                                                                                                                                                                                                       |
| type\_send\_1\*  | String | <p></p><p>Тип отправляемого сообщения</p><ul><li>viber</li><li>sms</li><li>flashcall</li><li>hlr</li></ul>                                                                                                                                                                                                                                               |
| type\_send\_2    | String | <p></p><p>Тип досылаемого сообщения, в случае если отправляемое сообщение не будет доставлено по первому типу направления <em>type\_send\_1</em>, применяется для каскадной отправки</p><ul><li>viber</li><li>sms</li></ul>                                                                                                                              |
| sadr\*           | String | <p>Отправитель сообщения</p><p><em>!Именно это значение будет выводиться на телефоне абонента в поле от кого сообщение</em></p>                                                                                                                                                                                                                          |
| dadr\*           | Int    | Номер абонента, которому адресовано сообщение                                                                                                                                                                                                                                                                                                            |
| text\*           | String | Текст сообщения                                                                                                                                                                                                                                                                                                                                          |
| validity\_period | date   | <p>Дата и время, после которых не будут делаться попытки доставить сообщение в формате:</p><p><em>YYYY-MM-DD HH:MM:SS</em></p><p>где, </p><p>YYYY - год, </p><p>MM - месяц, </p><p>DD - день, </p><p>HH - часы,</p><p>MM - минуты</p><p>SS - секунды</p><p><em>!Если не задано, то</em> сообщение <em>имеет максимальный срок жизни (один день)</em></p> |
| sender\_viber    | String | Отправитель Viber сообщения                                                                                                                                                                                                                                                                                                                              |
| text\_viber      | String | Текст Viber сообщения                                                                                                                                                                                                                                                                                                                                    |
| button\_viber    | String | Текст кнопки Viber сообщения                                                                                                                                                                                                                                                                                                                             |
| action\_viber    | String | Ссылка для кнопки Viber сообщения                                                                                                                                                                                                                                                                                                                        |
| image\_viber     | String | Адрес картинки для Viber сообщения                                                                                                                                                                                                                                                                                                                       |

## Ответ на GET запрос

В ответ будет направлен номер Viber сообщения **`id_sms`**. Используется для проверки статуса сообщения.

## Пример запроса для отправки SMS сообщения

```
https://my.smsclub24.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&sadr=от_кого_придет_СМС&dadr=номер_телефона_получателя_сообщения&text=текст_смс
```

## Пример запроса для отправки Viber сообщения

```gettext
http://my.smsclub24.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&type_send_1=viber&sender_viber=от_кого_придет_сообщение&dadr=номер_телефона_получателя_сообщения&text_viber=текст_Viber_сообщения&button_viber=текст_кнопки_Viber_сообщения&action_viber=ссылка_для_кнопки_Viber_сообщения&image_viber=http://адрес_картинки_для_Viber_сообщения
```

## Пример запроса для отправки Каскадного сообщения

```
http://my.smsclub24.ru/sendsms.php?user=ваш_логин_в_нашей_системе&pwd=пароль&sadr=от_кого_придет_СМС&dadr=номер_телефона_получателя_смс&text=текст_смс&type_send_1=viber&sender_viber=от_кого_придет_сообщение&text_viber=текст_Viber_сообщения&button_viber=текст_кнопки_Viber_сообщения&action_viber=ссылка_для_кнопки_Viber_сообщения&image_viber=http://адрес_картинки_для_Viber_сообщения
```

{% endtab %}
{% endtabs %}