# SMS-шлюз

The **SMS gateway** является шлюзом обмена сообщениями, который позволяет вашей платформе отправлять и получать SMS-сообщения в рамках Navixy.

<figure><img src="https://4285393472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKdgeXg71LpaDrwexQYwp%2Fuploads%2FohTskUOVdu8kBKcyM097%2Fimage.png?alt=media&#x26;token=87000914-73ed-4fcf-a6c4-b334cca53f8f" alt="SMS gateway page" width="563"><figcaption><p>Страница SMS-шлюза</p></figcaption></figure>

Страница состоит из двух разделов:

* **M2M сообщения:** Этот SMS-шлюз используется для отправки команд и получения ответов от IoT-устройств. Он обеспечивает полностью автоматическую активацию устройств на платформе и служит альтернативным способом связи с устройством, когда основная связь по IP невозможна, например в зонах роуминга.
* **Уведомления для пользователей:** Интегрируя вашего провайдера SMS-услуг с Navixy, вы можете отправлять SMS-оповещения и уведомления вашим пользователям при возникновении определённых событий, например при отключении устройства или при нарушении геозоны.

### Типы SMS-шлюзов

Navixy может интегрироваться с тремя типами SMS-шлюзов:

1. **Популярные глобальные провайдеры услуг**\
   Navixy интегрирован с несколькими популярными глобальными провайдерами через их API, включая [Twilio](https://www.twilio.com/), [Vonage](https://www.vonage.com/) (ранее Nexmo), [Webex](https://app.webexinteract.com/) (ранее Textlocal), [Infobip](https://www.infobip.com/), [Tyntec](https://www.tyntec.com/), и другие. Эти провайдеры обеспечивают глобальное покрытие, хотя в некоторых регионах у них может быть более сильное присутствие для обеспечения лучшей связности и ценообразования. При выборе провайдера сообщений мы рекомендуем сначала рассмотреть эти варианты.
2. **SMS-центры, работающие по общему протоколу SMPP**\
   Navixy может работать с любым SMS-центром, использующим протокол SMPP. SMPP применяется в ряде SMS-центров по всему миру. Если ваш предпочитаемый сервис поддерживает SMPP v3.4, Navixy может легко интегрироваться с ним.
3. **Аппаратные шлюзовые устройства**\
   Navixy также поддерживает аппаратные VoIP-устройства, такие как устройства Yeastar (ранее Neogate), в частности серии TG. Эти устройства можно использовать для отправки и приёма SMS-сообщений. Этот вариант не рекомендуется, но может использоваться для небольших инсталляций.

### Рекомендации по использованию SMS-шлюзов с IoT-устройствами (M2M)

Мы рекомендуем приобрести выделенный номер телефона для использования в качестве Sender ID при отправке команд и получении ответов от устройств. Это предпочтительнее использования общего номера, так как может помочь обеспечить успешную доставку сообщений и выполнение команд.

Имейте в виду, что некоторым IoT-устройствам могут требоваться специальные символы или бинарные команды в их SMS-командах. Чтобы обеспечить успешное выполнение команд, подтвердите, что ваш SMS-шлюз поддерживает эти символы и типы сообщений. В противном случае команды могут быть изменены при передаче и выполнены некорректно.

Некоторые известные проблемы включают:

* Устройства Teltonika и Ruptela начинаются с двух пробельных символов, которые используются для разделения логина и пароля устройства (по умолчанию пустые). Некоторые SMS-сервисы могут игнорировать эти символы как незначительные, что может вызвать проблемы с автоматической активацией. Если вы используете трекеры этих производителей, мы рекомендуем связаться со службой поддержки вашего SMS-сервиса, чтобы убедиться, что они не удаляют эти пробелы в начале сообщений.
* Некоторые глобальные MVNO предоставляют SIM-карты для IoT-устройств без присвоенного им телефонного номера. Вместо этого эти SIM-карты идентифицируются по ICCID или по какому-либо другому номеру, который идентифицирует SIM-карту в сети. В результате связь с устройствами, использующими такие SIM-карты, должна осуществляться через API, предоставляемый MVNO.

### Как подключить Navixy к SMS-шлюзам

Чтобы подключить предпочитаемый вами шлюз сообщений к Navixy, предоставьте необходимые учётные данные команде поддержки Navixy. Это включает такие данные, как название шлюза, URL API, имя пользователя, пароль и любые другие соответствующие параметры, требуемые вашим провайдером шлюза.

Ниже вы найдёте примеры требуемых учётных данных для наиболее распространённых вариантов. Для любого SMS-шлюза вы также должны указать Sender ID, если он поддерживается. Собрав эту информацию, отправьте её в команду поддержки Navixy по адресу <support@navixy.com> чтобы получить помощь с настройкой интеграции и убедиться, что всё работает корректно.

<details>

<summary><strong>SMPP</strong></summary>

* IP-адрес SMPP-сервера
* Порт
* Логин (system id)
* Пароль

</details>

<details>

<summary><strong>Twilio</strong></summary>

* ACCOUNT\_SID
* AUTH\_TOKEN

или

* API\_SID
* API\_SECRET

</details>

<details>

<summary><strong>Yeastar (ex-Neogate)</strong></summary>

* IP-адрес устройства
* Порт
* Логин
* Пароль
* Идентификатор GSM-канала

</details>

<details>

<summary><strong>Tyntec</strong></summary>

* URL
* Логин
* Пароль

</details>

<details>

<summary><strong>Webex (ex-Textlocal)</strong></summary>

* Логин
* API key

</details>
