> 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/api-de-sms/overview.md).

# Visão geral

Envie e receba mensagens SMS com a API de SMS.

A API 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 na fila ou não entregue.
* Verificar o status de entrega de uma mensagem.
* Enviar recibos de entrega para um endpoint que você controla.

### URL base

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

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

Todas as requisições devem usar HTTPS.

### Acesso e autenticação

A API SMS é um serviço pago. As mensagens são cobradas de acordo com as tarifas do seu contrato da API 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 SMS. Inclua essas credenciais como campos de formulário em toda requisição:

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

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

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

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

{% hint style="warning" %}
Mantenha suas credenciais da API SMS seguras. Não as envie para o controle de versão, não as exponha em aplicativos do lado do cliente nem 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 fornecido como um MSISDN.
* Uma mensagem pode conter um destes: `text` ou `short_message`.
* Quando ambos os campos são fornecidos, `text` tem prioridade.
* O `text` campo suporta transporte de 7 bits ou 8 bits.
* O `short_message` O campo contém dados da mensagem codificados em hexadecimal.
* Atribua um identificador exclusivo `message_id` ao enviar uma mensagem se você precisar rastrear, cancelar ou verificar seu status.
* Uma mensagem só pode ser cancelada antes de ser entregue.
* Um valor opcional de `expiry` controla quando uma mensagem não entregue expira. Insira o valor no `YYYY-MM-DD hh:mm:ss` formato.
* Um valor opcional de `receipt_url` identifica o endpoint que recebe o recibo de entrega.
* Quando `source` estiver vazio, o Serviço de Mensagens AnyNet envia a mensagem.
* As requisições bem-sucedidas retornam uma resposta XML em vez de JSON.
* O uso da API SMS é cobrado de acordo com o seu contrato.

### Suporte

Contato [Suporte da Eseye](mailto:support@eseye.com?subject=SMS%20API%20support%20request) para suporte à API 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 by asking a question.

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

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