> 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/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/on-premise-sms-gateway-troubleshooting.md).

# Solução de problemas do gateway SMS On-Premise

Solucione falhas do gateway de SMS no Navixy On-Premise. Verifique o status de ativação, confirme a operação do serviço e resolva erros de conexão e autenticação.

A plataforma Navixy oferece a capacidade de integração perfeita com gateways de SMS, possibilitando o envio de Mensagens. Para aproveitar todas as vantagens desse recurso, é necessário estabelecer uma conexão com um gateway de SMS. É importante observar que essa funcionalidade não é ativada por padrão e só pode ser acessada depois que você configurar as definições do gateway de SMS e ativá-la no banco de dados.

{% hint style="info" %}
O gateway de SMS não está configurado no painel de administração. Para aplicar ou alterar suas configurações, você precisa de acesso direto ao banco de dados.
{% endhint %}

O gateway de SMS é usado para os seguintes fins:

* Ativar novo rastreador (envio de comandos SMS de ativação).
* Envio de notificações de eventos (alertas).
* Configuração do dispositivo diretamente pela interface do usuário.

Aqui descrevemos as etapas de solução de problemas caso você esteja enfrentando problemas com a entrega de mensagens de texto, bem como com a ativação automática do dispositivo.

## Verificar as configurações do gateway de SMS

A primeira coisa a verificar é se você realmente tem um gateway de SMS ativado para a plataforma. Para isso, acesse seu banco de dados e execute a seguinte consulta SQL:

```
select * from google.sms_gates_to_dealers;
```

Se a saída estiver vazia, então você não tem nenhum gateway de SMS ativado. Vá para [a seção de configuração do gateway de SMS](/docs/on-premise/pt-br/on-premise/how-to-guide/configuration/sms-gateway-configuration.md) para encontrar informações sobre como configurá-lo.

Se a saída contiver informações, lembre-se do `gate_id` e execute a seguinte consulta:

```
select * from google.sms_gates;
```

Localize o gateway ativo pelo seu `id` valor (obtido como `gate_id` anteriormente) e verifique se seus parâmetros de conexão na `params` coluna são válidos. Se estiverem incorretos, edite-os.

Se todos os parâmetros estiverem corretos e o gateway de SMS estiver ativado, mas nenhuma mensagem for entregue, passe para a próxima etapa.

## Verifique o status do serviço de mensagens

Se as configurações parecerem corretas, certifique-se de que [Navixy SMS-server](/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/system-components.md#navixy-sms-server) está em execução. Este é o serviço responsável por toda a mensageria. Sem ele, nem e-mails nem SMS podem ser enviados.

[Verifique o status do serviço](/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/checking-service-statuses.md), e se ele estiver fora do ar, tente [reiniciá-lo](/docs/on-premise/pt-br/on-premise/how-to-guide/maintenance/restarting-instance.md) ou toda a plataforma.

Se o SMS-server estiver em execução, mas as mensagens ainda não forem entregues, prossiga para a próxima etapa.

## Verifique os logs do serviço

Verifique [o log do SMS-server](/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/system-components.md) em busca de quaisquer erros.

Para encontrar erros relacionados à entrega de mensagens SMS para um número de telefone específico, pesquise entradas de log que contenham esse número.

Para Linux, use o seguinte comando:

```
grep "12345678910" log.txt
```

Para Windows, use qualquer editor de texto avançado, pois o Bloco de Notas padrão não consegue lidar adequadamente com arquivos de texto grandes.

Os erros mais comuns na operação do gateway de SMS são os seguintes:

* Dados de autenticação incorretos (login/senha ou tokens de API).
* Endereço e/ou porta do gateway de SMS indisponíveis (problemas de rede).
* Endereço e/ou porta do gateway de SMS especificados incorretamente.
* Créditos insuficientes no gateway de SMS.
* Cota de mensagens do gateway de SMS excedida.

Todos os problemas acima podem ser identificados claramente com base nas entradas de log.

{% hint style="danger" %}
Observou-se que certos gateways de SMS removem o espaço duplo inicial em uma mensagem SMS. No entanto, é importante observar que esse espaço é necessário para ativar certos dispositivos, como Teltonika. Se você encontrar dificuldades ao ativar seus dispositivos, recomendamos entrar em contato com o provedor do seu gateway de SMS para verificar se eles oferecem suporte a espaços duplos.
{% endhint %}

Se você encontrar erros que indiquem falha do lado da plataforma Navixy, não deixe de relatá-los a [o suporte técnico](mailto:support@navixy.com), e forneceremos toda a assistência necessária.


---

# 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://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/on-premise-sms-gateway-troubleshooting.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.