> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/admin/pt-br/settings/messaging-gateways/sms-gateway.md).

# Gateway de SMS

Conecte um provedor de SMS à Navixy para enviar comandos de dispositivos M2M, mensagens de ativação e notificações SMS de usuários por meio do gateway de SMS

A **Gateway de SMS** é um gateway de mensagens que permite que sua plataforma envie e receba mensagens SMS na Navixy.

<figure><img src="https://1027635053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKdgeXg71LpaDrwexQYwp%2Fuploads%2Fgit-blob-38522b1bffa1742ebe027bd44d7b6efe69ac1b38%2Fimage.png?alt=media" alt="SMS gateway page" width="563"><figcaption><p>Página do gateway de SMS</p></figcaption></figure>

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

* **Mensagens M2M:** Este gateway de SMS é usado para enviar comandos e receber respostas de dispositivos IoT. Ele permite a ativação totalmente automática do dispositivo na plataforma Navixy (Ativar novo rastreador) e atua como uma forma alternativa de se comunicar com o dispositivo quando a comunicação principal via IP não é possível, como em áreas de roaming.
* **Notificações do usuário:** Ao integrar seu provedor de serviços SMS com a Navixy, você pode enviar Alertas e notificações por SMS aos seus usuários quando certos eventos ocorrerem, como quando um dispositivo fica offline ou quando uma Geocerca é violada.

### Tipos de gateways de SMS

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

1. **Provedores globais de serviços populares**\
   A Navixy está integrada a vários provedores globais de serviços 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ços oferecem cobertura mundial, embora alguns possam ter presença mais forte em certas regiões para oferecer melhor conectividade e preços. Ao selecionar um provedor de mensagens, a Navixy recomenda considerar esses provedores primeiro.
2. **Centrais de SMS que funcionam com o protocolo SMPP comum**\
   A Navixy pode funcionar com qualquer central de SMS que use o protocolo SMPP. O SMPP é usado por várias centrais de SMS em todo o mundo. Se o serviço de sua preferência oferecer suporte a SMPP v3.4, a Navixy pode se integrar facilmente a ele.
3. **Dispositivos de gateway de hardware**\
   A Navixy também oferece suporte a dispositivos VoIP de hardware, como dispositivos Yeastar (anteriormente Neogate), especificamente a série TG. Esses dispositivos podem ser usados para enviar e receber mensagens SMS. Esta opção não é recomendada, mas pode ser usada para instâncias menores.

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

A Navixy recomenda adquirir um número de telefone dedicado para usar como Sender ID para enviar comandos e receber respostas do dispositivo. Isso é preferível a usar 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 se o seu gateway de SMS oferece suporte a esses caracteres e tipos de mensagem. Caso contrário, os comandos poderão ser alterados durante a transmissão e executados incorretamente.

Alguns problemas conhecidos incluem:

* Os 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, a Navixy recomenda 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.
* Alguns 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 por seu ICCID ou por algum outro número que identifica o cartão SIM dentro da rede. Como resultado, a comunicação com dispositivos que usam esses cartões SIM deve ser realizada por meio da API fornecida pelo MVNO.

### Como conectar a Navixy aos gateways de SMS

Para conectar seu gateway de mensagens preferido à Navixy, forneça as credenciais necessárias à equipe de suporte da 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 de SMS, você também deve fornecer o Sender ID, se houver suporte. Depois de reunir essas informações, envie-as para a equipe de suporte da Navixy em <support@navixy.com> para receber ajuda 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 (id do sistema)
* 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 da API

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/admin/pt-br/settings/messaging-gateways/sms-gateway.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
