Ugrás a tartalomhoz

E-mailek

Saját postafiókok, tárhely és küldési korlátok.

E-mailek megnyitása
Az irányítópulttal összevetve ekkor: 2026. november 19.

Az E-maileknek tizennégy nyilvános metódusa van. Az oldal olvasási oldalát fedik le: milyen postafiókjai vannak, a bennük lévő levelek, azok olvasott és archivált állapota, az új levelek lekérése, és az AI jegyzetei egy napról és egy piszkozatról. Tizenhárom közülük azon fiók nevében működik, amelynek API-kulcsát használja. A tizennegyedik, a test_email, rendszergazdai kulcsot igényel.

A levélküldés, a postafiók hozzáadása, a csomagválasztás, az E-mail beállítások és a továbbítási címek a dashboardon történnek. Ma nincs hozzájuk nyilvános metódus.

Küldjön kérést egy metódusnak a kulcsával:

curl -s https://xuda.ai/cpi/get_user_emails \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","uid":"YOUR_ACCOUNT_UID","mailbox_name":"inbox","read":false,"limit":25}'
const res = await fetch('https://xuda.ai/cpi/get_user_emails', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    uid: 'YOUR_ACCOUNT_UID',
    mailbox_name: 'inbox',
    read: false,
    limit: 25,
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/get_user_emails',
    json={
        'api_key': 'YOUR_API_KEY',
        'uid': 'YOUR_ACCOUNT_UID',
        'mailbox_name': 'inbox',
        'read': False,
        'limit': 25,
    },
)

A jó válasz code értéke 1. A data tartalmazza a docs mezőt, a leveleket; a bookmark mezőt, amelyet a következő oldalhoz kell visszaadni; és a total_emails mezőt.

A levelek olvasása

  • A get_user_mailboxes megadja az egyes postafiókok levélszámait.
  • A get_user_emails listázza a leveleket. A mailbox_name értéke inbox vagy sent, vagy bármely más mappaútvonal, pontos egyezéssel. Az email_account_id egy postafiókra korlátoz, a search a tárgyban és a másik fél nevében vagy címében keres, a false értékű read csak az olvasatlan leveleket adja, az archived értékű filter_type pedig az egyébként kihagyott archivált leveleket listázza. A date_from és date_to (epoch ezredmásodperc) határolja a dátumokat, a contact_email az egy címmel váltott leveleket adja, az email_id pedig egy üzenetet. Lapozzon a limit, skip és bookmark mezőkkel.
  • A get_email_overview naponként számolja a kapott leveleket, alapértelmezés szerint 14 napra, legfeljebb 31-re, és postafiókonként az olvasatlanokat. Ez rajzolja a sáv pontjait.
  • A get_email_brief azt az egy mondatot adja, amelyet az AI a mai levelek összefoglalóiból ír. Napra megőrzi, és csak akkor írja újra, ha a mai levelek változnak. Adja meg a locale és tz_offset mezőt, hogy az olvasó nyelvén és napjára készüljön.

Rendezés

  • A read_email és az unread_email az email_id alapján olvasottnak vagy olvasatlannak jelöl egy levelet és a beszélgetéselemét. A read_email békén hagyja a postafiók saját látott jelzőjét és a levél idejét.
  • Az archive_email archivál egy levelet. Az unarchive_email egy archiváltat visszarak abba az állapotba, amelyben volt.

Naprakészen tartás

  • A refresh_mailboxes most lekéri az új leveleket, minden postafiókra, vagy egyre, ha megadja az email_account_id mezőt. Ugyanaz, mint a Frissítés gomb.
  • A pause_mailbox_import azonnal szünetelteti egy postafiók importját, ahogy az import Mégse gombja. Semmi több nem lesz elolvasva vagy elrakva hozzá, amíg a refresh_mailboxes hívással nem folytatja a szinkronizálást.
  • A process_pending_email újra elolvastat egy levelet az AI-jal. Adja meg a reset_error mezőt, hogy előbb törölje a tárolt hibát, ahogy az Újra gomb teszi.

Az AI jegyzeteinek kérése egy piszkozatról

A get_email_read_along az író mellett olvas egy piszkozatot, és semmit sem ír. Megmondja, mit kér a levél, amelyre válaszol, és hogy a piszkozat megválaszolja-e, egy említett, de nem csatolt fájlt, és egy olyan időpontot, amelyet a naptár nem tud vállalni. A piszkozatot sima szövegként a draft mezőben adja meg, a megválaszolt levelet az email_id mezőben, a csatolt fájlok neveit az attached mezőben, valamint az író tz_offset, time_zone és locale értékét. Ezt használja az Együtt olvasás.

Postafiók leválasztása

A delete_email_account az email_account_id alapján leválaszt egy postafiókot. Ugyanaz, mint a Leválasztás a postafiók ablakában. A postafiók törölt jelölést kap, és a már behozott levelek a munkaterületen maradnak.

A Xuda postafiók véglegesen törlődik

A Xuda postafiók leválasztása törli azt az összes levelével együtt a levelező szerveren, és ez nem vonható vissza. A Gmail vagy Outlook leválasztása itt tartja az üzeneteket, és visszaveszi a Xuda hozzáférését. Outlook esetén a Xuda törli a saját tokenjeit; a Xuda a Microsoft-fiók alkalmazáslistáján marad, amíg az illető el nem távolítja onnan.

Metódusok

Milyen ez az útmutató?

Utoljára frissítve: 2026. november 20.