Εισερχόμενα

Κάθε πράκτορας αποκτά τα δικά του εισερχόμενα με μια μοναδική διεύθυνση email. Τα εισερχόμενα είναι η θεμελιώδης μονάδα στο AgentSend.

Επισκόπηση

Ένα εισερχόμενο είναι μια αποκλειστική διεύθυνση email για έναν μόνο πράκτορα. Κάθε email που ο πράκτοράς σας στέλνει ή λαμβάνει διέρχεται από ένα εισερχόμενο. Μπορείτε να δημιουργήσετε όσα εισερχόμενα χρειάζεστε — ένα ανά πράκτορα, ένα ανά πελάτη, ένα ανά ροή εργασίας — δεν υπάρχουν όρια.

Από προεπιλογή, τα εισερχόμενα δημιουργούνται στον τομέα @agentsend.io. Αν θέλετε οι πράκτορές σας να στέλνουν από τον δικό σας τομέα (π.χ. agent@yourcompany.com), δείτε Προσαρμοσμένοι Τομείς.

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

POST /inboxes

Δημιουργήστε νέα εισερχόμενα στέλνοντας ένα POST request. Και τα δύο πεδία του body είναι προαιρετικά — αν παραλείψετε το displayName, τα εισερχόμενα δημιουργούνται χωρίς αυτό. Αν παραλείψετε το 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",   // optional
    domainId: "dom_abc123",         // optional — omit for @agentsend.io
  }),
});

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

Η απάντηση περιλαμβάνει το πλήρες αντικείμενο inbox, συμπεριλαμβανομένης της αυτόματα παραγόμενης address που μπορείτε να χρησιμοποιήσετε αμέσως.

Ιδιότητες Εισερχομένων

Κάθε αντικείμενο inbox έχει τα εξής πεδία:

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

Από προεπιλογή, κάθε εισερχόμενο αποκτά διεύθυνση στο @agentsend.io. Αν θέλετε οι πράκτορές σας να στέλνουν από τον δικό σας τομέα — για παράδειγμα agent@support.yourcompany.com — μπορείτε να συνδέσετε έναν προσαρμοσμένο τομέα και να περάσετε το domainId κατά τη δημιουργία των εισερχομένων.

Λίστα Εισερχομένων

GET /inboxes

Ανακτήστε μια λίστα με σελιδοποίηση όλων των εισερχομένων στον λογαριασμό σας. Χρησιμοποιήστε τα limit και offset για σελιδοποίηση αποτελεσμάτων.

const res = await fetch(
  "https://api.agentsend.io/inboxes?limit=20&offset=0",
  {
    headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
  }
);

const { data, total } = await res.json();
// data  — array of inbox objects
// total — total count across all pages

for (const inbox of data) {
  console.log(inbox.address, inbox.status, inbox.sendsToday);
}

Διαγραφή Εισερχομένων

DELETE /inboxes/{id}

Διαγράφει οριστικά τα εισερχόμενα και όλα τα σχετικά μηνύματα, νήματα και webhooks.

await fetch(`https://api.agentsend.io/inboxes/${inboxId}`, {
  method: "DELETE",
  headers: { "x-api-key": process.env.AGENTSEND_API_KEY },
});
// Returns 204 No Content on success

Όρια Αποστολής

Κάθε εισερχόμενο έχει ένα dailySendLimit που περιορίζει πόσα email μπορεί να στείλει σε ένα κυλιόμενο παράθυρο 24 ωρών. Το πεδίο sendsToday σας λέει πόσες αποστολές έχουν χρησιμοποιηθεί στο τρέχον παράθυρο.

Αν ένα εισερχόμενο φτάσει το όριό του, τα επόμενα αιτήματα αποστολής επιστρέφουν ένα σφάλμα 429 Too Many Requests. Το παράθυρο μηδενίζει τα μεσάνυχτα UTC.

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

const remaining = inbox.dailySendLimit - inbox.sendsToday;
if (remaining <= 0) {
  console.log("Daily send limit reached. Try again after midnight UTC.");
} else {
  console.log(`${remaining} sends remaining today`);
}