Messagerie et voix pour les agents IA.

Choisissez votre mode d'accès

Les agents ont généralement besoin de deux éléments : des faits pour planifier et un moyen d'agir. BroadNet les maintient séparés. Le serveur de connaissances répond aux questions sans compte ; l'envoi nécessite toujours votre jeton.

Ce qu'un agent peut envoyer

Les mêmes règles s'appliquent quelle que soit la surface utilisée par l'agent : un identifiant d'expéditeur enregistré, un destinataire ayant donné son consentement (opt-in) et un contenu adapté au canal.

Exemple concret : un agent planifie un lancement d'OTP

Un utilisateur demande à un agent de planifier l'envoi de codes de passe unique vers les Émirats arabes unis. L'agent appelle quatre outils sur le serveur de connaissances public. Les résultats ci-dessous sont les sorties réelles du serveur, limitées aux champs utilisés par l'agent.

Copier et coller

Les exemples utilisent uniquement des numéros fictifs. Lisez le jeton depuis une variable d'environnement ; ne le collez jamais dans un chat ni dans un fichier versionné.

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

Points d'entrée lisibles par machine

Les agents qui naviguent plutôt que de se connecter peuvent tout lire dans de simples fichiers. Aucun ne nécessite de connexion.

• llms.txt
  /llms.txt

  L'index du site pour les modèles de langage, avec une section sur l'accès et les contraintes des agents, plus un fichier par langue.

• Compétences de l'agent
  /.well-known/agent-skills/index.json

  Cinq guides d'exécution SKILL.md : couverture et prix, enregistrement de l'identifiant d'expéditeur, un premier SMS de test, accès de test et connexion aux serveurs MCP.

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

  Une fiche Agent2Agent pour les mêmes outils de connaissances en lecture seule, diffusée via JSON-RPC à /a2a.

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

  Un ensemble de liens RFC 9727 pointant vers la spécification OpenAPI, la documentation API, les deux serveurs MCP et la page de statut.

• Carte serveur MCP
  /.well-known/mcp.json

  La carte serveur décrivant les deux serveurs MCP, leur transport et leur authentification.

• OpenAPI 3.1
  /developers/openapi.yaml

  La description complète de l'API REST : téléchargez-la ou générez-en un client typé.

• Jumeaux Markdown
  /pricing/sms/uae.md

  Ajoutez .md à la plupart des URL de la page, ou envoyez Accept: text/markdown, pour obtenir une copie Markdown propre de la page.

• Fichiers de données
  /data/coverage.json

  Couverture, tarifs publiés et réglementations pour chaque marché sous forme de JSON (CSV pour la couverture et les tarifs).

• Statut JSON
  /status/api/v2/summary.json

  Accessibilité mesurée du site web, de la passerelle API et des deux points de terminaison MCP, sous la forme du résumé Statuspage v2.

Règles que l'agent doit suivre

Un agent qui envoie des messages agit au nom de votre marque avec vos identifiants. Intégrez ces règles dans ses instructions et ses outils.

• Le consentement avant le contenu

  Envoyez des messages marketing uniquement aux destinataires ayant donné leur consentement (opt-in), et conservez la preuve de ce consentement. L'outil sender_id_rules renvoie les règles de consentement (opt-in) de chaque marché.

• Respectez les demandes de désinscription

  Les messages promotionnels incluent le mot-clé de désinscription du marché, tel que STOP. Un agent n'envoie jamais de message à un numéro qui s'est désinscrit.

• Identifiants d'expéditeur enregistrés uniquement

  De nombreux marchés exigent le pré-enregistrement des identifiants d'expéditeur alphanumériques. L'agent utilise les identifiants d'expéditeur approuvés sur votre compte, jamais un identifiant inventé.

• Respectez les heures de silence

  Plusieurs marchés interdisent le marketing la nuit. sender_id_rules renvoie les heures de silence sourcées ; les OTP et les alertes sont généralement autorisés 24 h/24.

• Protégez les flux OTP contre le pumping

  Les bots peuvent déclencher des envois OTP vers des numéros dont ils tirent profit. Limitez le débit des demandes de code par numéro, IP et appareil, et bloquez les destinations que vous ne desservez pas. MyOTP active ces protections par défaut.

• Une personne confirme chaque envoi

  Demandez au client l'autorisation avant d'utiliser tout outil d'envoi, en particulier vers de nombreux destinataires, et n'activez que les outils nécessaires à l'agent.

• Testez sur votre propre numéro

  Avec des identifiants de test, envoyez uniquement à votre propre numéro vérifié. Les exemples et les prompts utilisent des numéros fictifs.

• Ne communiquez pas le jeton dans le chat

  Le jeton est un identifiant d'envoi. Chargez-le via une variable d'environnement, jamais via un prompt, et révoquez-le en cas de fuite.

Articles connexes

Questions