> For the complete documentation index, see [llms.txt](https://wfsys.gitbook.io/workflow-engine-syntax/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wfsys.gitbook.io/workflow-engine-syntax/workflow_engine/commands/sms_center_engine_command/get_status_command.md).

# GetStatusCommand

## Шаблон GetStatusCommand <a href="#template_get_status_command" id="template_get_status_command"></a>

```xml
<Command Name="" Type="GetStatusCommand" Assembly="SMSCenterEngine">
  <UserSqlQuery>
    <Text></Text>
  </UserSqlQuery>
  <PasswordSqlQuery>
    <Text></Text>
  </PasswordSqlQuery>
  <Background Value="True" />
  <PhonesSqlQuery>
    <Text></Text>
  </PhonesSqlQuery>
  <PostSqlQuery>
    <Text></Text>
  </PostSqlQuery>
</Command>
```

## Описание GetStatusCommand <a href="#description_get_status_command" id="description_get_status_command"></a>

```xml
<Command Name="GetStatusCommandName" Type="GetStatusCommand" Assembly="SMSCenterEngine">
  <!--Тэги, общие для всех команд-->
  <!--Тэги, общие для всех команд сборки SMSCenterEngine-->
  <!--Тэги, специфичные для определенной команды (зависит от типа) сборки SMSCenterEngine-->
</Command>
```

## Тэги, специфичные для GetStatusCommand <a href="#tags_get_status_command" id="tags_get_status_command"></a>

### Background <a href="#background" id="background"></a>

Признак, определяющий, будет ли проверка статуса отправки СМС происходить в фоновом режиме (в отдельном потоке, то есть без задержки для приложения, вызвавшего данную команду).

Необязательный тэг. Значение тэга `<Background>`: не ожидается.

Если тэг `<Background>` отсутствует, то для атрибута `Value` используется значение False.

```xml
<Background Value="False" />
```

#### Атрибуты тэга `<Background>` <a href="#attributes_tag_background" id="attributes_tag_background"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="539.3333333333333"></th></tr></thead><tbody><tr><td align="center">Value</td><td><p>Значение.</p><p></p><p>Обязательный атрибут. Ожидается логическое значение.</p></td></tr></tbody></table>

### PhonesSqlQuery <a href="#phones_sql_query" id="phones_sql_query"></a>

Sql-запрос, возвращающий список телефонов и идентификатором СМС в системе "СМС-Центр", для которых нужно определить статус.

Обязательный тэг. Значение тэга `<PhonesSqlQuery>`: тэг [`<Text>`](#phones_sql_query_text).

```xml
<PhonesSqlQuery>
  <Text>
    SELECT
    sms_phone_id AS "Id",
    phone AS "Phone",
    message_id AS "MessageId"
    FROM
    sms_phone
  </Text>
</PhonesSqlQuery>
```

#### Тэг `<Text>` <a href="#phones_sql_query_text" id="phones_sql_query_text"></a>

Содержит sql-запрос.

Обязательный тэг. Значение тэга `<Text>`: текст sql-запроса.

Sql-запрос должен возвращать список полей со следующими заголовками (алиасами):

1. Id - произвольный идентификатор, соответствующий телефону, указанному при отправке СМС, который будет использоваться в Post-запросе.
2. Phone - телефон, указанный при отправке СМС.
3. MessageId - идентификатор отправленного СМС в системе "СМС-Центр".

Текст sql-запроса поддерживает переменные типа {Parameter}, заменяемые при его выполнении значениями параметров с соответствующими названиями, передаваемых клиентом.

{% hint style="warning" %}
СМС, отправленные до 18.00 текущего дня, переходят в системе "СМС-Центр" в архивные в 03.00 следующего дня. Запрос на определение статуса отправки архивного СМС всегда будет возвращать пустую строку (""). Это политика "СМС-Центра". Подробнее читайте обо всех свойствах рассылок СМС на [сайте](http://smsc.ru).
{% endhint %}

### PostSqlQuery <a href="#post_sql_query" id="post_sql_query"></a>

Sql-запрос, выполняющийся при успешном определении статуса отправки каждого СМС.

Необязательный тэг. Значение тэга `<PostSqlQuery>`: тэг [`<Text>`](#post_sql_query_text).

```xml
<PostSqlQuery>
  <Text>
    UPDATE
    sms_phone
    SET
    sms_status_id = {SMSStatusId}
    WHERE
    sms_phone_id = {Id}
  </Text>
</PostSqlQuery>
```

#### Тэг `<Text>` <a href="#post_sql_query_text" id="post_sql_query_text"></a>

Содержит sql-запрос.

Обязательный тэг. Значение тэга `<Text>`: текст sql-запроса.

Sql-запрос должен возвращать список полей со следующими заголовками (алиасами):

Текст sql-запроса поддерживает переменные типа {Parameter}, заменяемые при его выполнении значениями параметров с соответствующими названиями, передаваемых клиентом.

Текст sql-запроса поддерживает переменную {MessageId}, заменяемые при его выполнении значением идентификатором СМС в системе "СМС-Центра".

Текст sql-запроса поддерживает переменную {Id}, заменяемую при его выполнении значением, возвращенным для очередного телефона в запросе, указанном в тэге [`<PhonesSqlQuery>`](#phones_sql_query).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://wfsys.gitbook.io/workflow-engine-syntax/workflow_engine/commands/sms_center_engine_command/get_status_command.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.