Construtor de requisições API.
Preencha os campos e veja uma requisição SMS da BroadNet correta ser montada ao vivo — POST /sms/sendSms com token Bearer e corpo JSON, além de trechos prontos para copiar em cURL, Node, Python e com o TypeScript SDK. A API HTTP legada também está disponível, para integrações existentes da era SMPP. A ferramenta monta a requisição; nunca a envia.
O token de acesso à API da sua conta BroadNet. Guarde-o numa variável de ambiente (BROADNET_TOKEN), nunca no código-fonte.
O ID de remetente aprovado exibido ao destinatário.
Dígitos com o código do país e sem + inicial, ex.: 447700900123.
32 caracteres no corpo da mensagem
A REST API autentica cada chamada com um cabeçalho Authorization: Bearer que leva o token de acesso da sua conta. As credenciais nunca vão na URL nem no corpo JSON. Novas integrações devem usar esta API.
{
"senderId": "BroadNet",
"destinationNumber": "447700900123",
"message": "Your verification code is 482913",
"messageType": "TEXT"
}curl -X POST https://api.broadnet.me/sms/sendSms \ -H "Authorization: Bearer $BROADNET_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "senderId": "BroadNet", "destinationNumber": "447700900123", "message": "Your verification code is 482913", "messageType": "TEXT"}'HTTP/1.1 200 OK
2603121407537573731Um envio bem-sucedido devolve HTTP 200 com o ID da mensagem como corpo da resposta. Um token ausente ou inválido é rejeitado pelo gateway API com 401 e um corpo JSON com dois campos: error e message; outros erros API devolvem uma ExceptionResponse (status, error, message, errorCode, requestUri). O ID mostrado é ilustrativo.
Tudo é executado no seu navegador. Nenhuma requisição sai desta página e nenhuma credencial é transmitida. Copie um trecho e execute-o com o seu próprio token na API de produção.
A resposta curta
O que faz o construtor de requisições?
Ele transforma um formulário numa requisição correta para a API de SMS da BroadNet. Preencha o ID do remetente, o destinatário, a mensagem e a codificação, e a ferramenta monta POST /sms/sendSms com um cabeçalho Authorization: Bearer e um corpo JSON, junto com trechos de cURL, Node, Python e TypeScript SDK prontos para executar. Nada é enviado: ela produz exatamente a requisição que você mesmo executaria.
Como funciona um envio
Envie por POST um corpo JSON com quatro campos obrigatórios — senderId, destinationNumber, message e messageType (TEXT para GSM-7, UNICODE para todo o resto) — para /sms/sendSms, com o seu token no cabeçalho Authorization: Bearer. Uma resposta 200 traz o ID da mensagem. O TypeScript SDK oficial (@broadnet/cpaas-sdk) encapsula a mesma chamada; em qualquer outra linguagem, chame a REST API diretamente ou gere um cliente a partir da especificação OpenAPI 3.1.
Campos do corpo de POST /sms/sendSms
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
| senderId | Sim | O ID de remetente aprovado exibido ao destinatário. |
| destinationNumber | Sim | Número do destinatário: dígitos com o código do país, sem +. |
| message | Sim | O corpo da mensagem. |
| messageType | Sim | TEXT (GSM-7) ou UNICODE (árabe, emoji, outras escritas). |
| campaignName | Não | Um rótulo que agrupa os envios nos seus relatórios. |
| templateId | Não | ID do modelo registado, quando as regras locais exigem um. |
Parâmetros de GET /websmpp/websms (legada)
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
| user | Sim | Nome de utilizador da API legada (accesskey pode substituir user + pass). |
| pass | Sim | Palavra-passe da API legada. |
| sid | Sim | ID do remetente exibido ao destinatário. |
| mno | Sim | Número do destinatário com o código do país, sem +. |
| type | Sim | Codificação: 1 inglês/GSM-7, 2 Unicode, 3 inglês + caracteres especiais, 4 árabe. |
| text | Sim | Corpo da mensagem, codificado para URL. |
| schtime | Não | Horário de entrega agendado (yyyyMMddHHmm). |
| gmt | Não | Diferença de fuso horário do horário agendado. |
Perguntas frequentes
Esta ferramenta envia uma mensagem?
Não. O construtor monta a requisição inteiramente no seu navegador e a exibe. Nada é transmitido e nenhuma credencial sai da página. Copie um trecho e execute-o você mesmo com o seu próprio token.
Qual API devo usar?
Novas integrações devem usar a REST API: POST /sms/sendSms com um token Authorization: Bearer e um corpo JSON. A API HTTP legada (GET /websmpp/websms, com as credenciais como parâmetros de consulta) é mantida para integrações existentes da era SMPP.
Como faço a autenticação?
Envie o token de acesso da sua conta num cabeçalho Authorization: Bearer em cada chamada REST. O construtor mostra a variável de ambiente $BROADNET_TOKEN como marcador — mantenha o token real fora do código-fonte.
Qual é a diferença entre TEXT e UNICODE?
TEXT usa o alfabeto GSM-7: 160 caracteres num SMS simples e 153 por parte quando concatenado. UNICODE cobre árabe, emoji e outras escritas: 70 caracteres num SMS simples e 67 por parte. POST /sms/identify devolve o messageType correto e o número de segmentos de qualquer mensagem.
Existe um SDK?
Sim — um SDK oficial, para TypeScript / Node.js: @broadnet/cpaas-sdk (npm install @broadnet/cpaas-sdk axios). Em qualquer outra linguagem, chame a REST API diretamente como mostram os trechos, ou gere um cliente a partir da especificação OpenAPI 3.1.
Que resposta devo esperar?
Um POST /sms/sendSms bem-sucedido devolve HTTP 200 com o ID da mensagem no corpo da resposta. Um token Bearer ausente ou inválido resulta num código 401 do gateway API com um corpo JSON contendo error e message; outros erros devolvem uma ExceptionResponse com status, error, message, errorCode e requestUri.
Todos os endpoints, parâmetros e respostas na referência para desenvolvedores.
Crie uma conta para obter o seu token de acesso à API e os seus IDs de remetente.
REST + SMPP 3.4, autenticação por token Bearer, webhooks de entrega.
Todos os utilitários gratuitos da BroadNet para programadores.
Pronto para enviar de verdade?
Obtenha o seu token de acesso, insira o snippet gerado no seu código e envie mensagens de teste para o seu próprio número verificado antes de entrar em produção.