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

# Visão geral

Envie e receba mensagens SMS com a API de SMS.

A API de SMS da Eseye permite enviar mensagens SMS Mobile Terminated (MT) para SIMs AnyNet e de terceiros. Você pode:

* Enviar uma mensagem SMS para um MSISDN de destino.
* Cancelar uma mensagem enfileirada ou não entregue.
* Verificar o status de entrega de uma mensagem.
* Enviar comprovantes de entrega para um endpoint que você controla.

### URL base

Envie solicitações de produção para:

```
https://messaging.eseye.com
```

Todas as solicitações devem usar HTTPS.

### Acesso e autenticação

A API de SMS é um serviço pago. As mensagens são cobradas de acordo com as tarifas do seu contrato da API de SMS.

Solicite acesso e preços enviando um e-mail para [orders@eseye.com](mailto:orders@eseye.com?subject=Request%20SMS%20API%20pricing). Inclua o nome da sua empresa, cargo, número de telefone e endereço de e-mail.

A Eseye fornece um nome de usuário e uma senha da API de SMS. Inclua essas credenciais como campos de formulário em cada solicitação:

```
username=<username>
password=<password>
```

As solicitações da API de SMS usam o seguinte tipo de conteúdo:

```http
Content-Type: application/x-www-form-urlencoded
```

A API de SMS não usa um token bearer OAuth 2.0.

{% hint style="warning" %}
Mantenha suas credenciais da API de SMS seguras. Não as confirme no controle de código-fonte, não as exponha em aplicações no lado do cliente e não as inclua em logs.
{% endhint %}

### Comportamento e limitações do SMS

* Mensagens SMS Mobile Terminated são enviadas da rede para um dispositivo.
* O destino deve ser informado como um MSISDN.
* Uma mensagem pode conter apenas `texto` ou `short_message`.
* Quando ambos os campos são fornecidos, `texto` tem prioridade.
* O `texto` campo suporta transporte de 7 bits ou 8 bits.
* O `short_message` campo contém dados da mensagem codificados em hexadecimal.
* Atribua um `message_id` exclusivo ao enviar uma mensagem, se precisar rastreá-la, cancelá-la ou verificar seu status.
* Uma mensagem só pode ser cancelada antes de ser entregue.
* Um valor opcional `expiração` controla quando uma mensagem não entregue expira. Informe o valor no `YYYY-MM-DD hh:mm:ss` formato.
* Um valor opcional `receipt_url` identifica o endpoint que recebe o comprovante de entrega.
* Quando `source` está vazio, o Serviço de Mensagens AnyNet envia a mensagem.
* As solicitações bem-sucedidas retornam uma resposta XML em vez de JSON.
* O uso da API de SMS é cobrado de acordo com o seu contrato.

### Suporte

Contato [Suporte da Eseye](mailto:support@eseye.com?subject=SMS%20API%20support%20request) para obter assistência com a API de SMS.


---

# 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://docs.eseye.com/api-reference/api-reference-pt-br/sms/overview.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.