Προσαρμοσμένοι Τομείς

Στείλτε email από τη δική σας μάρκα και παρακολουθήστε ξεχωριστά την ετοιμότητα εισερχομένων. Προσθέστε έναν τομέα για να δημιουργήσετε εισερχόμενα σε διευθύνσεις όπως agent@yourdomain.com αντί της προεπιλεγμένης @agentsend.io.

Επισκόπηση

Από προεπιλογή, κάθε εισερχόμενο που δημιουργείτε αποκτά μια τυχαία διεύθυνση στον κοινόχρηστο τομέα @agentsend.io. Αυτό λειτουργεί τέλεια για το ξεκίνημα, αλλά αν θέλετε οι πράκτορές σας να στέλνουν email από τη δική σας μάρκα, μπορείτε να προσθέσετε έναν προσαρμοσμένο τομέα.

Μόλις ένας τομέας επαληθευτεί, μπορείτε να δημιουργήσετε εισερχόμενα σε αυτόν και να στείλετε email που φαίνεται να προέρχεται από διευθύνσεις όπως support@yourdomain.com ή assistant@yourdomain.com. Οι παραλήπτες βλέπουν τον τομέα σας στην κεφαλίδα From. Οι εισερχόμενες απαντήσεις θα ακολουθήσουν όποιο MX routing χρησιμοποιεί ο τομέας σας, οπότε δείξτε το MX στο AgentSend μόνο αν θέλετε το εισερχόμενο mail να παραδίδεται στο AgentSend.

Προσθήκη Τομέα

Εγγράψτε έναν τομέα με το AgentSend στέλνοντας ένα request POST στο /domains. Η απάντηση περιλαμβάνει τις εγγραφές DNS που πρέπει να προσθέσετε.

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

Παράδειγμα απάντησης

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

Ρύθμιση DNS

Μετά την προσθήκη του τομέα, πηγαίνετε στον πάροχο DNS σας και προσθέστε τις εγγραφές που επιστράφηκαν στο dnsRecords. Οι εγγραφές TXT και CNAME επαληθεύουν την ταυτότητα αποστολέα και την υπογραφή DKIM. Η εγγραφή MX χρειάζεται μόνο αν θέλετε επίσης το AgentSend να λαμβάνει εισερχόμενο mail για τον τομέα.

Επαλήθευση

Μόλις προσθέσετε τις εγγραφές DNS, ενεργοποιήστε έναν έλεγχο επαλήθευσης καλώντας POST /domains/{id}/verify. Το AgentSend ανανεώνει την επαλήθευση αποστολέα και ελέγχει ξεχωριστά αν το MX σας δείχνει στο AgentSend για εισερχόμενο mail.

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"

Ροή κατάστασης

Τα sendingStatus και receivingStatus παρακολουθούνται ξεχωριστά. Το verificationStatus παραμένει ως backward-compatible alias του sendingStatus.

Ιδιότητες Τομέα

Ένα αντικείμενο τομέα έχει τα εξής πεδία:

Δημιουργία Εισερχομένων σε Προσαρμοσμένους Τομείς

Μόλις ένας τομέας είναι verified, περάστε το id του ως domainId κατά τη δημιουργία εισερχομένων. Η διεύθυνση εισερχομένων θα χρησιμοποιεί τον τομέα σας αντί του @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"

Διαγραφή Τομέα

Αφαιρέστε έναν τομέα με request DELETE στο /domains/{id}.

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