Aller au contenu

Emails

Vos propres boîtes mail, l'hébergement et les limites d'envoi.

Ouvrir Emails
Vérifié par rapport au tableau de bord le 19 novembre 2026

Emails a quatorze méthodes publiques. Elles couvrent le côté lecture de la page : les boîtes mail que vous avez, le courrier qu'elles contiennent, son état lu et archivé, la récupération du nouveau courrier, et les notes de l'IA sur une journée et sur un brouillon. Treize d'entre elles agissent pour le compte dont vous utilisez la clé d'API. La quatorzième, test_email, demande une clé d'administrateur.

Envoyer un e-mail, ajouter une boîte mail, choisir un forfait, les Paramètres Email et les adresses de transfert se font dans le tableau de bord. Ils n'ont aucune méthode publique aujourd'hui.

Envoyez une requête à une méthode avec votre clé :

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

Une bonne réponse a code à 1. data contient docs, les e-mails ; bookmark, à renvoyer pour la page suivante ; et total_emails.

Lire le courrier

  • get_user_mailboxes donne le nombre d'e-mails de chaque boîte mail.
  • get_user_emails liste le courrier. mailbox_name vaut inbox ou sent, ou n'importe quel autre chemin de dossier à faire correspondre exactement. email_account_id limite à une seule boîte mail, search cherche dans l'objet et dans le nom ou l'adresse de l'autre personne, read à false ne donne que le courrier non lu, et filter_type à archived liste le courrier archivé qui est sinon exclu. date_from et date_to (millisecondes epoch) bornent les dates, contact_email donne le courrier échangé avec une adresse, et email_id donne un message. Paginez avec limit, skip et bookmark.
  • get_email_overview compte le courrier reçu par jour, 14 jours par défaut et jusqu'à 31, et le courrier non lu par boîte mail. C'est ce qui dessine les points de la bande.
  • get_email_brief répond avec la phrase que l'IA écrit à partir des résumés du courrier du jour. Elle est conservée pour la journée et réécrite seulement quand le courrier du jour change. Passez locale et tz_offset pour l'avoir dans la langue et le jour du lecteur.

Le ranger

  • read_email et unread_email marquent un e-mail, et l'élément de sa conversation, comme lu ou non lu par email_id. read_email ne touche ni au drapeau « vu » propre à la boîte mail ni à l'heure de l'e-mail.
  • archive_email archive un e-mail. unarchive_email remet un e-mail archivé dans l'état où il était.

Le garder à jour

  • refresh_mailboxes récupère le nouveau courrier maintenant, pour chaque boîte mail, ou pour une seule quand vous passez email_account_id. C'est la même chose que le bouton Actualiser.
  • pause_mailbox_import met en pause l'import d'une boîte mail aussitôt, comme le fait Annuler de l'import. Plus rien n'est lu ni classé pour elle jusqu'à ce que vous repreniez la synchronisation avec refresh_mailboxes.
  • process_pending_email fait relire un e-mail par l'IA. Passez reset_error pour effacer d'abord l'erreur qu'elle a enregistrée, comme le fait Réessayer.

Demander les notes de l'IA sur un brouillon

get_email_read_along lit un brouillon à côté de la personne qui l'écrit et n'écrit rien. Elle indique ce que demande l'e-mail auquel on répond et si le brouillon y répond, un fichier que le brouillon mentionne et qui n'est pas joint, et un horaire qu'il nomme et que l'agenda ne permet pas. Passez le brouillon en texte brut dans draft, l'e-mail auquel on répond dans email_id, les noms des fichiers joints dans attached, et tz_offset, time_zone et locale de la personne qui écrit. C'est ce qu'utilise la Lecture accompagnée.

Déconnecter une boîte mail

delete_email_account déconnecte une boîte mail par email_account_id. C'est la même chose que Déconnecter dans la fenêtre de la boîte mail. La boîte mail est marquée comme supprimée, et le courrier déjà importé reste dans l'espace de travail.

Une boîte mail Xuda est supprimée définitivement

Déconnecter une boîte mail Xuda la supprime avec tout son courrier sur le serveur de messagerie, et cela ne peut pas être annulé. Déconnecter un Gmail ou un Outlook conserve les messages ici et retire l'accès de Xuda. Pour un Outlook, Xuda supprime ses propres jetons ; Xuda reste dans la liste des applications du compte Microsoft jusqu'à ce que la personne l'y retire.

Méthodes

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026