# API de mensagens da BroadNet: REST, SMPP e um SDK TypeScript

- URL canónico: https://www.broadnet.me/pt/developers
- Idioma: pt
- Última atualização: 2026-10-20
- Editor: BroadNet (https://www.broadnet.me)
- Versão Markdown da página, gerada a partir da página publicada.

Centro de desenvolvedores · v2026.05

Construído para engenheiros. Teste primeiro, depois lance.

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.

[Solicitar acesso de teste](https://www.broadnet.me/pt/signup) [Leia o guia de início rápido.](https://www.broadnet.me/pt/developers/quickstart) [Referência da API](https://www.broadnet.me/pt/developers/api)

Acesso de teste mediante pedido Resposta no prazo de um dia útil SOC 2, ISO 27001

![Cinematic visualization of the BroadNet developer messaging API](https://www.broadnet.me/marketing/generated/viz-sms-api.png)

BroadNet · API para desenvolvedores

api.broadnet.me

REST + SMPP

protocolos

8

canais

300M+/day

mensagens

Interativo

## Experimente a API

Preencha um pedido, clique em enviar e veja uma resposta e um fluxo de entrega simulados — aqui mesmo, sem registo.

POST api.broadnet.me/sms/sendSms

Pedido

`Authorization: Bearer $BROADNET_TOKEN`

request.sh

```
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"
    }'
```

Resposta

Resposta de exemplo — nenhuma mensagem é enviada

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.

[Solicitar acesso de teste](https://www.broadnet.me/pt/signup) [Referência completa da API](https://www.broadnet.me/pt/developers/api)

Canais, uma API

8

SMS · WhatsApp · RCS · Telegram · E-mail · Notificações Push · Messenger · Instagram

SLA de disponibilidade da API

99.99%

Contratual, em endpoints API de produção

Latência da API p99

<350ms

Da sua região para /sms/sendSms

Especificação OpenAPI

3.1

329 caminhos · 376 operações · disponível para download

SDK oficial

## 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.

[TypeScript / Node.js O SDK oficial, @broadnet/cpaas-sdk: gerado a partir da especificação OpenAPI BroadNet, com definições de tipo completas. `npm install @broadnet/cpaas-sdk axios` Ver no npm](https://www.npmjs.com/package/@broadnet/cpaas-sdk)

[Qualquer linguagem via OpenAPI Invoque a API REST a partir de qualquer linguagem ou gere um cliente tipado a partir da especificação OpenAPI 3.1 com o openapi-generator. Descarregue o ficheiro openapi.yaml](https://www.broadnet.me/developers/openapi.yaml)

[Servidor MCP Conecte agentes de IA ao BroadNet por meio do Protocolo de Contexto de Modelo, utilizando o seu token BroadNet. Configurar MCP](https://www.broadnet.me/pt/developers/mcp)

Documentaçã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.

[Início rápido Obtenha um token, instale o SDK TypeScript ou use curl e envie o seu primeiro SMS. Abrir](https://www.broadnet.me/pt/developers/quickstart)

[Referência da API Autenticação Bearer, envio, envio em massa, pesquisa de número, erros e o ponto de extremidade de envio de cada canal. Abrir](https://www.broadnet.me/pt/developers/api)

[Especificação OpenAPI OpenAPI 3.1: 329 caminhos e 376 operações em 8 canais. Faça o download ou gere um cliente. Abrir](https://www.broadnet.me/pt/developers/openapi)

[Servidor MCP Conecte agentes de IA ao BroadNet por meio do Protocolo de Contexto de Modelo. Abrir](https://www.broadnet.me/pt/developers/mcp)

[SMPP 3.4 Vinculação SMPP direta para cargas de trabalho contínuas de alto volume. O host e as portas são fornecidos com o seu acesso de teste. Abrir](https://www.broadnet.me/pt/developers/smpp)

[Webhooks O status da entrega é enviado para o URL do webhook na sua conta, além dos endpoints para consultá-lo. Abrir](https://www.broadnet.me/pt/developers/webhooks)

[Vai mudar de fornecedor de SMS? 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. Ler o guia de migração](https://www.broadnet.me/pt/developers/migrate)

O que mudou e quando

Alterações datadas na especificação OpenAPI, no SDK, nos servidores MCP, na documentação e nas ferramentas para desenvolvedores.

[Ler o histórico de alterações](https://www.broadnet.me/pt/developers/changelog) [Feed Atom](https://www.broadnet.me/changelog.xml)

Receitas comuns

## 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.

[API de SMS](https://www.broadnet.me/pt/products/sms-api)

sms.ts

```
// 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
```

Veja em ação

## A 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.

[Iniciar sessão e repor a palavra-passe Iniciar sessão e repor a palavra-passe](https://www.youtube.com/watch?v=i851uzE5gMI)

[Enviar uma mensagem única Enviar uma mensagem única](https://www.youtube.com/watch?v=TIG0n1C9ecE)

[Consultar os relatórios de entrega Consultar os relatórios de entrega](https://www.youtube.com/watch?v=op5OjCrAlIQ)

Comunidade e apoio

## 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.

[npm O SDK oficial TypeScript / Node.js, com definições de tipo completas. Instale-o com npm e axios. npmjs.com/package/@broadnet/cpaas-sdk](https://www.npmjs.com/package/@broadnet/cpaas-sdk)

[Carteiro Uma coleção das chamadas essenciais, ou importe a especificação OpenAPI para cada operação. Import collection](https://www.broadnet.me/pt/developers/postman)

[Apoiar Suporte técnico 24 horas por dia, 7 dias por semana, para contas de produção. Resposta P1 em 15 minutos. developers@broadnet.me](mailto:developers@broadnet.me)

Do pedido à produção

## Um único caminho até à sua primeira mensagem, com o tempo de cada etapa.

1. 01 Solicitar acesso de teste Respondemos em 1 dia útil Um 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.
2. 02 Primeira mensagem de teste Cerca de 5 minutos após as credenciais Envie 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.
3. 03 Integração 2–5 dias úteis Construa 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.
4. 04 Aprovação 3–10 dias úteis A 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.
5. 05 Produção Dia da passagem a produção O 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 frequentes dos compradores

## 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](https://www.broadnet.me/pt/contact)

Acesso de teste · resposta no prazo de um dia útil

## 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.

[Solicitar acesso de teste](https://www.broadnet.me/pt/signup) [Fale com a equipa de engenharia.](https://www.broadnet.me/pt/contact)

$ npm install @broadnet/cpaas-sdk axios · primeiro SMS de teste cinco minutos após as credenciais