Primeros Pasos

Crea una bandeja de entrada y envía tu primer email desde un agente IA en menos de un minuto.

Descripción General

AgentSend es infraestructura de email construida para agentes IA. Le da a cada agente su propia bandeja de entrada con una dirección de email real, para que tus agentes puedan enviar, recibir y gestionar conversaciones de email de forma programática.

Usa AgentSend para construir agentes que manejen soporte al cliente, alcance de ventas, programación, investigación y cualquier flujo de trabajo que necesite email.

Instalar

Instala el SDK de AgentSend para tu lenguaje, o llama a la API REST directamente.

npm install agentsend

Inicio Rápido

Este ejemplo crea una bandeja de entrada, envía un email y lista los mensajes recibidos — todo en pocas líneas.

1. Obtiene tu clave API

Regístrate en agentsend.io y crea una clave API desde el panel de control. Configúrala como variable de entorno:

export AGENTSEND_API_KEY="your-api-key"

2. Crea una bandeja de entrada

Cada agente obtiene su propia bandeja de entrada con una dirección de email única.

const res = await fetch("https://api.agentsend.io/inboxes", {
  method: "POST",
  headers: {
    "x-api-key": process.env.AGENTSEND_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    displayName: "My Support Agent",
  }),
});

const inbox = await res.json();
console.log(inbox.address); // e.g. a1b2c3@agentsend.io

3. Envía un email

await fetch(`https://api.agentsend.io/inboxes/${inbox.id}/messages`, {
  method: "POST",
  headers: {
    "x-api-key": process.env.AGENTSEND_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: ["customer@example.com"],
    subject: "Hello from AgentSend",
    bodyText: "This email was sent by an AI agent.",
  }),
});

4. Recibe emails

Cuando alguien responde, el mensaje llega a la bandeja de entrada de tu agente. Consulta nuevos mensajes o configura un webhook para entrega en tiempo real.

const msgs = await fetch(
  `https://api.agentsend.io/inboxes/${inbox.id}/messages?status=received`,
  { headers: { "x-api-key": process.env.AGENTSEND_API_KEY } }
).then(r => r.json());

for (const msg of msgs.data) {
  console.log(msg.fromAddress, msg.subject);
}

Qué Acaba de Pasar

1. Bandeja de entrada creada — AgentSend aprovisionó una dirección de email única para tu agente.
2. Email enviado — El mensaje fue encolado, enviado a través de la infraestructura de AgentSend, y entregado al destinatario.
3. Respuesta recibida — Cualquier respuesta a esa dirección llega a la bandeja de entrada, lista para que tu agente la lea.

Conceptos Clave

• Bandejas de Entrada — Cada agente obtiene una dirección de email dedicada. Crea tantas como necesites.
• Mensajes — Envía y recibe emails con texto plano, HTML y archivos adjuntos.
• Hilos — Los mensajes se agrupan automáticamente en hilos de conversación.
• Webhooks — Recibe notificaciones en tiempo real cuando los emails llegan, rebotan o se entregan.
• Dominios — Usa tu propio dominio en lugar de @agentsend.io.
• Archivos Adjuntos — Sube y adjunta archivos a los mensajes salientes.

Próximos Pasos