Primeiros Passos

Crie uma caixa de entrada e envie seu primeiro email a partir de um agente de IA em menos de um minuto.

Visão Geral

AgentSend é uma infraestrutura de email construída para agentes de IA. Ela fornece a cada agente sua própria caixa de entrada com um endereço de email real, para que seus agentes possam enviar, receber e gerenciar conversas por email de forma programática.

Use o AgentSend para construir agentes que lidam com suporte ao cliente, prospecção de vendas, agendamento, pesquisa e qualquer fluxo de trabalho que precise de email.

Instalação

Instale o SDK do AgentSend para sua linguagem, ou chame a API REST diretamente.

npm install agentsend

Início Rápido

Este exemplo cria uma caixa de entrada, envia um email e lista mensagens recebidas — tudo em poucas linhas.

1. Obtenha sua chave de API

Cadastre-se em agentsend.io e crie uma chave de API no painel. Defina-a como variável de ambiente:

export AGENTSEND_API_KEY="your-api-key"

2. Crie uma caixa de entrada

Cada agente recebe sua própria caixa de entrada com um endereço de email único.

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. Envie um 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. Receba emails

Quando alguém responde, a mensagem chega na caixa de entrada do seu agente. Consulte novas mensagens ou configure um webhook para entrega em tempo 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);
}

O Que Aconteceu

1. Caixa de entrada criada — O AgentSend provisionou um endereço de email único para seu agente.
2. Email enviado — A mensagem foi enfileirada, enviada pela infraestrutura do AgentSend e entregue ao destinatário.
3. Resposta recebida — Qualquer resposta para esse endereço chega na caixa de entrada, pronta para seu agente ler.

Conceitos Fundamentais

• Caixas de Entrada — Cada agente recebe um endereço de email dedicado. Crie quantos precisar.
• Mensagens — Envie e receba emails com texto simples, HTML e anexos.
• Conversas — As mensagens são automaticamente agrupadas em conversas.
• Webhooks — Receba notificações em tempo real quando emails chegam, voltam ou são entregues.
• Domínios — Use seu próprio domínio em vez de @agentsend.io.
• Anexos — Faça upload e anexe arquivos às mensagens enviadas.

Próximos Passos