Uma API de SMS permite que o seu software envie mensagens de texto, como palavras-passe de uso único e alertas, com uma única requisição HTTP: com BroadNet, o seu código chama POST /sms/sendSms com um token Bearer ou se conecta via SMPP para pipelines de alto volume. Documentado numa especificação OpenAPI 3.1. Um SDK oficial em TypeScript. Relatórios de entrega via webhook. Acesso de teste mediante pedido.
// 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 IDUm handshake TLS, cinco saltos otimizados, dois webhooks. Cada etapa tem o seu próprio orçamento de latência — e cada orçamento está no SLA, não na página de marketing.
POST /sms/sendSms sobre TLS, autenticação por token Bearer, corpo JSON: senderId, destinationNumber, message, messageType.
Verificação do token, validação do esquema e escolha da rota — o ID da mensagem volta diretamente na resposta.
A pontuação de qualidade por rota seleciona a vinculação SMPP legal mais rápida. Failover ativo-ativo multirregional em menos de 800 ms.
Conexão SMPP direta com a operadora de rede móvel de destino. O ficheiro submit_sm foi enviado; o número de sequência foi rastreado para correlação com o DLR.
deliver_sm capturado e enviado por POST para a URL do seu webhook como relatório de entrega, vinculado ao ID da mensagem.
POST /sms/sendSms sobre TLS, autenticação por token Bearer, corpo JSON: senderId, destinationNumber, message, messageType.
Verificação do token, validação do esquema e escolha da rota — o ID da mensagem volta diretamente na resposta.
A pontuação de qualidade por rota seleciona a vinculação SMPP legal mais rápida. Failover ativo-ativo multirregional em menos de 800 ms.
Conexão SMPP direta com a operadora de rede móvel de destino. O ficheiro submit_sm foi enviado; o número de sequência foi rastreado para correlação com o DLR.
deliver_sm capturado e enviado por POST para a URL do seu webhook como relatório de entrega, vinculado ao ID da mensagem.
A maioria das equipas usa REST para envios e nunca olha para trás. Operadoras de alto volume, agregadores e sistemas legados se integram ao SMPP 3.4. Mesmas rotas, mesmo SLA, mesmo painel — escolha a interface que melhor se adapta à tarefa.
Cada envio aceito devolve um ID de mensagem. Tente novamente em erros de rede e 5xx com backoff, e concilie os relatórios de entrega pelo ID de mensagem em vez de reenviar às cegas — os workers em segundo plano podem falhar e se recuperar de forma limpa.
Os relatórios de entrega são enviados para a URL do seu webhook e vinculados ao ID da mensagem, tanto para tráfego REST quanto SMPP — sem loop de polling para escrever.
Até 32 ligações SMPP paralelas por conta. Multiplexação HTTP/2 em REST. Sem limites de taxa fixos por conta — o débito é dimensionado ao seu tráfego, nunca limitado por ligação.
Multirregional ativo-ativo. Se uma rota se degradar durante a campanha, restabelecemos a conexão em menos de 800 ms e reenviamos as mensagens em trânsito. Sem necessidade de implementar lógica de reconexão SMPP.
Sem limites de taxa fixos por conta — o débito é dimensionado ao seu tráfego, até 30.000 SMS/seg por nó. Sem limitação silenciosa, sem números bloqueados às escondidas — sabe sempre qual é a sua situação.
Legível por máquina, disponível em /developers/openapi.yaml. O SDK oficial em TypeScript é gerado a partir dela; gere um cliente em qualquer outra linguagem ou importe-a no Postman ou no Insomnia.
Desafio: uma pilha de mensagens com vários fornecedores gerava OTPs duplicados em rajadas de novas tentativas, um bug aberto havia muito tempo. Abordagem: uma migração para a API REST da BroadNet com um único caminho de envio, novas tentativas apenas em erros de rede e 5xx, e cada envio rastreado pelo ID de mensagem que a API regressa, lançada atrás de um único feature flag.
Desafio: uma organização de mensagens com muitos desenvolvedores perdia tempo constantemente com mudanças de API não documentadas entre versões. Abordagem: a especificação OpenAPI 3.1 é tratada como o contrato, com clientes tipados regenerados na CI a cada versão.
Desafio: a equipa antifraude não confiava em eventos de entrega recebidos que não pudesse vincular a um envio. Abordagem: cada relatório de entrega é conciliado com o ID de mensagem devolvido no envio, com a rotação de Sender ID absorvida no mesmo fluxo.
Essas metas são contratuais nos planos empresariais, não são apenas aspirações. Caso não sejam atingidas, os créditos abaixo serão aplicados automaticamente na próxima fatura.
O SDK oficial em TypeScript é gerado a partir da especificação pública OpenAPI 3.1, então os dois nunca divergem. Gere um cliente em qualquer outra linguagem ou importe a especificação no Postman. A documentação funciona no mesmo ambiente de staging que o seu código.
Peça acesso de teste e respondemos num dia útil com as suas credenciais de teste; a primeira mensagem de teste chega ao seu número verificado cerca de cinco minutos depois. O tráfego de produção começa normalmente em 5 a 15 dias úteis, condicionado pelo registo do Sender ID junto do regulador, e não por nada do nosso lado.
Tente novamente apenas em erros de rede e 5xx, com backoff exponencial, e guarde o ID de mensagem que a API regressa para cada envio aceito. Concilie os relatórios de entrega pelo ID de mensagem antes de reenviar, em vez de novas tentativas às cegas, e recarregue créditos antes que um saldo baixo bloqueie o tráfego.
Real. A especificação OpenAPI 3.1 em /developers/openapi.yaml (JSON em /developers/openapi.json) documenta todos os canais: SMS, WhatsApp, RCS, Telegram, Push, Email, Messenger e Instagram. O SDK oficial em TypeScript (@broadnet/cpaas-sdk) é gerado a partir dela, e você pode gerar o seu próprio cliente em qualquer outra linguagem sem nos pedir.
Não há taxa API — você paga por mensagem, por país, por rota. Transações nos Emirados Árabes Unidos começam em US$ 0,0123/MT, na Arábia Saudita em US$ 0,016 e no Egito em US$ 0,028. Conexões SMPP estão incluídas no plano empresarial; no plano padrão, cada conexão dedicada custa US$ 250/mês. O acesso para testes é feito mediante solicitação, e o tráfego de testes é limitado a 1.000 mensagens por dia.
Tentamos novamente com recuo exponencial por 24 horas: 30s, 2m, 10m, 30m, 2h, 8h, 24h. Cada tentativa inclui um cabeçalho X-Webhook-Attempt. Após 24 horas, o evento é armazenado na fila de mensagens não entregues (DLQ), podendo ser consultado e reproduzido no painel de controlo com um único clique. O plano Standard mantém a DLQ por 7 dias; o plano Enterprise, por 90 dias.
Sim — eles partilham encaminhamento, DLRs, faturação e painéis. A maioria dos clientes usa REST para o transacional e SMPP para marketing de alto volume na mesma conta, e os relatórios de entrega dos dois caminhos chegam aos mesmos relatórios e webhooks.
Gerente de contas técnicas designado, SLA de disponibilidade da API de 99,99% com créditos de serviço sobre a mensalidade (10% abaixo de 99,99%, 25% abaixo de 99,0%, 50% abaixo de 95,0%), pager NOC 24 horas por dia, 7 dias por semana, com confirmação de severidade 1 em menos de 15 minutos, conexões SMPP dedicadas, revisões trimestrais de arquitetura e um canal Slack partilhado com a equipa de engenharia.
O site broadnet.me/status exibe o status dos componentes e quaisquer incidentes relatados. Ele ainda não é alimentado por monitorização em tempo real, portanto, o seu histórico de 90 dias é ilustrativo, não medido; o valor contratual é o SLA de disponibilidade de 99,99%.
A sua pergunta não está aqui? Consulte a nossa equipa de engenharia
A API de SMS é um ponto de entrada para a plataforma SMS A2P mais abrangenteAs mesmas rotas diretas da operadora também fornecem energia. Campanhas de SMS em massa, OTP e verificação multicanal, e A API do WhatsApp Business.
Fornecedores de balanças? Leia nosso Melhor API de SMS em 2026 Guia do comprador.
Um token de acesso, um SDK oficial em TypeScript e um início rápido que cabe num único ecrã. O caminho mais rápido do registo ao seu primeiro relatório de entrega.
Recursos
Ficha técnica SMS API
Aprofunde-se nos conceitos por trás deste produto.