Μηνύματα

Τα μηνύματα αντιπροσωπεύουν μεμονωμένα email που στέλνονται ή λαμβάνονται από ένα εισερχόμενο. Στείλτε εμπλουτισμένα HTML email, παρακολουθήστε την κατάσταση παράδοσης και διαβάστε εισερχόμενες απαντήσεις.

Επισκόπηση

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

Κάθε μήνυμα ανήκει σε ένα νήμα — είτε σε ένα υπάρχον (για απαντήσεις) είτε σε ένα νέο νήμα που δημιουργείται αυτόματα όταν ξεκινά μια νέα συνομιλία.

Αποστολή Email

POST /inboxes/{inboxId}/messages

Στείλτε email από ένα εισερχόμενο κάνοντας POST στο endpoint μηνυμάτων του. Ο πίνακας to και το subject απαιτούνται· όλα τα άλλα είναι προαιρετικά.

Σώμα Request

const res = await fetch(
  `https://api.agentsend.io/inboxes/${inboxId}/messages`,
  {
    method: "POST",
    headers: {
      "x-api-key": process.env.AGENTSEND_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      to: ["customer@example.com"],
      subject: "Following up on your request",
      bodyText: "Hi, just checking in on your request.",
      bodyHtml: "<p>Hi, just checking in on your request.</p>",
    }),
  }
);

const message = await res.json();
console.log(message.id);     // msg_abc123
console.log(message.delivery); // "email" or "dry-run"
console.log(message.status); // "queued"

Ιδιότητες Μηνύματος

Κάθε αντικείμενο μηνύματος που επιστρέφεται από το API έχει τα εξής πεδία.

Κατάσταση Μηνύματος

Τα εξερχόμενα μηνύματα περνούν από έναν κύκλο ζωής παράδοσης. Ελέγξτε πρώτα το delivery για να επιβεβαιώσετε αν το περιβάλλον έστειλε πραγματικό mail ή μόνο το προσομοίωσε, μετά χρησιμοποιήστε το status ή webhooks για να ακολουθήσετε τον κύκλο ζωής από την πλευρά του παρόχου.

Κύκλος ζωής εξερχόμενων

• queued — Το μήνυμα έχει γίνει αποδεκτό και περιμένει να σταλεί.
• sending — Το μήνυμα παραδίδεται ενεργά στον διακομιστή mail του παραλήπτη.
• sent — Το μήνυμα έγινε αποδεκτό από τον διακομιστή mail του παραλήπτη.
• delivered — Η παράδοση επιβεβαιώθηκε (όπου υποστηρίζεται από τον διακομιστή λήψης).

Καταστάσεις αποτυχίας

• failed — Ένα παροδικό ή μόνιμο σφάλμα εμπόδισε την παράδοση. Ελέγξτε το payload του webhook για τον λόγο.
• bounced — Η διεύθυνση παραλήπτη δεν υπάρχει ή ο διακομιστής απέρριψε το μήνυμα μόνιμα.
• complained — Ο παραλήπτης επισήμανε το email ως spam.

Εισερχόμενα μηνύματα

• received — Ένα email έφτασε στα εισερχόμενα από εξωτερικό αποστολέα.

Λίστα Μηνυμάτων

GET /inboxes/{inboxId}/messages

Ανακτήστε μια λίστα με σελιδοποίηση των μηνυμάτων για ένα εισερχόμενο. Φιλτράρετε ανά status για να βρείτε εισερχόμενες απαντήσεις, αποτυχημένες αποστολές ή οποιοδήποτε άλλο υποσύνολο.

// Fetch the 10 most recent inbound messages
const res = await fetch(
  `https://api.agentsend.io/inboxes/${inboxId}/messages?status=received&limit=10`,
  { headers: { "x-api-key": process.env.AGENTSEND_API_KEY } }
);

const { data, total } = await res.json();

for (const msg of data) {
  console.log(msg.fromAddress, msg.subject, msg.bodyText);
}

HTML vs Απλό Κείμενο

Το AgentSend υποστηρίζει email απλού κειμένου, HTML και multipart. Χρησιμοποιήστε το bodyText για απλό κείμενο και το bodyHtml για περιεχόμενο HTML.

• Αν παρέχετε μόνο bodyText, το email αποστέλλεται ως text/plain.
• Αν παρέχετε μόνο bodyHtml, το email αποστέλλεται ως text/html.
• Αν παρέχετε και τα δύο, το email αποστέλλεται ως multipart/alternative. Οι email clients που υποστηρίζουν HTML θα εμφανίσουν την έκδοση HTML· οι άλλοι θα χρησιμοποιήσουν την έκδοση απλού κειμένου.

Διαγραφή Μηνυμάτων

DELETE /messages/{id}

Διαγράψτε ένα μήνυμα με το ID του. Αυτό αφαιρεί την εγγραφή μηνύματος από το AgentSend. Δεν ανακαλεί ένα ήδη παραδοθέν email από το mailbox του παραλήπτη.

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