Messaging und Voice für KI-Agenten.

Wählen Sie Ihren Zugang

Agenten brauchen meist zweierlei: Fakten für die Planung und eine Möglichkeit zu handeln. BroadNet hält beides getrennt. Der Wissensserver beantwortet Fragen ohne Konto; Senden erfordert immer Ihr Token.

Was ein Agent senden kann

Es gelten dieselben Regeln, unabhängig von der Oberfläche, die der Agent nutzt: eine registrierte Absenderkennung, ein eingewilligter Empfänger und Inhalte, die zum Kanal passen.

Ein Praxisbeispiel: Ein Agent plant einen OTP-Launch

Ein Nutzer bittet einen Agenten, den Versand von Einmalpasswörtern in die VAE zu planen. Der Agent ruft vier Tools auf dem öffentlichen Wissensserver auf. Die Ergebnisse unten sind die echte Ausgabe des Servers, gekürzt auf die Felder, die der Agent nutzt.

Kopieren und Einfügen

Die Beispiele verwenden nur fiktive Nummern. Lesen Sie das Token aus einer Umgebungsvariablen; fügen Sie es nie in einen Chat oder eine eingecheckte Datei ein.

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

Maschinenlesbare Einstiegspunkte

Agenten, die lieber lesen als sich verbinden, finden alles in einfachen Dateien. Keine davon erfordert einen Login.

• llms.txt
  /llms.txt

  Das Seitenverzeichnis für Sprachmodelle, mit einem Abschnitt über Agentenzugriff und Einschränkungen sowie einer Datei pro Sprache.

• Agent Skills
  /.well-known/agent-skills/index.json

  Fünf SKILL.md-Runbooks: Abdeckung und Preis, Registrierung der Absenderkennung, eine erste Test-SMS, Testzugang und die Verbindung zu den MCP-Servern.

• A2A-Agentenkarte
  /.well-known/agent-card.json

  Eine Agent2Agent-Karte für dieselben schreibgeschützten Wissens-Tools, bereitgestellt über JSON-RPC unter /a2a.

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

  Ein RFC 9727-Linkset, das auf die OpenAPI-Spezifikation, die API-Dokumentation, beide MCP-Server sowie die Statusseite verweist.

• MCP-Serverkarte
  /.well-known/mcp.json

  Die Serverkarte, die beide MCP-Server sowie deren Transport und Authentifizierung beschreibt.

• OpenAPI 3.1
  /developers/openapi.yaml

  Die vollständige Beschreibung der REST-API: herunterladen oder daraus einen typisierten Client generieren.

• Markdown-Zwillinge
  /pricing/sms/uae.md

  Fügen Sie .md zu den meisten Seiten-URLs hinzu oder senden Sie Accept: text/markdown, um eine saubere Markdown-Kopie der Seite zu erhalten.

• Datendateien
  /data/coverage.json

  Abdeckung, veröffentlichte Preise und Regulierungen für jeden Markt als JSON (CSV für Abdeckung und Preise).

• Status als JSON
  /status/api/v2/summary.json

  Gemessene Erreichbarkeit der Website, des API-Gateways und beider MCP-Endpunkte im Format der Statuspage-v2-Zusammenfassung.

Regeln, die ein Agent befolgen muss

Ein Agent, der Nachrichten versendet, agiert im Namen Ihrer Marke mit Ihren Zugangsdaten. Integrieren Sie diese Regeln in seine Anweisungen und Tools.

• Einwilligung vor Inhalt

  Senden Sie Marketing nur an Empfänger mit Opt-in und bewahren Sie den Opt-in-Nachweis auf. Das Tool sender_id_rules liefert die Opt-in-Regeln jedes Marktes.

• Opt-outs respektieren

  Werbebotschaften enthalten das Opt-out-Keyword des jeweiligen Marktes, wie z. B. STOP. Ein Agent kontaktiert niemals eine Nummer, die sich per Opt-out abgemeldet hat.

• Nur registrierte Absenderkennungen

  In vielen Märkten ist eine Vorabregistrierung von alphanumerischen Absenderkennungen erforderlich. Der Agent verwendet ausschließlich die für Ihr Konto genehmigten Absenderkennungen und niemals selbst erfundene.

• Ruhezeiten beachten

  Mehrere Märkte verbieten Marketing in der Nacht. sender_id_rules liefert die belegten Ruhezeiten; OTP und Alerts sind meist rund um die Uhr erlaubt.

• OTP-Flows vor Pumping schützen

  Bots können OTP-Versand an Nummern auslösen, an denen Betrüger mitverdienen. Begrenzen Sie Code-Anfragen pro Nummer, IP und Gerät und sperren Sie Ziele, die Sie nicht bedienen. MyOTP hat diese Schutzmechanismen standardmäßig aktiviert.

• Eine Person bestätigt jeden Versand

  Lassen Sie den Client vor jedem Tool, das sendet, nachfragen – besonders bei vielen Empfängern – und aktivieren Sie nur die Tools, die der Agent braucht.

• Mit der eigenen Nummer testen

  Senden Sie mit Test-Zugangsdaten nur an Ihre eigene verifizierte Nummer. Beispiele und Prompts verwenden fiktive Nummern.

• Das Token gehört nicht in den Chat

  Das Token ist ein Sende-Zugangsdatum. Laden Sie es aus einer Umgebungsvariablen, nie aus einem Prompt, und widerrufen Sie es, falls es offengelegt wurde.

Weiterführend

Fragen