# Como enviar um SMS via API?

> Enviar um SMS por meio de uma API HTTP significa passar o número de destino, o ID do remetente e o texto da mensagem para um endpoint REST que entrega a mensagem às redes da operadora e devolve um ID de mensagem que você pode rastrear para verificar a entrega.

- URL canônico: https://www.broadnet.me/pt/answers/how-to-send-sms-via-api
- Idioma: pt
- Última revisão: 2026-09-24
- Editor: BroadNet (https://www.broadnet.me)

## O pedido

O gateway da BroadNet aceita um POST para https://api.broadnet.me/sms/sendSms com um token no cabeçalho Authorization: Bearer e um corpo JSON: senderId (o ID do remetente), destinationNumber (o número de destino em formato internacional, somente dígitos, sem o sinal +), message (o texto) e messageType (TEXT para GSM-7, UNICODE para árabe, emojis e outros alfabetos não latinos). Uma chamada bem-sucedida devolve 200 OK com o ID da mensagem no corpo da resposta.

## Codificação e comprimento

Uma mensagem GSM-7 comporta 160 caracteres por segmento (153 quando a mensagem ocupa vários segmentos); ao mudar para Unicode por causa de emojis ou alfabetos não latinos, o limite cai para 70 (67 em mensagens concatenadas). Defina messageType como TEXT para GSM-7 simples e UNICODE quando o texto precisar de Unicode ou árabe, para que os caracteres não fiquem corrompidos; POST /sms/identify devolve a codificação e o número de segmentos antes do envio.

## Acompanhe a entrega, não presuma nada.

O ID da mensagem devolvida é o identificador dos relatórios de entrega (DLRs). Configure um webhook para receber o status final da operadora — entregue, falha ou expirado — em vez de considerar um código 200 no envio como prova de que o aparelho recebeu a mensagem.

## Passando para a produção

Use números E.164 internacionais, registe o seu ID de remetente em cada mercado de destino antes de expandir e envie por rotas diretas da operadora para obter latência consistente. Para alto volume, a mesma conta pode ser acedida via SMPP e REST, permitindo que você comece com HTTP e alterne entre os tipos de vinculação sem precisar realizar um novo processo de integração.

## Perguntas frequentes

### Posso enviar um SMS com uma solicitação GET ou preciso usar o método POST?

Use POST. O endpoint REST POST /sms/sendSms recebe um corpo JSON e um token Bearer, então o texto da mensagem e as credenciais nunca aparecem em URLs ou logs do servidor. A API HTTP legada (/websmpp/websms) ainda aceita GET para integrações existentes da era SMPP, mas novas integrações devem usar a API REST.

### Preciso de SMPP ou a API HTTP é suficiente?

A API REST/HTTP é suficiente para a maioria dos volumes e é a mais rápida de integrar. SMPP é adequado para taxas de transferência sustentadas muito altas e conexões persistentes. A mesma conta BroadNet funciona em ambos os protocolos, então você pode começar com HTTP e adicionar SMPP posteriormente sem precisar realizar um novo processo de integração.

### Como posso ter certeza de que uma mensagem foi realmente entregue?

O envio devolve um ID de mensagem; o status final do dispositivo chega de forma assíncrona como um relatório de entrega (DLR) no seu webhook — entregue, falhou ou expirou. Não considere a resposta do envio como comprovativo de entrega.

## Relacionados

- [Todas as respostas](https://www.broadnet.me/pt/answers)
- [Glossário](https://www.broadnet.me/pt/answers)
- [O que é uma API de SMS?](https://www.broadnet.me/pt/answers/what-is-sms-api)
- [O que é SMS A2P?](https://www.broadnet.me/pt/answers/what-is-a2p-sms)
- [O que é um DLR (relatório de entrega)?](https://www.broadnet.me/pt/answers/what-is-dlr)
- [Como posso melhorar as taxas de entrega de SMS?](https://www.broadnet.me/pt/answers/how-to-improve-sms-delivery-rates)
- [SMS API](https://www.broadnet.me/pt/products/sms-api)
- [A2P SMS](https://www.broadnet.me/pt/products/a2p-sms)