Messaggistica e voce per agenti AI.

Scegli il metodo di accesso

Di solito un agente ha bisogno di due cose: dati per pianificare e un modo per agire. BroadNet le tiene separate. Il server di conoscenza risponde alle domande senza account; l'invio richiede sempre il tuo token.

Cosa può inviare un agente

Le stesse regole si applicano a qualsiasi interfaccia utilizzata dall'agente: un ID mittente registrato, un destinatario consenziente e contenuti adatti al canale.

Un esempio pratico: un agente pianifica un lancio OTP

Un utente chiede a un agente di pianificare l'invio di codici monouso negli Emirati Arabi Uniti. L'agente chiama quattro strumenti sul server di conoscenza pubblico. I risultati qui sotto sono l'output reale del server, ridotto ai campi che l'agente utilizza.

Copia e incolla

Gli esempi usano solo numeri fittizi. Leggi il token da una variabile d'ambiente; non incollarlo mai in una chat o in un file salvato nel repository.

{
  "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.

Punti di ingresso leggibili dalle macchine

Gli agenti che navigano invece di connettersi possono leggere tutto da semplici file. Nessuno richiede un login.

• llms.txt
  /llms.txt

  L'indice del sito per i modelli linguistici, con una sezione sull'accesso e i vincoli degli agenti, oltre a un file per ogni lingua.

• Skill per agenti
  /.well-known/agent-skills/index.json

  Cinque runbook SKILL.md: copertura e prezzi, registrazione dell'ID mittente, un primo SMS di prova, accesso di prova e connessione ai server MCP.

• Scheda agente A2A
  /.well-known/agent-card.json

  Una scheda Agent2Agent per gli stessi strumenti di conoscenza in sola lettura, erogati tramite JSON-RPC a /a2a.

• Catalogo API
  /.well-known/api-catalog

  Un set di link RFC 9727 che punta alla specifica OpenAPI, alla documentazione API, a entrambi i server MCP e alla pagina di stato.

• Scheda server MCP
  /.well-known/mcp.json

  La scheda server che descrive entrambi i server MCP, il loro trasporto e l'autenticazione.

• OpenAPI 3.1
  /developers/openapi.yaml

  La descrizione completa dell'API REST: scaricala o genera da essa un client tipizzato.

• Versioni Markdown
  /pricing/sms/uae.md

  Aggiungi .md alla maggior parte degli URL della pagina, oppure invia Accept: text/markdown, per ottenere una copia Markdown pulita della pagina.

• File dati
  /data/coverage.json

  Copertura, prezzi pubblicati e normative per ogni mercato come JSON (CSV per copertura e prezzi).

• Stato in JSON
  /status/api/v2/summary.json

  Raggiungibilità misurata del sito web, del gateway API e di entrambi gli endpoint MCP, nel formato riassuntivo Statuspage v2.

Regole che un agente deve seguire

Un agente che invia messaggi agisce per il tuo brand con le tue credenziali. Integra queste regole nelle sue istruzioni e nei suoi strumenti.

• Il consenso precede il contenuto

  Invia messaggi di marketing solo a chi ha dato il consenso (opt-in) e conserva la registrazione del consenso. Lo strumento sender_id_rules restituisce le regole di opt-in di ogni mercato.

• Rispetta le disiscrizioni

  I messaggi promozionali riportano la parola chiave di disiscrizione del mercato, ad esempio STOP. Un agente non scrive mai a un numero che si è disiscritto.

• Solo ID mittente registrati

  Molti mercati richiedono la pre-registrazione degli ID mittente alfanumerici. L'agente usa gli ID mittente approvati sul tuo account, mai uno inventato.

• Rispetta le fasce di silenzio

  Diversi mercati vietano il marketing di notte. sender_id_rules restituisce le fasce di silenzio con la relativa fonte; OTP e avvisi sono di solito consentiti 24 ore su 24.

• Proteggi i flussi OTP dal pumping

  I bot possono far partire invii di OTP verso numeri da cui i truffatori guadagnano. Limita le richieste di codice per numero, IP e dispositivo, e blocca le destinazioni che non servi. MyOTP ha queste protezioni attive per impostazione predefinita.

• Una persona conferma ogni invio

  Fai chiedere conferma al client prima di qualsiasi strumento che invia, soprattutto verso molti destinatari, e abilita solo gli strumenti di cui l'agente ha bisogno.

• Testa sul tuo numero

  Utilizzando le credenziali di prova, invia messaggi solo al tuo numero verificato. Gli esempi e i prompt utilizzano numeri fittizi.

• Mantieni il token fuori dalla chat

  Il token è una credenziale di invio. Caricalo da una variabile d'ambiente, mai da un prompt, e revocalo se viene esposto.

Correlati

Domande frequenti