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

Los grandes modelos de lenguaje ya no solo conversan. Con tool use, function calling y el Model Context Protocol se han transformado en agentes que actúan — y una de las acciones más valiosas que pueden realizar es enviar un email o un SMS en tu nombre. Esta guía pilar muestra cómo conectar Claude, GPT, Gemini o cualquier agente de IA moderno a las APIs Mailpro™ para que entreguen mensajes reales en bandejas de entrada reales y teléfonos reales.

En resumen

• Mailpro™ ofrece tres APIs a las que un agente de IA puede llamar: Email v2, CRM v3, SMS.
• Cada endpoint está documentado en nuestro portal para desarrolladores con ejemplos listos para copiar en más de 20 lenguajes de programación.
• Usa Email v2 para envíos simples y campañas, CRM v3 para el ecosistema completo de contactos e integraciones, SMS para mensajes cortos y OTPs.
• Los agentes de IA se integran vía HTTPS + JSON estándar — sin SDK propietario.

¿Por qué darle a tu agente de IA el poder de enviar emails y SMS?

Del chatbot a la acción: el giro de la IA agéntica

Hasta hace poco, una conversación con un LLM terminaba en el prompt. El modelo te escribía un borrador, un resumen o un fragmento de código — la última milla era tuya. Con tool use (término de Anthropic), function calling (término de OpenAI) o el Model Context Protocol (estándar abierto emergente), el modelo decide llamar a una función externa — y tu código ejecuta esa llamada. De repente el agente puede consultar un registro, calcular algo, y enviar un mensaje.

Esa última parte — el envío — es donde la IA deja de ser un juguete y se vuelve un proceso de negocio. Un agente que responde un ticket de soporte está bien. Un agente que lo responde y envía la solución por email es una hora de personal ahorrada.

Cuatro casos de uso concretos

• Envío transaccional inteligente. El agente redacta una confirmación de pedido personalizada, un seguimiento promocional o un email de restablecimiento de contraseña, y lo despacha vía API Email v2 Mailpro™.
• Campañas orientadas a eventos. Dale al agente un brief de campaña y una lista objetivo: escribe el texto, programa el envío y te devuelve el ID.
• Higiene de CRM a escala. El agente lee datos de leads caóticos, los limpia, los etiqueta, los asigna a un segmento — todo vía API CRM v3 Mailpro™.
• OTP bajo demanda. El agente solicita un código de un solo uso por SMS vía la API SMS para verificar a un usuario en plena conversación.

En cada caso, el agente no te "reemplaza": cierra el ciclo entre decidir y actuar.

Las APIs Mailpro™ en 30 segundos

Mailpro™ expone tres APIs REST, cada una diseñada para un rol preciso. Un agente puede usar una, dos o las tres en el mismo flujo. Todas corren en api.mailpro.com y están documentadas en nuestro portal para desarrolladores, con ejemplos de código listos para copiar en más de 20 lenguajes (cURL, Python, Node.js, PHP, Go, Ruby, C#, Java, Swift, Kotlin y muchos más).

Email API v2 — simple y directa para enviar

¿Necesitas email y SMS desde un solo lugar? Los planes de Mailpro dan a tu agente de IA ambos canales mediante una sola API — una integración, una factura predecible.

La más directa de las tres. Si solo quieres enviar un email — transaccional puntual o campaña a una lista — la API Email v2 es la distancia más corta entre tu agente y la bandeja del destinatario. Gesti, con auth y créditos propios.

Las tres APIs coexisten: un mismo contacto Mailpro™ es visible desde v2 y v3. Nada impide a tu agente usar v3 para crear un contacto bien etiquetado, luego v2 para enviarle un email, luego la API SMS para un recordatorio.

Ejemplo mínimo: Claude envía un email a tu lista VIP

El patrón más limpio es exponer un wrapper fino sobre la API Mailpro™ como herramienta que el agente puede llamar. Versión mínima en Python con el SDK de Anthropic:

import anthropic
import requests

ANTHROPIC_KEY = "sk-ant-..."
MAILPRO_ID = 123456         # YOUR_ID_CLIENT
MAILPRO_KEY = "YOUR_API_KEY"  # nunca enviar esta clave al modelo

client = anthropic.Anthropic(api_key=ANTHROPIC_KEY)

# 1. Declarar la herramienta
tools = [{
    "name": "send_email_campaign",
    "description": "Envía una campaña de email a una lista Mailpro.",
    "input_schema": {
        "type": "object",
        "properties": {
            "list_id":  {"type": "integer", "description": "ID de la lista Mailpro"},
            "subject":  {"type": "string"},
            "html":     {"type": "string", "description": "Cuerpo HTML completo"}
        },
        "required": ["list_id", "subject", "html"]
    }
}]

# 2. Pedir a Claude la campaña
msg = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    tools=tools,
    messages=[{
        "role": "user",
        "content": "Escribe un email de rebajas de primavera para la lista VIP (ID 42) y envíalo."
    }]
)

# 3. Ejecutar la llamada a la herramienta
for block in msg.content:
    if block.type == "tool_use" and block.name == "send_email_campaign":
        args = block.input
        r = requests.post(
            "https://api.mailpro.com/v2/send/campaign.json",
            params={"IdClient": MAILPRO_ID, "ApiKey": MAILPRO_KEY},
            data={
                "AddressBookId": args["list_id"],
                "Subject":       args["subject"],
                "Body":          args["html"]
            }
        )
        print("Respuesta Mailpro:", r.json())

Dos puntos clave: la clave API permanece en tu código (nunca en el prompt), y el agente solo ve la forma de la herramienta — no necesita credenciales para hacer su trabajo. Ese es el fundamento de todo patrón de integración agéntica. Para ver la misma llamada en otro lenguaje, la documentación de la API Email v2 ofrece el snippet equivalente en Node.js, PHP, Go, Ruby, C# y cerca de veinte más.

Seguridad y buenas prácticas para el envío guiado por IA

Los sistemas agénticos son rápidos y se abren en abanico. Un bucle mal configurado puede enviar miles de mensajes no deseados en minutos. Cuatro reglas:

Nunca expongas tu clave API al LLM directamente

El modelo debe recibir el esquema de la herramienta, no las credenciales. Guarda la clave en variables de entorno del servidor e inyéctala solo en el momento de la ejecución de la herramienta.

Respetar los límites de tasa

Mailpro™ aplica por defecto 500 solicitudes por minuto por clave API. Un agente en bucle agresivo alcanza ese tope rápido. Usa backoff exponencial en respuestas 429 y prefiere endpoints en bloque cuando sea posible. Para más, nuestra guía de entregabilidad de email. con agentes de IA?

No — puedes empezar en el plan gratis, probar todo y pasar a pago cuando el volumen lo justifique. Ver precios.

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

Cualquier modelo con function calling o tool use: Anthropic Claude, OpenAI GPT-4/5, Google Gemini, Mistral, y modelos locales vía Ollama o LM Studio. La API es HTTP + JSON; al modelo le basta con emitir una llamada de herramienta JSON válida.

¿Es seguro dejar que un agente de IA envíe emails de forma autónoma?

Sí, con barandas: limita el alcance de la clave API, impón rate limits de tu lado, mantén logs de auditoría, y agrega una confirmación humana para envíos sensibles (campañas masivas, destinatarios en dominios desconocidos).