Domínios Personalizados

Envie emails da sua própria marca e acompanhe a prontidão de recebimento separadamente. Adicione um domínio para criar caixas de entrada em endereços como agent@yourdomain.com em vez do padrão @agentsend.io.

Visão Geral

Por padrão, toda caixa de entrada que você cria recebe um endereço gerado aleatoriamente no domínio compartilhado @agentsend.io . Isso funciona muito bem para começar, mas se você quer que seus agentes enviem email da sua própria marca, você pode adicionar um domínio personalizado.

Uma vez verificado o domínio, você pode criar caixas de entrada nele e enviar emails que parecem vir de endereços como support@yourdomain.com or assistant@yourdomain.com. Os destinatários veem seu domínio no cabeçalho From. As respostas recebidas seguirão qualquer roteamento MX que seu domínio usa, então aponte o MX para o AgentSend apenas se quiser que emails de entrada sejam entregues no AgentSend.

Adicionando um Domínio

Registre um domínio no AgentSend enviando uma requisição POST request to /domains. A resposta inclui os registros DNS que você precisa adicionar.

const res = await fetch("https://api.agentsend.io/domains", {
  method: "POST",
  headers: {
    "x-api-key": process.env.AGENTSEND_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    domain: "yourdomain.com",
  }),
});

const domain = await res.json();
console.log(domain.id);               // "dom_..."
console.log(domain.sendingStatus);   // "pending"
console.log(domain.receivingStatus); // "pending"
console.log(domain.dnsRecords);      // combined DNS records to add

Exemplo de resposta

{
  "id": "dom_01hx4r2kt9fzv8s3n",
  "domain": "yourdomain.com",
  "sendingStatus": "pending",
  "receivingStatus": "pending",
  "verificationStatus": "pending",
  "createdAt": "2025-04-16T10:00:00.000Z",
  "dnsRecords": [
    {
      "type": "TXT",
      "host": "_amazonses.yourdomain.com",
      "value": "verification-token"
    },
    {
      "type": "CNAME",
      "host": "dkim-a._domainkey.yourdomain.com",
      "value": "dkim-a.dkim.amazonses.com"
    },
    {
      "type": "MX",
      "host": "yourdomain.com",
      "value": "mx.agentsend.io",
      "priority": 10
    }
  ]
}

Configuração de DNS

Após adicionar o domínio, vá ao seu provedor de DNS e adicione os registros retornados em dnsRecords. Os registros TXT e CNAME verificam a identidade do remetente e a assinatura DKIM. O registro MX só é necessário se você também quiser que o AgentSend receba emails de entrada para o domínio.

Verificação

Depois de adicionar os registros DNS, acione uma verificação chamando POST /domains/{id}/verify. O AgentSend atualiza a verificação do remetente e verifica separadamente se seu MX aponta para o AgentSend para emails de entrada.

const res = await fetch(
  `https://api.agentsend.io/domains/${domain.id}/verify`,
  {
    method: "POST",
    headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
  }
);

const result = await res.json();
console.log(result.sendingStatus);   // "verified" | "pending_dkim" | "failed"
console.log(result.receivingStatus); // "verified" | "pending" | "failed"

Fluxo de status

sendingStatus and receivingStatus são rastreados separadamente. verificationStatus permanece como um alias compatível com versões anteriores de sendingStatus.

Propriedades do Domínio

Um objeto de domínio possui os seguintes campos:

Criando Caixas de Entrada em Domínios Personalizados

Uma vez que o domínio esteja verified, passe seu id as domainId ao criar uma caixa de entrada. O endereço da caixa de entrada usará seu domínio em vez de @agentsend.io.

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: "Support Agent",
    username: "support",       // becomes support@yourdomain.com
    domainId: "dom_01hx4r2kt9fzv8s3n",
  }),
});

const inbox = await res.json();
console.log(inbox.address); // "support@yourdomain.com"

Excluindo um Domínio

Remova um domínio com uma requisição DELETE request to /domains/{id}.

await fetch(`https://api.agentsend.io/domains/${domain.id}`, {
  method: "DELETE",
  headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
});