Mensagens e voz para agentes de IA.

Escolha a forma de acesso

Os agentes precisam normalmente de duas coisas: factos para planear e uma forma de agir. A BroadNet mantém-nas separadas. O servidor de conhecimento responde a perguntas sem conta; o envio exige sempre o seu token.

O que um agente pode enviar

As mesmas regras aplicam-se seja qual for a interface que o agente utilize: um remetente registado, um destinatário com consentimento e conteúdo adequado ao canal.

Um exemplo prático: um agente planeia um lançamento de OTP

Um utilizador pede a um agente que planeie o envio de códigos de utilização única para os EAU. O agente chama quatro ferramentas no servidor de conhecimento público. Os resultados abaixo são a saída real do servidor, reduzida aos campos que o agente utiliza.

Copiar e colar

Os exemplos utilizam apenas números fictícios. Leia o token de uma variável de ambiente; nunca o cole num chat nem num ficheiro guardado no repositório.

{
  "mcpServers": {
    "broadnet-knowledge": {
      "type": "http",
      "url": "https://www.broadnet.me/mcp"
    },
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"estimate_price",
                 "arguments":{"country":"UAE","channel":"sms","volume":50000}}}'

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

# 200 OK → response body is the message ID, e.g. 2603121407537573731

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

# Send an approved WhatsApp template
curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-updates \
  -F destinationNo=447700900123 \
  -F messageType=TEMPLATE \
  -F templateName=order_update \
  -F templateLanguage=en_US \
  -F bodyTemplateVariables=INV-400

# 200 OK → the response carries the batchId; per-recipient status
# (SUBMITTED → SENT → DELIVERED → READ) arrives on your webhook.

Pontos de entrada legíveis por máquina

Os agentes que navegam em vez de se ligarem podem ler tudo em ficheiros simples. Nenhum exige login.

• llms.txt
  /llms.txt

  O índice do site para modelos de linguagem, com uma secção sobre o acesso e as restrições dos agentes, além de um ficheiro por idioma.

• Competências de agente
  /.well-known/agent-skills/index.json

  Cinco runbooks SKILL.md: cobertura e preço, registo do ID de remetente, um primeiro SMS de teste, acesso de teste e ligação aos servidores MCP.

• Cartão de agente A2A
  /.well-known/agent-card.json

  Um cartão Agent2Agent para as mesmas ferramentas de conhecimento de apenas leitura, servidas via JSON-RPC em /a2a.

• Catálogo API
  /.well-known/api-catalog

  Um conjunto de ligações RFC 9727 que aponta para a especificação OpenAPI, a documentação API, ambos os servidores MCP e a página de estado.

• Cartão do servidor MCP
  /.well-known/mcp.json

  O cartão do servidor que descreve ambos os servidores MCP, o seu transporte e autenticação.

• OpenAPI 3.1
  /developers/openapi.yaml

  A descrição completa da API REST: descarregue-a ou gere a partir dela um cliente tipado.

• Versões em Markdown
  /pricing/sms/uae.md

  Adicione .md à maioria das URLs da página, ou envie Accept: text/markdown, para obter uma cópia limpa da página em Markdown.

• Ficheiros de dados
  /data/coverage.json

  Cobertura, preços publicados e regulamentações para cada mercado como JSON (CSV para cobertura e preços).

• Estado em JSON
  /status/api/v2/summary.json

  Disponibilidade medida do website, do gateway da API e dos dois endpoints MCP, no formato de resumo Statuspage v2.

Regras que um agente deve seguir

Um agente que envia mensagens atua em nome da sua marca com as suas credenciais. Integre estas regras nas suas instruções e ferramentas.

• Consentimento antes do conteúdo

  Envie marketing apenas para destinatários que deram o seu consentimento e mantenha o registo de opt-in. A ferramenta sender_id_rules devolve as regras de opt-in de cada mercado.

• Respeite os opt-outs

  As mensagens promocionais incluem a palavra-chave de opt-out do mercado, como STOP. Um agente nunca envia mensagens para um número que tenha optado pela exclusão.

• Apenas IDs de remetente registados

  Muitos mercados exigem o pré-registo de IDs de remetente alfanuméricos. O agente utiliza os IDs de remetente aprovados na sua conta, nunca um inventado.

• Respeite as horas de silêncio

  Vários mercados proíbem o marketing durante a noite. O sender_id_rules devolve as horas de silêncio com a respetiva fonte; os OTP e os alertas são geralmente permitidos a qualquer hora.

• Proteja os fluxos de OTP contra o pumping

  Os bots podem desencadear envios de OTP para números com os quais os burlões lucram. Limite os pedidos de código por número, IP e dispositivo, e bloqueie os destinos que não serve. O MyOTP traz estas proteções ativas por predefinição.

• Uma pessoa confirma cada envio

  Faça com que o cliente peça confirmação antes de qualquer ferramenta que envie, sobretudo para muitos destinatários, e ative apenas as ferramentas de que o agente precisa.

• Teste no seu próprio número

  Com credenciais de teste, envie apenas para o seu próprio número verificado. Os exemplos e os prompts utilizam números fictícios.

• Mantenha o token fora do chat

  O token é uma credencial de envio. Carregue-o a partir de uma variável de ambiente, nunca de um prompt, e revogue-o se for exposto.

Relacionado

Perguntas