Saltar para o conteúdo

Emails

As suas próprias caixas de correio, alojamento e limites de envio.

Abrir Emails
Verificado com o painel em 19 de novembro de 2026

Os E-mails têm catorze métodos públicos. Cobrem o lado de leitura da página: que caixas de correio tem, o correio nelas, o seu estado de lido e arquivado, a obtenção de correio novo e as notas da IA sobre um dia e sobre um rascunho. Treze deles atuam em nome da conta cuja chave de API usar. O décimo quarto, test_email, precisa de uma chave de administrador.

Enviar uma mensagem, adicionar uma caixa de correio, escolher um plano, as Configurações do Email e os endereços de reencaminhamento fazem-se no painel. Hoje não têm método público.

Envie um pedido a um método com a sua chave:

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

Uma boa resposta tem code 1. data contém docs, as mensagens; bookmark, para devolver para a página seguinte; e total_emails.

Ler o correio

  • get_user_mailboxes dá as contagens de correio de cada caixa de correio.
  • get_user_emails lista o correio. mailbox_name é inbox ou sent, ou qualquer outro caminho de pasta a corresponder exatamente. email_account_id limita-o a uma caixa de correio, search procura no assunto e no nome ou endereço da outra parte, read definido como false dá apenas correio não lido, e filter_type definido como archived lista o correio arquivado que de outra forma fica de fora. date_from e date_to (milissegundos de época) delimitam as datas, contact_email dá o correio trocado com um endereço e email_id dá uma mensagem. Pagine com limit, skip e bookmark.
  • get_email_overview conta o correio recebido por dia, 14 dias por defeito e até 31, e o correio não lido por caixa de correio. É o que desenha os pontos da faixa.
  • get_email_brief responde com a frase que a IA escreve a partir dos resumos do correio de hoje. É guardada durante o dia e só volta a ser escrita quando o correio de hoje muda. Passe locale e tz_offset para a ter no idioma e no dia do leitor.

Arrumá-lo

  • read_email e unread_email marcam uma mensagem, e o item da sua conversa, como lida ou não lida por email_id. read_email deixa em paz o indicador de visto da própria caixa de correio e a hora da mensagem.
  • archive_email arquiva uma mensagem. unarchive_email repõe uma arquivada no estado que tinha.

Mantê-lo atual

  • refresh_mailboxes obtém correio novo agora, para todas as caixas de correio, ou para uma quando passa email_account_id. É o mesmo que o botão Atualizar.
  • pause_mailbox_import põe em pausa a importação de uma caixa de correio de imediato, como o Cancelar da importação. Nada mais é lido ou arquivado para ela até continuar a sincronização com refresh_mailboxes.
  • process_pending_email faz a IA ler uma mensagem outra vez. Passe reset_error para limpar primeiro o erro que guardou, como Tentar novamente faz.

Pedir as notas da IA sobre um rascunho

get_email_read_along lê um rascunho ao lado de quem o escreve e não escreve nada. Diz o que a mensagem a que se responde pergunta e se o rascunho lhe responde, um ficheiro que o rascunho menciona e que não está anexado, e uma hora que nomeia e que o calendário não pode cumprir. Passe o rascunho como texto simples em draft, a mensagem a que se responde em email_id, os nomes dos ficheiros anexados em attached, e tz_offset, time_zone e locale de quem escreve. É o que o Ler junto usa.

Desligar uma caixa de correio

delete_email_account desliga uma caixa de correio por email_account_id. É o mesmo que Desligar na janela da caixa de correio. A caixa de correio é marcada como eliminada, e o correio já trazido fica na área de trabalho.

Uma caixa de correio Xuda é eliminada definitivamente

Desligar uma caixa de correio Xuda elimina-a com todo o seu correio no servidor de correio, e isto não pode ser desfeito. Desligar um Gmail ou Outlook mantém aqui as mensagens e retira o acesso do Xuda. Para um Outlook, o Xuda elimina os seus próprios tokens; o Xuda fica na lista de apps da conta Microsoft até a pessoa o remover aí.

Métodos

Que tal está este guia?

Última atualização em 16 de novembro de 2026