Mensajería y voz para agentes de IA.

Elija su método de acceso

Los agentes suelen necesitar dos cosas: datos para planificar y una forma de actuar. BroadNet los mantiene separados. El servidor de conocimiento responde preguntas sin necesidad de una cuenta; el envío siempre requiere su token.

Lo que un agente puede enviar

Se aplican las mismas reglas independientemente de la interfaz que utilice el agente: un ID de remitente registrado, un destinatario con consentimiento y un contenido adecuado para el canal.

Un ejemplo práctico: un agente planifica un lanzamiento de OTP

Un usuario pide a un agente que planifique el envío de códigos de un solo uso a los EAU. El agente realiza cuatro llamadas a herramientas en el servidor de conocimiento público. Los resultados a continuación son la salida real del servidor, recortada a los campos que utiliza el agente.

Copiar y pegar

Los ejemplos usan solo números ficticios. Lea el token desde una variable de entorno; nunca lo pegue en un chat ni en un archivo versionado.

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

Puntos de entrada legibles por máquina

Los agentes que navegan en lugar de conectarse pueden leerlo todo en archivos simples. Ninguno requiere inicio de sesión.

• llms.txt
  /llms.txt

  El índice del sitio para modelos de lenguaje, con una sección sobre el acceso y las restricciones de los agentes, además de un archivo por idioma.

• Habilidades del agente
  /.well-known/agent-skills/index.json

  Cinco runbooks SKILL.md: cobertura y precio, registro del ID de remitente, un primer SMS de prueba, acceso de prueba y conexión a los servidores MCP.

• Tarjeta de agente A2A
  /.well-known/agent-card.json

  Una tarjeta Agent2Agent para las mismas herramientas de conocimiento de solo lectura, servidas a través de JSON-RPC en /a2a.

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

  Un conjunto de enlaces RFC 9727 que apunta a la especificación OpenAPI, la documentación API, ambos servidores MCP y la página de estado.

• Tarjeta del servidor MCP
  /.well-known/mcp.json

  La tarjeta del servidor que describe ambos servidores MCP, su transporte y autenticación.

• OpenAPI 3.1
  /developers/openapi.yaml

  La descripción completa de la API REST: descárguela o genere a partir de ella un cliente tipado.

• Versiones Markdown
  /pricing/sms/uae.md

  Añada .md a la mayoría de las URL de la página, o envíe Accept: text/markdown para obtener una copia limpia de la página en Markdown.

• Archivos de datos
  /data/coverage.json

  Cobertura, precios publicados y regulaciones de cada mercado como JSON (CSV para cobertura y precios).

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

  Disponibilidad medida del sitio web, la pasarela de la API y ambos endpoints MCP, en el formato de resumen Statuspage v2.

Reglas que un agente debe seguir

Un agente que envía mensajes actúa en nombre de su marca utilizando sus credenciales. Integre estas reglas en sus instrucciones y herramientas.

• Consentimiento previo al contenido

  Envíe mensajes de marketing solo a los destinatarios que hayan dado su consentimiento y conserve el registro de dicha aceptación. La herramienta sender_id_rules devuelve las reglas de consentimiento de cada mercado.

• Respete las bajas

  Los mensajes promocionales incluyen la palabra clave de baja del mercado, como STOP. Un agente nunca enviará mensajes a un número que haya solicitado la baja.

• Solo ID de remitente registrados

  Muchos mercados requieren el registro previo de los ID de remitente alfanuméricos. El agente utiliza los ID de remitente aprobados en su cuenta, nunca uno inventado.

• Respete el horario restringido

  Varios mercados prohíben el marketing por la noche. sender_id_rules devuelve el horario restringido con su fuente; los OTP y las alertas suelen permitirse a cualquier hora.

• Proteja los flujos de OTP contra el bombeo (pumping)

  Los bots pueden activar envíos de OTP a números con los que obtienen beneficios. Limite la frecuencia de las solicitudes de código por número, IP y dispositivo, y bloquee los destinos a los que no presta servicio. MyOTP incluye estas protecciones de forma predeterminada.

• Una persona confirma cada envío

  Solicite permiso al cliente antes de utilizar cualquier herramienta de envío, especialmente si se dirige a múltiples destinatarios, y habilite únicamente las herramientas que el agente necesite.

• Realice pruebas en su propio número

  Con las credenciales de prueba, envíe mensajes únicamente a su propio número verificado. Los ejemplos y los prompts utilizan números ficticios.

• Mantenga el token fuera del chat

  El token es una credencial de envío. Cárguelo desde una variable de entorno, nunca desde un prompt, y revóquelo si se filtra.

Relacionado

Preguntas