Cómo enviar emails y SMS con un agente de IA (guía de la API Mailpro™)

Un agente de IA que solo sabe conversar es un chatbot. Un agente de IA capaz de enviar el email, mandar un SMS al cliente y actualizar la ficha del contacto es un compañero de equipo. Esta guía explica cómo conectar Claude, GPT o cualquier LLM compatible con tool calling a las API de Mailpro™, para que tu agente envíe emails y SMS por su cuenta, de forma segura y con cada mensaje registrado y rastreable.

En resumen

• Mailpro™ ofrece tres API HTTPS que tu agente puede llamar: la Email API v2 (emails transaccionales y campañas), la CRM API v3 (contactos, listas, etiquetas) y la SMS API.
• Cada acción se encapsula en una pequeña herramienta (tool): el modelo decide cuándo llamarla y tu código hace la petición HTTP.
• Autentícate con un token OAuth 2.0 limitado a los scopes que el agente necesita, nunca con tu clave API maestra dentro de un prompt.
• Usa webhooks (email.delivered, email.bounced, sms.delivered…) para que el agente sepa qué ha pasado realmente.
• Mantén un paso de aprobación humana para los envíos masivos y los destinatarios desconocidos.

¿Por qué dar a tu agente de IA la capacidad de enviar emails y SMS?

Porque la mayor parte del valor de un agente está en lo que hace después de entender la petición. Un agente de soporte que redacta una respuesta es útil; uno que envía la respuesta, confirma el reembolso por SMS y etiqueta al contacto como "reembolsado" cierra el ticket. Tareas típicas que ya funcionan bien hoy:

• Seguimiento de pedidos y reservas — un email de confirmación con una nota personal escrita por el agente, más un SMS recordatorio la víspera.
• Clasificación del soporte — el agente clasifica el ticket, responde por email a los casos sencillos y deriva el resto a una persona.
• Códigos de un solo uso y alertas — el agente genera un código, lo envía por SMS y lo comprueba cuando el usuario responde.
• Resúmenes diarios — el agente lee los datos del día y envía un único email de resumen en lugar de cuarenta notificaciones.

¿Qué son las API de Mailpro™, en 30 segundos?

Las tres aceptan el mismo token OAuth 2.0 (emitido una sola vez en https://api.mailpro.com/oauth/token), devuelven JSON y comparten una cuota mensual de peticiones por cuenta. Cada endpoint está documentado, con ejemplos de petición y respuesta, en el portal para desarrolladores de Mailpro™.

¿Cómo llama un agente de IA a una API de email o SMS?

Mediante tool calling (Anthropic lo llama tool use; OpenAI, function calling). Describes cada acción como una herramienta con un esquema JSON. Cuando el modelo decide que hace falta una acción, devuelve una llamada a la herramienta con sus argumentos; tu código los valida, llama a la API de Mailpro™ y devuelve el resultado al modelo. El modelo nunca tiene tus credenciales ni hace él mismo la petición HTTP.

Si prefieres no escribir el bucle tú mismo, las mismas herramientas pueden exponerse a través de un servidor MCP (Model Context Protocol), que Claude Desktop, Claude Code y Cursor pueden usar directamente. Las llamadas a la API que hay debajo son las mismas.

Ejemplo mínimo: Claude envía un email y un SMS

1. Obtén un token con scopes limitados

curl -X POST https://api.mailpro.com/oauth/token \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "scope=email:send email:read sms:send"

Crea el client ID y el secret en tu cuenta Mailpro™, en Settings → API access (Configuración → acceso API). El token de acceso dura 20 minutos; tu código pide uno nuevo cuando caduca.

2. Define las herramientas

tools = [
  {
    "name": "send_email",
    "description": "Envía un email transaccional a un único destinatario.",
    "input_schema": {
      "type": "object",
      "properties": {
        "to": {"type": "string"},
        "subject": {"type": "string"},
        "html": {"type": "string"}
      },
      "required": ["to", "subject", "html"]
    }
  },
  {
    "name": "send_sms",
    "description": "Envía un SMS (máx. 160 caracteres) a un único número de teléfono.",
    "input_schema": {
      "type": "object",
      "properties": {
        "to": {"type": "string", "description": "Formato internacional, p. ej. +41791234567"},
        "message": {"type": "string"}
      },
      "required": ["to", "message"]
    }
  }
]

3. Ejecuta las llamadas a las herramientas

import requests

API = "https://api.mailpro.com"
SENDER_ID = 201  # obtenido con GET /v2/senderEmail/list

def run_tool(name, args, token):
    h = {"Authorization": f"Bearer {token}"}
    if name == "send_email":
        r = requests.post(f"{API}/v2/send/sendmail.json", headers=h, data={
            "IDEmailExp": SENDER_ID,
            "EmailData": args["to"],
            "Subject": args["subject"],
            "BodyHTML": args["html"],
            "ActivateStatistics": "true",
        })
    elif name == "send_sms":
        r = requests.post(f"{API}/sms/send/add_single.json", headers=h, data={
            "to": args["to"],
            "message": args["message"],
        })
    else:
        return {"error": "unknown tool"}
    return r.json()

Conecta run_tool a tu bucle habitual de Claude (u OpenAI): envía el mensaje del usuario con tools, ejecuta cada llamada a herramienta que devuelva el modelo y devuelve el resultado como tool result. La llamada de email devuelve un IdSingleSend; la de SMS, un Id. Guarda ambos: son los que te permiten seguir la entrega.

¿Prefieres no programar? Los emails automáticos de Mailpro envían confirmaciones, recordatorios y alertas a partir de disparadores que configuras en pocos clics.

¿Cómo sabe el agente si el mensaje se entregó?

Una respuesta 200 significa que Mailpro™ aceptó el mensaje, no que haya llegado a la bandeja de entrada o al teléfono. Hay dos formas de cerrar el círculo:

• Consulta periódica (polling) — GET /v2/send/{IdSingleSend}/status.json devuelve queued, sent, delivered, deferred o bounced para un email transaccional.
• Webhooks (recomendado) — te suscribes una vez con POST /webhooks y Mailpro™ envía un evento firmado a tu servidor: email.delivered, email.bounced, email.opened, sms.delivered, sms.failed y otros. Cada petición lleva una cabecera HMAC X-Mailpro-Signature para que puedas verificar que procede de Mailpro™.

Devuelve estos eventos al agente y podrá reaccionar por sí solo: reintentar por email un SMS fallido o señalar a una persona una dirección rebotada.

Seguridad y buenas prácticas para los envíos gestionados por IA

Da al agente un token con scopes limitados, no tus claves

Los tokens OAuth llevan scopes como email:send, email:read, contacts:read o sms:send. Un agente que solo envía confirmaciones no necesita contacts:write. Una llamada fuera de sus scopes falla con 403 insufficient_scope. Guarda el client secret en variables de entorno del lado del servidor; nunca lo pongas en un prompt.

Mantén a una persona en el circuito para los envíos de riesgo

Deja que el agente envíe por su cuenta los mensajes individuales, pero exige aprobación para las campañas (/v2/send/campaign, /sms/send/add), para los destinatarios que no están en tus listas de contactos y para cualquier mensaje que hable de dinero. Una simple lista blanca de dominios o listas de destinatarios en el código de tus herramientas evita que un prompt malintencionado acabe enviando un mailing masivo a tus clientes.

Respeta la cuota y espera antes de reintentar tras un error

Tus peticiones API comparten una cuota mensual entre las API Email, CRM y SMS (consúltala con GET /v2/account/limits.json). Un agente atrapado en un bucle puede agotarla rápidamente: limita el número de llamadas a herramientas por conversación y, ante respuestas 429 y 5xx, reintenta con espera exponencial (exponential backoff) en lugar de reintentar de inmediato.

Respeta el consentimiento y las bajas

Los contactos dados de baja o en lista negra se omiten automáticamente, y la API te lo indica. No dejes que el agente lo eluda. Para los SMS, comprueba las normas de cada país de destino antes de enviar mensajes de marketing.

Regístralo todo

Guarda cada llamada a herramienta con sus argumentos, la respuesta de la API y el ID devuelto. Cuando un cliente pregunte "¿por qué he recibido esto?", podrás responder en segundos.

Caso práctico (ficticio): "LoopKart" deja que Claude redacte sus emails posventa

LoopKart es una pequeña tienda online que vende equipamiento de cocina reacondicionado. Sus emails posventa eran una única plantilla para todos. El equipo conectó Claude a la Email API de Mailpro™ con una sola herramienta send_email: tras cada pedido, el agente lee el pedido y el historial del cliente, redacta un breve párrafo personal (consejos de cuidado para el producto concreto, una mención si es un cliente habitual) y envía el email a través de /v2/send/sendmail. Una segunda herramienta envía un SMS cuando sale el paquete. Los pedidos por encima de un importe fijado, y cualquier mensaje que mencione un reembolso, esperan el clic de una persona antes de enviarse. La puesta en marcha le llevó al equipo dos días, la mayor parte dedicada a redactar y probar la regla de aprobación.

Preguntas frecuentes

¿Qué modelos de IA funcionan con la API de Mailpro™?

Cualquier modelo compatible con tool calling o function calling: Claude, GPT, Gemini, Mistral y modelos de código abierto servidos con un framework de tool calling. La API en sí es HTTPS y JSON estándar, así que el modelo solo necesita una capa ligera.

¿Necesito un plan de pago de Mailpro™ para empezar?

No. Puedes empezar con el plan gratuito, probarlo todo y pasar a un plan superior cuando tu volumen lo justifique. Consulta las tarifas de Mailpro.

¿Puede el agente enviar a una lista completa?

Sí, con /v2/send/campaign para el email y /sms/send/add para los SMS. Recomendamos un paso de aprobación humana para estos envíos.

¿Existe un servidor MCP?

Puedes exponer las mismas herramientas a través de cualquier framework de servidor MCP; las llamadas que hay debajo son las que se muestran arriba.

Para ir más lejos

• Emails transaccionales y campañas en detalle: API de emails transaccionales para agentes de IA
• Contactos, listas y etiquetas: Automatiza tu CRM con IA
• SMS, códigos y recordatorios: Enviar SMS con un agente de IA
• Llegar a la bandeja de entrada: solución de problemas de entregabilidad del email
• La pasarela SMS en sí: API SMS de Mailpro