Domain Kustom

Kirim email dari merek Anda sendiri dan lacak kesiapan masuk secara terpisah. Tambahkan domain untuk membuat kotak masuk di alamat seperti agent@domainanda.com alih-alih default @agentsend.io.

Ikhtisar

Secara default, setiap kotak masuk yang Anda buat mendapat alamat yang dibuat secara acak di domain bersama @agentsend.io. Ini bekerja baik untuk memulai, tetapi jika Anda ingin agen Anda mengirim email dari merek Anda sendiri, Anda dapat menambahkan domain kustom.

Setelah domain diverifikasi, Anda dapat membuat kotak masuk di atasnya dan mengirim email yang tampak berasal dari alamat seperti support@domainanda.com atau assistant@domainanda.com. Penerima melihat domain Anda di header From. Balasan masuk akan mengikuti routing MX apa pun yang digunakan domain Anda, jadi arahkan MX ke AgentSend hanya jika Anda ingin email masuk dikirim ke AgentSend.

ℹ

Domain kustom memerlukan penambahan catatan DNS ke registrar domain Anda (Cloudflare, Route 53, Namecheap, dll.). Proses verifikasi memeriksa bahwa catatan tersebut telah disebarkan sebelum mengizinkan pengiriman.

Menambahkan Domain

Daftarkan domain dengan AgentSend dengan mengirim request POST ke /domains. Respons mencakup catatan DNS yang perlu Anda tambahkan.

javascript

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

Contoh respons

json

{
  "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
    }
  ]
}

Pengaturan DNS

Setelah menambahkan domain, pergi ke penyedia DNS Anda dan tambahkan catatan yang dikembalikan di dnsRecords. Catatan TXT dan CNAME memverifikasi identitas pengirim dan penandatanganan DKIM. Catatan MX hanya diperlukan jika Anda juga ingin AgentSend menerima email masuk untuk domain.

Tipe	Host	Nilai	Tujuan
`MX`	`yourdomain.com`	`mx.agentsend.io` (priority 10)	Mengarahkan email masuk untuk domain Anda ke server email AgentSend, sehingga balasan masuk ke kotak masuk agen Anda.
`TXT` (verification)	`_amazonses.yourdomain.com`	SES verification token	Mengonfirmasi bahwa Anda mengontrol domain pengirim di Amazon SES.
`CNAME` (DKIM)	`<token>._domainkey.yourdomain.com`	`<token>.dkim.amazonses.com`	Secara kriptografis menandatangani pesan keluar sehingga penerima dapat memverifikasi bahwa pesan dikirim oleh AgentSend dengan otorisasi domain Anda.

💡

Perubahan DNS biasanya menyebar dalam beberapa menit, tetapi dapat memakan waktu hingga 48 jam dalam kasus yang jarang. Anda dapat menjalankan dig TXT agentsend._domainkey.domainanda.com dari terminal untuk memeriksa apakah catatan DKIM Anda aktif.

⚠

Jika domain Anda sudah memiliki catatan MX, menambahkan catatan MX AgentSend akan merutekan semua email masuk untuk domain tersebut ke AgentSend. Gunakan subdomain (misalnya mail.domainanda.com) jika Anda perlu mempertahankan routing email yang ada.

Verifikasi

Setelah Anda menambahkan catatan DNS, picu pemeriksaan verifikasi dengan memanggil POST /domains/{id}/verify. AgentSend menyegarkan verifikasi pengirim dan secara terpisah memeriksa apakah MX Anda menunjuk ke AgentSend untuk email masuk.

javascript

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"

Alur status

sendingStatus dan receivingStatus dilacak secara terpisah. verificationStatus tetap sebagai alias kompatibel mundur dari sendingStatus.

Status	Arti
`pending`	Domain telah terdaftar tetapi verifikasi belum dicoba. Tidak ada catatan DNS yang diperiksa.
`pending_dkim`	Kepemilikan domain diverifikasi, tetapi catatan DKIM belum terlihat. Tunggu beberapa menit dan coba lagi.
`verified`	Semua catatan DNS yang diperlukan dikonfirmasi. Domain siap digunakan untuk mengirim email. Penerimaan masih tergantung pada tempat catatan MX domain menunjuk.
`failed`	Verifikasi gagal. Satu atau lebih catatan yang diperlukan tidak dapat ditemukan. Periksa bahwa catatan dimasukkan dengan benar di penyedia DNS Anda dan coba lagi.

ℹ

Anda dapat memanggil /domains/{id}/verify sebanyak yang Anda butuhkan. Aman untuk polling — misalnya, panggil setiap 30 detik hingga status menjadi verified.

Properti Domain

Objek domain memiliki field berikut:

Properti	Tipe	Deskripsi
`id`	string	Pengenal unik untuk domain, diawali dengan `dom_`.
`domain`	string	Nama domain seperti yang disediakan saat domain dibuat, misalnya `domainanda.com`.
`sendingStatus`	string	Status verifikasi pengirim saat ini: `pending`, `pending_dkim`, `verified`, atau `failed`.
`receivingStatus`	string	Status routing masuk saat ini berdasarkan MX: `pending`, `verified`, atau `failed`.
`verificationStatus`	string	Alias kompatibel mundur dari `sendingStatus`.
`dnsRecords`	array	Array objek catatan DNS yang harus ditambahkan ke penyedia DNS Anda. Setiap catatan memiliki `type`, `host`, `value`, dan opsional `priority`.
`createdAt`	string (ISO 8601)	Timestamp saat domain terdaftar di AgentSend.

Membuat Kotak Masuk di Domain Kustom

Setelah domain verified, teruskan id-nya sebagai domainId saat membuat kotak masuk. Alamat kotak masuk akan menggunakan domain Anda alih-alih @agentsend.io.

javascript

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"

💡

Field username menetapkan bagian lokal dari alamat email. Jika Anda menghilangkannya, AgentSend menghasilkan yang acak. Anda dapat membuat sebanyak mungkin kotak masuk yang Anda butuhkan di domain terverifikasi yang sama.

Menghapus Domain

Hapus domain dengan request DELETE ke /domains/{id}.

javascript

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

⚠

Menghapus domain bersifat permanen. Semua kotak masuk yang terkait dengan domain akan kehilangan alamat email mereka dan tidak lagi dapat mengirim atau menerima email. Pesan yang ada di kotak masuk tersebut disimpan, tetapi email baru tidak dapat dikirim. Tindakan ini tidak dapat dibatalkan.

← Sebelumnya Webhooks Selanjutnya → Lampiran