BroadNet
Alterações API·/changelog

Registo de alterações da API.

Cada alteração na API é datada. Mudanças significativas só são implementadas numa nova versão principal.

Navegável·Atualizado continuamente·Secção 15 de 15Centro de desenvolvedores

Overview

Alterações datadas na área de desenvolvedores da BroadNet, das mais recentes para as mais antigas. Cada entrada traz a data em que a alteração entrou no ar, e as mesmas entradas são publicadas no feed Atom /changelog.xml. Para ver os detalhes campo a campo, compare a especificação OpenAPI entre downloads: uma diferença na especificação é uma diferença na API.

19 de outubro de 2026 · estimate_price aplica o nível gratuito do serviço WhatsApp

Para o canal whatsapp com use_case care (alias service), a estimate_price agora subtrai as 1.000 mensagens de serviço gratuitas que a Meta atribui a cada número de telefone empresarial por mês (a partir de 1 de outubro de 2026) antes de calcular o estimatedMonthlyUsd, e devolve um objeto freeTier com a franquia, as contagens de mensagens gratuitas e faturáveis e o pressuposto de um número empresarial. As estimativas de utilidade, autenticação e marketing permanecem inalteradas. O mesmo se aplica à ferramenta da página estimate_price.

19 de outubro de 2026 · Estado como JSON e Markdown compatíveis com Statuspage

A /status/api/v2/summary.json devolve as verificações medidas apresentadas em /status no formato de resumo Statuspage v2 (página, estado, componentes, incidentes, scheduled_maintenances), e /status.md é a versão Markdown da página. Os componentes são as sete verificações sintéticas: website, documentação para programadores, gateway API, servidor de conhecimento MCP, endpoint de produto MCP, cartão de agente A2A e llms.txt. Estas medem a acessibilidade de endpoints públicos, não o estado de entrega interno da plataforma de mensagens. /api/status permanece inalterado.

19 de outubro de 2026 · MCP de conhecimento: ferramentas de estudos de caso, changelog e estado

O servidor de conhecimento MCP público em https://www.broadnet.me/mcp (versão 1.1.0) tem mais quatro ferramentas de apenas leitura: list_case_studies e get_case_study para os estudos de caso publicados, get_changelog para as entradas deste changelog (filtros: since, kind, limit) e get_status para as verificações de acessibilidade medidas de /api/status. O agente A2A também as lista como competências, e as nove ferramentas existentes permanecem inalteradas. Para pedidos que utilizam a revisão do protocolo de 2026-07-28, todos os resultados nomeiam agora o servidor em _meta, e ping já não é respondido, conforme especificado nessa revisão.

19 de outubro de 2026 · robots.txt nomeia AzureAI-SearchBot e bedrockbot

O robots.txt tem grupos explícitos para AzureAI-SearchBot e bedrockbot, com as mesmas regras Allow e Disallow e a mesma linha Content-Signal que os outros crawlers de IA nomeados.

18 de outubro de 2026 · Versões Markdown de ferramentas, eventos e páginas da academia

/tools, /events e /academy, bem como as páginas sob eles, têm versões Markdown em inglês e nas sete localizações completas, por exemplo /tools/smpp-simulator.md e /fr/events.md. São geradas a partir da página renderizada.

10 de outubro de 2026 · Dados de preços: nível gratuito WhatsApp de 1.000 mensagens de serviço

A linha do Serviço WhatsApp em /data/pricing.csv, /data/pricing.json, /pricing.md e as versões Markdown de /pricing/whatsapp, e a nota em /data/pricing.json, indicam agora que as respostas de janela de serviço são faturadas à taxa de utilidade do mercado após um nível gratuito de 1.000 mensagens de serviço por número de telefone empresarial por mês (página de preços da Meta, atualizada a 30 de setembro de 2026). Os modelos de utilidade são faturados a partir da primeira mensagem. Taxas e colunas permanecem inalteradas.

10 de outubro de 2026 · Versões Markdown das páginas de comparação, guias, explicações, clientes e suporte

/compare, /guides e /explained e as páginas subordinadas, /customers, /customers/case-studies e cada estudo de caso, e /support-sla têm versões Markdown em inglês e nas sete localizações completas, por exemplo /explained/smpp.md e /fr/compare.md.

10 de outubro de 2026 · Feed RSS do blog em todos os idiomas do site e um feed de eventos

Cada idioma do site tem o seu próprio feed de blog em /<language>/blog/rss.xml, por exemplo /fr/blog/rss.xml e /ja/blog/rss.xml, ao lado do /blog/rss.xml em inglês. /events/rss.xml é um novo feed RSS de eventos.

10 de outubro de 2026 · URLs com letras maiúsculas e minúsculas são redirecionadas para a página em minúsculas

Uma URL de página digitada com letras maiúsculas, como /About ou /Pricing/SMS/Nigeria, responde agora com um único redirecionamento 308 para a página em minúsculas quando essa página existe. Ficheiros, caminhos de /api/ e /.well-known/ e tokens sensíveis à capitalização permanecem inalterados.

2 de outubro de 2026 · Verificações de estado medidas e /api/status

/status mostra a acessibilidade medida do website, documentação para programadores, gateway API, ambos os endpoints MCP, o cartão do agente A2A e llms.txt: verificações sintéticas a cada 5 minutos, com o uptime de 24 horas, 7 dias e 30 dias calculado apenas a partir de amostras armazenadas. GET /api/status devolve os mesmos dados em JSON. O histórico ilustrativo que a página mostrava anteriormente foi removido.

2 de outubro de 2026 · Catálogo de dados abertos em /data

/data lista todos os ficheiros legíveis por máquina que a BroadNet publica (cobertura, regulamentos e tarifas em CSV e JSON; factos, conformidade e SLA em JSON; o feed de changelog) com os seus campos, contagem de registos e data da última revisão, em inglês e nas sete localizações completas.

1 de outubro de 2026 · Certificado TLS válido em api.broadnet.me

https://api.broadnet.me, o host da API de produção chamado por todos os exemplos de código, agora apresenta um certificado Let's Encrypt publicamente confiável emitido para api.broadnet.me. Os clientes HTTPS e o SDK se conectam com a verificação do certificado ativada; não desative a verificação na sua integração.

1 de outubro de 2026 · Dados de preços: respostas do WhatsApp na janela de atendimento cobradas por mensagem

Desde 1º de outubro de 2026, a linha Service do WhatsApp em /data/pricing.csv, /data/pricing.json, /pricing.md e nas versões Markdown de /pricing/whatsapp traz a tarifa de tabela utility em vez de 0, com uma nota de que as respostas dentro da janela de atendimento ao cliente de 24 horas são cobradas por mensagem. A mudança é acionada pela data, portanto as colunas não mudam. A ferramenta estimate_price do servidor MCP de conhecimento calcula use_case care (alias service) da mesma forma.

30 de setembro de 2026 · estimate_price valida os seus argumentos

A ferramenta estimate_price do servidor MCP de conhecimento agora rejeita um channel ou use_case desconhecido, um volume negativo ou não numérico e um valor de segments que não seja um número inteiro de 1 a 255, com um erro que lista os valores válidos. Antes, um use_case não reconhecido era calculado silenciosamente como otp. Os nomes de categoria da Meta são aceitos como aliases: authentication = otp, utility = transactional, service = care.

30 de setembro de 2026 · Acesso para agentes: /api/search no robots.txt, alias de papel A2A, perguntas sobre a empresa

O robots.txt agora permite /api/search, o endpoint público de busca indicado no llms.txt; todos os outros caminhos /api/ continuam bloqueados. O endpoint A2A /a2a aceita o valor de papel "user" do A2A 0.x além de "ROLE_USER". A busca do site, que também atende a ferramenta MCP search_site, devolve a página da empresa correspondente para perguntas sobre a empresa (fundador, sede, razão social, clientes, status de Meta Business Solution Provider, SDK) nos 15 idiomas do site.

29 de setembro de 2026 · MCP de conhecimento: nomes de países em qualquer idioma do site e argumento language

check_coverage, sender_id_rules, estimate_price e get_regulation identificam um país pelo nome em qualquer um dos 15 idiomas do site (por exemplo السعودية ou 沙特阿拉伯), por formas curtas como UAE, KSA e UK, pelo slug ou pelo código ISO alfa-2 ou alfa-3; o agente A2A e a busca do site usam o mesmo índice. check_coverage, sender_id_rules, estimate_price, get_facts, get_regulation e get_answer aceitam um argumento language com qualquer um dos 15 idiomas do site; quando uma ferramenta não tem conteúdo nesse idioma, responde em inglês com "fallback": true. Para WhatsApp, estimate_price marca o preço com o âmbito "global list rate", a menos que haja uma tarifa publicada por país.

29 de setembro de 2026 · Versões Markdown das páginas traduzidas de preços e factos

As páginas de preços de SMS, WhatsApp, voz e OTP, as suas páginas por país e a página de factos da empresa agora também têm versões Markdown em árabe, francês, espanhol, alemão, italiano, português e russo, por exemplo /fr/pricing/sms.md e /ar/about/facts.md. Antes, apenas as páginas em inglês tinham essas versões.

29 de setembro de 2026 · Índices llms.txt completos por idioma

Os índices por idioma na pasta /llms/ (por exemplo /llms/fr.txt) agora listam todos os posts do blog que constam no sitemap desse idioma, as páginas para desenvolvedores e os kits de registo de sender ID da região MENA, com títulos e descrições nesse idioma quando a página os tem.

27 de setembro de 2026 · Servidor MCP público de conhecimento

Um servidor MCP público e apenas para leitura em https://www.broadnet.me/mcp responde perguntas sobre cobertura de BroadNet, regras de ID do remetente, tabelas de preços publicadas, regulamentações e factos sobre a empresa. Não requer token e possui nove ferramentas de apenas leitura: search_site, get_facts, check_coverage, sender_id_rules, estimate_price, count_sms_segments, get_regulation, list_answers e get_answer.

27 de setembro de 2026 · Exemplos de início rápido em oito idiomas

O guia de início rápido agora mostra a chamada send-SMS com o TypeScript SDK e em Python, PHP, Java, C#, Go, Ruby e curl. As amostras Java, C#, Go e Ruby foram compiladas com as suas respetivas toolchains, e cada amostra chama https://api.broadnet.me, a API de produção.

27 de setembro de 2026 · Ficheiros de dados de preços e habilidades de agentes

O índice em /.well-known/agent-skills/index.json lista os runbooks para agentes de IA. As tabelas de preços publicadas podem ser descarregadas como /data/pricing.csv e /data/pricing.json, e /ai/compliance.json e /ai/sla.json descrevem a conformidade e os níveis de serviço.

26 de setembro de 2026 · Descoberta de API legível por máquina

/.well-known/api-catalog (RFC 9727) lista a REST API e o servidor MCP com links para as suas descrições e documentação, e /.well-known/mcp/server-card.json serve um cartão de servidor MCP. As páginas de documentação possuem versões em Markdown (adicione .md à URL ou envie Accept: text/markdown), os dados de cobertura e regulamentação podem ser descarregados em /data/, e llms.txt possui um índice complementar para cada idioma na pasta /llms/.

25 de setembro de 2026 · Páginas para desenvolvedores em 15 idiomas

O hub do desenvolvedor, o guia de início rápido e a página MCP também estão disponíveis em turco, chinês, indonésio, hindi, coreano, japonês e urdu, além de inglês, árabe, francês, espanhol, alemão, italiano, português e russo. Os exemplos de código permanecem na sua forma original.

24 de setembro de 2026 · Especificação OpenAPI 3.1 publicada

A especificação da API pública pode ser descarregada em /developers/openapi.yaml e /developers/openapi.json: OpenAPI 3.1, 329 caminhos e 376 operações em oito canais, com exemplos internos removidos. Importe-a no Postman ou gere um cliente para qualquer linguagem com o openapi-generator.

24 de setembro de 2026 · Referência da API para a REST API de Bearer-token

As páginas de referência da API, de início rápido e de códigos de erro documentam a REST API de Bearer-token, por exemplo POST /sms/sendSms, e descrevem /websmpp como a antiga HTTP API. Os erros estão documentados em ambos os seus formatos: o 401 do gateway da API para um token ausente ou inválido, e o ExceptionResponse da API.

24 de setembro de 2026 · Documentação do servidor MCP

O /developers/mcp explica como conectar agentes de IA à API da BroadNet por meio do servidor MCP em https://mcp.broadnet.me/mcp (HTTP Streamable, autorizado com o seu token BroadNet).

24 de setembro de 2026 · Guia de migração

O /developers/migrate mapeia as chamadas de envio, relatório de entrega e webhook que você usa hoje para a API da BroadNet, e abrange IDs de remetente, execução paralela, rampa de tráfego e rollback.

23 de setembro de 2026 · TypeScript SDK 2.0.0 no npm

O @broadnet/cpaas-sdk 2.0.0, o SDK TypeScript/Node.js oficial, foi publicado no npm. Ele é gerado a partir da especificação BroadNet OpenAPI. Para outras linguagens, gere um cliente a partir da especificação.

10 de setembro de 2026 · Simulador de sessão SMPP

O /tools/smpp-simulator percorre uma sessão SMPP 3.4 (bind_transceiver, submit_sm, o relatório de entrega deliver_sm, enquire_link e unbind) com os bytes de cada PDU e casos comuns de falha. Ele roda no navegador e não pode enviar mensagens.

30 de julho de 2026 · Construtor de requisições API e estimador de custos SMS

O /tools/api-request-builder constrói uma requisição e a exibe como código pronto para copiar; ele nunca envia. O /tools/sms-cost-estimator fornece um custo mensal indicativo com base no volume, comprimento da mensagem e na taxa de referência por país.

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

Solicite acesso para testes e desenvolva com confiança.

Responderemos em até um dia útil com as credenciais de teste. Em seguida, instale o SDK TypeScript ou aceda à API REST de qualquer linguagem e envie a sua primeira mensagem de teste para o seu próprio número.

$npm install @broadnet/cpaas-sdk axiosready