# API SMS para mensagens críticas, via REST ou SMPP - URL canónico: https://www.broadnet.me/pt/products/sms-api - Idioma: pt - Última atualização: 2026-10-21 - Editor: BroadNet (https://www.broadnet.me) - Versão Markdown da página, gerada a partir da página publicada. API SMS · REST + SMPP Uma API de SMS que respeita o seu tempo. 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. [Planeie a sua integração API](https://www.broadnet.me/pt/contact?topic=api-integration&product=sms-api) [Solicitar acesso de teste](https://www.broadnet.me/pt/signup) ISO 27001 · 9001 · 22301 Em conformidade com o RGPD e a HIPAA Sub-segundo p99 POST /sms/sendSms 200 ``` // 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 ID ``` [Referência completa da API](https://www.broadnet.me/pt/developers/api) 42 ms · borda: AMS Tempo de atividade da API 99.99% SLA mensal contratado, multirregião Latência da API <350ms Objetivo p99, todas as regiões SDK oficial 1 TypeScript / Node.js + especificação OpenAPI 3.1 Países 200+ Mais de 1.000 rotas diretas operadas por operadores. Dentro de uma única requisição ## O que acontece entre o seu POST e um relatório de entrega. Um 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. 1. 01 · Request A sua aplicação · REST POST /sms/sendSms sobre TLS, autenticação por token Bearer, corpo JSON: senderId, destinationNumber, message, messageType. p50 < 41ms TTFB 2. 02 · Edge BroadNet API edge Verificação do token, validação do esquema e escolha da rota — o ID da mensagem volta diretamente na resposta. p50 < 60ms 3. 03 · Router Rota + fila 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. p50 < 10ms 4. 04 · Bind Operador SMPP 3.4 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. p50 < 1.5s 5. 05 · Webhook Relatório de entrega deliver_sm capturado e enviado por POST para a URL do seu webhook como relatório de entrega, vinculado ao ID da mensagem. p95 < 2s 6. ← relatório de entrega · webhook 01 · Request A sua aplicação · REST POST /sms/sendSms sobre TLS, autenticação por token Bearer, corpo JSON: senderId, destinationNumber, message, messageType. p50 < 41ms TTFB 02 · Edge BroadNet API edge Verificação do token, validação do esquema e escolha da rota — o ID da mensagem volta diretamente na resposta. p50 < 60ms 03 · Router Rota + fila 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. p50 < 10ms 04 · Bind Operador SMPP 3.4 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. p50 < 1.5s 05 · Webhook Relatório de entrega deliver_sm capturado e enviado por POST para a URL do seu webhook como relatório de entrega, vinculado ao ID da mensagem. p95 < 2s Protocolos ## REST ou SMPP — escolha o seu protocolo 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. REST · HTTPS api.broadnet.me/sms/sendSms Recomendado - JSON sobre HTTPS, TLS 1.3 - Autenticação por token Bearer — token obtido na sua conta BroadNet - POST /sms/sendSms · uma família de caminhos por canal - Envio imediato ou agendado - Relatórios de entrega enviados ao seu webhook - Referência completa em /developers/api Limites de taxa Sem limites fixos por conta Carga útil máxima 1 MiB SMPP 3.4 2775 sem encriptação · porta TLS fornecida com a sua conta Alto volume - SMPP binário v3.4 (v5.0 sob solicitação) - Binds Transmitter, Receiver e Transceiver - Até 32 binds simultâneos por conta - Encaminhamento de DLR via deliver_sm - Binds com TLS, lista de IPs permitidos por credencial - Vazão de até 30.000 msg/s por nó no plano empresarial Por nó 30k SMS/s Failover <800ms Window 100 msg O que você realmente recebe ## Seis coisas que você não precisará mais construir por conta própria. ### Novas tentativas seguras 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. ### Webhooks de entrega 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. ### Conexões simultâneas 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. ### Failover automático 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 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. ### Especificação OpenAPI 3.1 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. Histórias de clientes ## O que são equipas de engenharia de verdade? diga sobre a API. Uber Mobilidade · MENA AE SA 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. Engenheiro principal, plataforma de identidade Samsung Tecnologia de consumo · APAC ID 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. Engenheiro de equipa, plataforma de mensagens American Express Serviços financeiros · MENA EG 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. Diretor de Engenharia, Fraude e Risco 1:1 DLR ↔ ID da mensagem Bearer Autenticação por token em cada chamada Construído para produção ## Os números que colocamos por escrito. 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. Disponibilidade da API 99.99% SLA mensal Latência REST p99 <350ms Objetivo, todas as regiões Entrega de webhooks <2s p95 ponta a ponta Resposta a incidentes <15 min Plantão 24/7, confirmação de incidentes de severidade 1 Compromissos de nível de serviço [SLA completo Acordo de nível de serviço completo](https://www.broadnet.me/legal/sla) Disponibilidade mensal da API 99.99% Crédito de 10% abaixo de 99,99% · 25% abaixo de 99,0% · 50% abaixo de 95,0% Latência REST p50 <100ms Na borda, sem incluir a saída de rede Latência REST p99 <350ms Em todas as regiões Entrega de webhooks <2s p95 Backoff exponencial de até 24 h em caso de falha Disponibilidade de binds SMPP 99.99% Por região, com failover automático entre regiões Resposta a incidentes <15 min Plantão 24/7, confirmação de incidentes de severidade 1 Documentado por predefinição ## Os recibos. 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. [npm · @broadnet/cpaas-sdk SDK oficial em TypeScript 64 classes de API, uma por recurso de canal Ver no npm](https://www.npmjs.com/package/@broadnet/cpaas-sdk) [broadnet.me/developers/openapi.yaml Especificação OpenAPI 3.1 329 caminhos em oito canais Descarregar a especificação](https://www.broadnet.me/developers/openapi.yaml) [broadnet.me/developers Documentos e guias de início rápido 90s do registo à primeira mensagem enviada Ler a documentação](https://www.broadnet.me/pt/developers) TypeScript SDK Autenticação por token de portador broadnet.me/status Webhooks compatíveis com ngrok Perguntas frequentes dos compradores ## Questões de engenharia, respondeu diretamente. 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](https://www.broadnet.me/pt/contact) A API de SMS é um ponto de entrada para [a plataforma SMS A2P mais abrangente](https://www.broadnet.me/pt/products/a2p-sms)As mesmas rotas diretas da operadora também fornecem energia. [Campanhas de SMS em massa](https://www.broadnet.me/pt/products/bulk-sms), [OTP e verificação multicanal](https://www.broadnet.me/pt/products/otp), e [A API do WhatsApp Business](https://www.broadnet.me/pt/products/whatsapp-business-api). Fornecedores de balanças? Leia nosso [Melhor API de SMS em 2026](https://www.broadnet.me/pt/compare/best-sms-api-2026) Guia do comprador. Acesso de teste · resposta no prazo de um dia útil ## Pare de brigar com o seu fornecedor de SMS. Iniciar envio. 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. [Consulte o caminho de integração da API.](https://www.broadnet.me/pt/contact?topic=api-integration&product=sms-api) [Solicitar integração de desenvolvedores](https://www.broadnet.me/pt/onboarding) $ curl -X POST https://api.broadnet.me/sms/sendSms -H "Authorization: Bearer $BROADNET_TOKEN" -d '{"senderId":"BroadNet", …}' Recursos Ficha técnica SMS API [Descarregar ficha técnica· PDF, 101 kB](https://www.broadnet.me/resources/datasheets/broadnet-sms-api-datasheet.pdf) [Fichas técnicas de produto](https://www.broadnet.me/pt/resources) ## Guias e respostas relacionados Aprofunde-se nos conceitos por trás deste produto. - [O que é uma API de SMS Ler](https://www.broadnet.me/pt/answers/what-is-sms-api) - [Como enviar um SMS via API Ler](https://www.broadnet.me/pt/answers/how-to-send-sms-via-api) - [O que é SMPP Ler](https://www.broadnet.me/pt/answers/what-is-smpp) - [O que é SMS A2P Ler](https://www.broadnet.me/pt/answers/what-is-a2p-sms) - [O que é um SMSC Ler](https://www.broadnet.me/pt/answers/what-is-smsc) - [O que é latência hop-by-hop na entrega de SMS Ler](https://www.broadnet.me/pt/answers/what-is-hop-by-hop-latency)