# Gateway de SMS

O **gateway SMS** é um gateway de mensagens que permite à sua plataforma enviar e receber mensagens SMS dentro do Navixy.

<figure><img src="https://4025454174-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>Página do gateway SMS</p></figcaption></figure>

A página consiste em duas seções:

* **Mensagens M2M:** Este gateway SMS é usado para enviar comandos e receber respostas de dispositivos IoT. Ele possibilita a ativação totalmente automática de dispositivos na plataforma e atua como uma forma alternativa de comunicação com o dispositivo quando a comunicação principal por IP não é possível, como em áreas de roaming.
* **Notificações aos usuários:** Ao integrar seu provedor de serviço SMS com o Navixy, você pode enviar alertas e notificações por SMS aos seus usuários quando determinados eventos ocorrem, como quando um dispositivo fica offline ou quando há violação de uma geofence.

### Tipos de gateways SMS

O Navixy pode se integrar com três tipos de gateways SMS:

1. **Provedores de serviço globais populares**\
   O Navixy está integrado com vários provedores de serviço globais populares por meio de suas APIs, incluindo [Twilio](https://www.twilio.com/), [Vonage](https://www.vonage.com/) (anteriormente Nexmo), [Webex](https://app.webexinteract.com/) (anteriormente Textlocal), [Infobip](https://www.infobip.com/), [Tyntec](https://www.tyntec.com/), e outros. Esses provedores de serviço oferecem cobertura mundial, embora alguns possam ter uma presença mais forte em certas regiões para proporcionar melhor conectividade e preços. Ao selecionar um provedor de mensagens, recomendamos considerar esses provedores primeiro.
2. **Centros de SMS que funcionam com o protocolo SMPP comum**\
   O Navixy pode trabalhar com qualquer centro de SMS que utilize o protocolo SMPP. O SMPP é usado por diversos centros de SMS em todo o mundo. Se seu serviço preferido suportar SMPP v3.4, o Navixy pode integrá-lo facilmente.
3. **Dispositivos gateway de hardware**\
   O Navixy também oferece suporte a dispositivos de VoIP de hardware, como dispositivos Yeastar (ex-Neogate), especificamente a série TG. Esses dispositivos podem ser usados para enviar e receber mensagens SMS. Essa opção não é recomendada, mas pode ser usada para instâncias menores.

### Recomendações para o uso de gateways SMS com dispositivos IoT (M2M)

Recomendamos adquirir um número de telefone dedicado para usar como Sender ID ao enviar comandos e receber respostas de dispositivos. Isso é preferível ao uso de um número compartilhado, pois pode ajudar a garantir a entrega bem-sucedida das mensagens e a execução dos comandos.

Lembre-se de que certos dispositivos IoT podem exigir caracteres especiais ou comandos binários em seus comandos SMS. Para garantir a execução bem-sucedida dos comandos, confirme que seu gateway SMS suporta esses caracteres e tipos de mensagem. Caso contrário, os comandos podem ser alterados durante a transmissão e executados incorretamente.

Alguns problemas conhecidos incluem:

* Dispositivos Teltonika e Ruptela começam com dois símbolos de espaço, que são usados para delimitar o login e a senha do dispositivo (vazios por padrão). Alguns serviços de SMS podem ignorar esses símbolos como insignificantes, o que pode causar problemas com a ativação automática. Se você usar rastreadores desses fabricantes, recomendamos verificar com a equipe de suporte do seu serviço de SMS para garantir que eles não removam esses caracteres de espaço do início das mensagens.
* Algumas MVNOs globais fornecem cartões SIM para dispositivos IoT sem um número de telefone atribuído a eles. Em vez disso, esses cartões SIM são identificados pelo seu ICCID ou por algum outro número que identifica o SIM na rede. Como resultado, a comunicação com dispositivos que utilizam esses cartões SIM deve ser realizada via API fornecida pela MVNO.

### Como conectar o Navixy a gateways SMS

Para conectar seu gateway de mensagens preferido ao Navixy, forneça as credenciais necessárias à equipe de suporte do Navixy. Isso inclui detalhes como nome do gateway, URL da API, nome de usuário, senha e quaisquer outros parâmetros relevantes exigidos pelo provedor do gateway escolhido.

Abaixo você encontrará exemplos das credenciais necessárias para as opções mais comuns. Para qualquer gateway SMS, você também deve fornecer o Sender ID, se for suportado. Depois de reunir essas informações, envie-as à equipe de suporte do Navixy em <support@navixy.com> para obter assistência na configuração da integração e garantir que tudo esteja funcionando corretamente.

<details>

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

* Endereço IP do servidor SMPP
* Porta
* Login (system id)
* Senha

</details>

<details>

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

* ACCOUNT\_SID
* AUTH\_TOKEN

ou

* API\_SID
* API\_SECRET

</details>

<details>

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

* Endereço IP do dispositivo
* Porta
* Login
* Senha
* Identificador do span GSM

</details>

<details>

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

* URL
* Login
* Senha

</details>

<details>

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

* Login
* Chave de API

</details>