Saltar al contenido

Emails

Tus propios buzones, alojamiento y límites de envío.

Abrir Emails
Comprobado con el panel el 19 de noviembre de 2026

Emails tiene catorce métodos públicos. Cubren el lado de lectura de la página: qué buzones tienes, el correo que contienen, su estado de leído y archivado, obtener correo nuevo, y las notas de la IA sobre un día y sobre un borrador. Trece de ellos actúan en nombre de la cuenta cuya clave de API uses. El decimocuarto, test_email, necesita una clave de administrador.

Enviar un correo, añadir un buzón, elegir un plan, los Ajustes de Email y las direcciones de reenvío se hacen en el panel. Hoy no tienen método público.

Envía una petición a un método con tu clave:

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 respuesta correcta tiene code 1. data contiene docs, los correos; bookmark, para devolver y obtener la página siguiente; y total_emails.

Lee el correo

  • get_user_mailboxes da los recuentos de correo de cada buzón.
  • get_user_emails lista el correo. mailbox_name es inbox o sent, o cualquier otra ruta de carpeta que coincida exactamente. email_account_id lo limita a un buzón, search busca en el asunto y en el nombre o la dirección de la otra parte, read en false da solo el correo sin leer, y filter_type en archived lista el correo archivado que de otro modo se deja fuera. date_from y date_to (milisegundos de epoch) acotan las fechas, contact_email da el correo intercambiado con una dirección y email_id da un mensaje. Pagina con limit, skip y bookmark.
  • get_email_overview cuenta el correo recibido por día, 14 días por defecto y hasta 31, y el correo sin leer por buzón. Es lo que dibuja los puntos de la banda.
  • get_email_brief responde la frase que escribe la IA a partir de los resúmenes del correo de hoy. Se conserva durante el día y se vuelve a escribir solo cuando cambia el correo de hoy. Pasa locale y tz_offset para tenerla en el idioma y el día del lector.

Ordénalo

  • read_email y unread_email marcan un correo, y su elemento de conversación, como leído o no leído por email_id. read_email no toca la marca de visto propia del buzón ni la hora del correo.
  • archive_email archiva un correo. unarchive_email devuelve uno archivado al estado que tenía.

Mantenlo al día

  • refresh_mailboxes obtiene correo nuevo ahora, de todos los buzones, o de uno cuando pasas email_account_id. Es lo mismo que el botón Actualizar.
  • pause_mailbox_import pausa de inmediato la importación de un buzón, como hace Cancelar en la importación. No se lee ni se archiva nada más para él hasta que continúes la sincronización con refresh_mailboxes.
  • process_pending_email hace que la IA lea un correo otra vez. Pasa reset_error para borrar antes el error que guardó, como hace Reintentar.

Pide las notas de la IA sobre un borrador

get_email_read_along lee un borrador junto a la persona que lo escribe y no escribe nada. Dice qué pide el correo al que se responde y si el borrador lo responde, un archivo que el borrador menciona y que no está adjunto, y una hora que nombra y que el calendario no puede cumplir. Pasa el borrador como texto sin formato en draft, el correo al que se responde en email_id, los nombres de los archivos adjuntos en attached, y tz_offset, time_zone y locale de quien escribe. Es lo que usa Leer juntos.

Desconecta un buzón

delete_email_account desconecta un buzón por email_account_id. Es lo mismo que Desconectar en la ventana del buzón. El buzón se marca como eliminado, y el correo ya traído se queda en el espacio de trabajo.

Un buzón de Xuda se elimina definitivamente

Desconectar un buzón de Xuda lo elimina con todo su correo en el servidor de correo, y no se puede deshacer. Desconectar un Gmail o un Outlook conserva aquí los mensajes y retira el acceso de Xuda. En el caso de un Outlook, Xuda elimina sus propios tokens; Xuda permanece en la lista de apps de la cuenta de Microsoft hasta que la persona la quite allí.

Métodos

¿Qué te parece esta guía?

Última actualización: 16 de noviembre de 2026