API de mensagens da BroadNet: REST, SMPP e um SDK TypeScript
A API de mensagens da BroadNet é uma API REST com token Bearer mais SMPP 3.4, com um SDK oficial em TypeScript, uma especificação OpenAPI 3.1 e um servidor MCP para agentes de IA. E a plataforma que movimenta mais de 300 milhões de mensagens por dia está a um npm install de distância.
Experimente a API
Preencha um pedido, clique em enviar e veja uma resposta e um fluxo de entrega simulados — aqui mesmo, sem registo.
Authorization: Bearer $BROADNET_TOKENcurl -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"
}'Preencha o pedido e clique em «Enviar pedido de teste» para ver uma resposta de exemplo.
É executado inteiramente no seu navegador. Nenhum pedido sai desta página e nenhum SMS é enviado.
SDK TypeScript, ou qualquer outra linguagem.
Um SDK oficial para TypeScript e Node.js. Todo o resto usa HTTPS puro: chame a API REST diretamente ou gere um cliente a partir da especificação.
Tudo o que você precisa, sem nada de supérfluo.
Seis pontos de entrada, definidos por caso de uso. Cada um deles leva a uma página específica — não a uma lista interminável de 200 abas.
O guia de migração mapeia as suas chamadas atuais de envio, relatório de entrega e webhook para a API da BroadNet, e cobre IDs de remetente, execução em paralelo, aumento gradual do tráfego e rollback.
Alterações datadas na especificação OpenAPI, no SDK, nos servidores MCP, na documentação e nas ferramentas para desenvolvedores.
Cinco coisas que você fará no primeiro dia.
Código real, não pseudocódigo. Copie, cole, altere o destinatário e envie.
Enviar SMS
Uma chamada HTTPS para POST /sms/sendSms devolve o ID da mensagem. Defina messageType como TEXT ou UNICODE e o status de entrega será enviado para o seu webhook.
// npm install @broadnet/cpaas-sdk axios
import { Configuration, SMSSMSApi } from "@broadnet/cpaas-sdk";
const sms = new SMSSMSApi(
new Configuration({
basePath: "https://api.broadnet.me",
accessToken: process.env.BROADNET_TOKEN!,
}),
);
const res = await sms.smsSendsmsPost({
sMSSmsRequest: {
senderId: "BroadNet",
destinationNumber: "447700900123",
message: "Your verification code is 482913",
messageType: "TEXT",
},
});
console.log(res.data); // message IDA plataforma, no ecrã.
Percursos rápidos pela consola de mensagens da BroadNet — inicie sessão, envie e meça. A mesma plataforma que a API utiliza.
Engenheiros de verdade, a apenas uma resposta de distância.
Um SDK oficial TypeScript no npm. Uma especificação OpenAPI pública e uma coleção no Postman. Uma equipa de suporte que gere as suas rotas — não uma fila de scripts de nível 1.
Um único caminho até à sua primeira mensagem, com o tempo de cada etapa.
- 01
Solicitar acesso de teste
Respondemos em 1 dia útilUm engenheiro de mensagens responde com as suas credenciais de teste e agenda uma chamada de 30 minutos sobre os seus países, volumes e caso de uso.
- 02
Primeira mensagem de teste
Cerca de 5 minutos após as credenciaisEnvie uma mensagem de teste para o seu próprio número verificado utilizando o código quickstart. O relatório de entrega (DLR) é enviado para o seu webhook.
- 03
Integração
2–5 dias úteisConstrua e teste com as suas credenciais de teste no mesmo endpoint dos exemplos de código. Um engenheiro da BroadNet trabalhará em conjunto com você via REST ou SMPP.
- 04
Aprovação
3–10 dias úteisA identidade do remetente, o propósito do tráfego e as regras de destino são analisados, e os Sender IDs são registados junto de cada regulador, em paralelo com a sua integração.
- 05
Produção
Dia da passagem a produçãoO acesso e as rotas de produção já estão ativos para a sua conta. A sua integração já chama o https://api.broadnet.me.
Total: 5–15 dias úteis do pedido à produção na maioria dos mercados; mais onde o registo do Sender ID junto do regulador demora mais.
Perguntas dos programadores
Peça acesso de teste em /signup. Um engenheiro da BroadNet responde no prazo de um dia útil com as suas credenciais de teste: o token de acesso que envia num cabeçalho Authorization: Bearer e o endereço para onde enviar o tráfego de teste. A sua primeira mensagem de teste pode sair cerca de cinco minutos depois de as receber.
Um único SDK oficial: @broadnet/cpaas-sdk para TypeScript e Node.js, no npm. Em qualquer outra linguagem, chame diretamente a REST API por HTTPS ou gere um cliente a partir da especificação OpenAPI (/developers/openapi.yaml).
O Postman cria-a a partir da especificação OpenAPI: importe /developers/openapi.yaml (OpenAPI 3.1) para obter uma coleção com todos os endpoints da BroadNet e, em seguida, adicione o seu token de acesso como variável de coleção Bearer.
A página de estado /status mostra a acessibilidade do website e da API pública, medida por verificações sintéticas a cada 5 minutos, e o registo de incidentes, com um feed RSS em /status/rss.xml para atualizações. Os endpoints de produção da API têm um SLA de disponibilidade de 99,99%.
A sua pergunta não está aqui? Consulte a nossa equipa de engenharia
Solicitar acesso de teste.
Envie as suas mensagens de teste para o seu próprio número verificado. Antes da produção, revisamos a identidade do remetente, a finalidade do tráfego e os requisitos de destino — a maioria das equipas entra em operação em 5 a 15 dias úteis.