Vai al contenuto

Emails

Le tue caselle di posta, l'hosting e i limiti di invio.

Apri Emails
Verificato rispetto alla dashboard il 19 novembre 2026

Emails ha quattordici metodi pubblici. Coprono il lato lettura della pagina: quali caselle hai, la posta al loro interno, il suo stato di letta e archiviata, il recupero di nuova posta e le note dell'IA su un giorno e su una bozza. Tredici di essi agiscono per l'account di cui usi la chiave API. Il quattordicesimo, test_email, richiede una chiave amministratore.

Inviare un'email, aggiungere una casella, scegliere un piano, le Impostazioni Email e gli indirizzi di inoltro si fanno nella dashboard. Oggi non hanno alcun metodo pubblico.

Invia una richiesta a un metodo con la tua chiave:

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,
    },
)

Una risposta corretta ha code 1. data contiene docs, le email; bookmark, da restituire per la pagina successiva; e total_emails.

Leggere la posta

  • get_user_mailboxes fornisce i conteggi della posta di ogni casella.
  • get_user_emails elenca la posta. mailbox_name è inbox o sent, oppure qualsiasi altro percorso di cartella da far corrispondere esattamente. email_account_id la limita a una casella, search cerca nell'oggetto e nel nome o indirizzo dell'altra parte, read impostato su false dà solo la posta non letta e filter_type impostato su archived elenca la posta archiviata che altrimenti viene esclusa. date_from e date_to (millisecondi epoch) delimitano le date, contact_email dà la posta scambiata con un solo indirizzo e email_id dà un solo messaggio. Scorri con limit, skip e bookmark.
  • get_email_overview conta la posta ricevuta per giorno, 14 giorni per impostazione predefinita e fino a 31, e la posta non letta per casella. È ciò che disegna i punti della fascia.
  • get_email_brief risponde con l'unica frase che l'IA scrive a partire dai riepiloghi della posta di oggi. Viene conservata per il giorno e riscritta solo quando la posta di oggi cambia. Passa locale e tz_offset per averla nella lingua e nel giorno del lettore.

Riordinarla

  • read_email e unread_email segnano un'email, e il suo elemento di conversazione, come letta o non letta tramite email_id. read_email lascia intatti il flag di visualizzazione della casella e l'ora dell'email.
  • archive_email archivia un'email. unarchive_email ne rimette una archiviata allo stato che aveva.

Tenerla aggiornata

  • refresh_mailboxes recupera subito la nuova posta, per ogni casella, oppure per una sola quando passi email_account_id. È come il pulsante Aggiorna.
  • pause_mailbox_import mette subito in pausa l'importazione di una casella, come fa Annulla dell'importazione. Per essa non viene più letto né archiviato nulla finché non riprendi la sincronizzazione con refresh_mailboxes.
  • process_pending_email fa rileggere un'email all'IA. Passa reset_error per cancellare prima l'errore che ha memorizzato, come fa Riprova.

Chiedere le note dell'IA su una bozza

get_email_read_along legge una bozza accanto a chi la scrive e non scrive nulla. Dice cosa chiede l'email a cui si risponde e se la bozza risponde, un file che la bozza cita e che non è allegato e un orario che nomina e che il calendario non può rispettare. Passa la bozza come testo semplice in draft, l'email a cui si risponde in email_id, i nomi dei file allegati in attached e tz_offset, time_zone e locale di chi scrive. È ciò che usa Leggi insieme.

Scollegare una casella

delete_email_account scollega una casella tramite email_account_id. È come Scollega nella finestra della casella. La casella viene contrassegnata come eliminata, e la posta già importata resta nel workspace.

Una casella Xuda viene eliminata per sempre

Scollegare una casella Xuda la elimina con tutta la sua posta sul server di posta, e non si può annullare. Scollegare un Gmail o un Outlook conserva qui i messaggi e ritira l'accesso di Xuda. Per un Outlook, Xuda elimina i propri token; Xuda resta nell'elenco delle app dell'account Microsoft finché la persona non lo rimuove lì.

Metodi

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026