Sallyport
MenuFechar
Pular para a documentação
DocumentaçãoE-mail

E-mail

Deixe um agente enviar da sua caixa de correio, pesquisar e ler e organizar o correio, enquanto o Sallyport guarda a senha.

Nesta página

Seu agente escreve a mensagem e o Sallyport a envia da sua própria caixa de correio. Ele pesquisa a caixa de entrada, lê mensagens e anexos, move e marca o correio. A senha fica no Sallyport, e o agente nunca a vê.

Conecte uma caixa de correio

  • Abra Conectar uma caixa de correio. Em Chaves, é «Adicionar chave» e depois «E-mail» em «Origem da chave».
  • Escolha o «Provedor de e-mail»: Gmail / Google Workspace, Outlook / Microsoft 365, Yahoo Mail, iCloud Mail, Fastmail, Zoho Mail ou «Seu próprio servidor de e-mail». Os servidores, as portas e a criptografia se preenchem e continuam editáveis.
  • Informe o «Endereço de e-mail» e a «Senha da caixa de correio». A maioria dos provedores pede aqui uma senha de app, e o formulário leva à página que a emite.
  • Clique em «Testar conexão». O Sallyport faz login em cada servidor e diz qual recusou.
  • Clique em «Salvar caixa de correio». A senha fica selada e não pode ser lida de volta. Todos os agentes do espaço de trabalho recebem a caixa.
ProvedorSenha a usar
Gmail / Google WorkspaceUma senha de app. O Google a emite quando a verificação em duas etapas está ativada.
Outlook / Microsoft 365A senha da caixa. O administrador do Microsoft 365 ativa SMTP AUTH e o login IMAP com senha para a caixa.
Yahoo MailUma senha de app de Segurança da conta.
iCloud MailUma senha específica de app da sua Conta Apple.
FastmailUma senha de app com acesso IMAP e SMTP.
Zoho MailUma senha específica de app. Caixas de organização usam smtppro.zoho.com e imappro.zoho.com.

Uma caixa envia pelo seu servidor SMTP e é lida pelo seu servidor IMAP. Desligue um em «Envio (SMTP)» ou «Leitura (IMAP)», e as ferramentas dele vão junto.

Entrar com Google ou Microsoft

Caixas do Gmail e do Microsoft 365 entram com o provedor em vez de uma senha. Em «Como o Sallyport entra», escolha «Entrar com Google» ou «Entrar com Microsoft» e pressione «Salvar e entrar com Google» ou «Salvar e entrar com Microsoft». O provedor pede que você permita o acesso e traz você de volta à página da chave.

  • O Sallyport guarda o token no cofre e o renova sozinho, como toda chave com login. Nenhuma senha é guardada.
  • O Google entra pelo app próprio do Sallyport. Na Microsoft você registra um app seu: o formulário dá a «URI de redirecionamento» a adicionar e recebe o «Client ID» e o «Client secret». O app precisa de IMAP.AccessAsUser.All, SMTP.Send e offline_access.
  • O token vai só para os servidores de e-mail do próprio provedor: smtp.gmail.com e imap.gmail.com, ou smtp.office365.com, outlook.office365.com e smtp-mail.outlook.com.

O que o agente pode fazer

O agente mantém sua conexão MCP com o Sallyport. Uma caixa lhe dá três ferramentas, com o nome da conexão:

FerramentaO que fazClasse
_readlist_folders; search numa pasta; fetch de uma mensagem pelo uid; um attachment pelo part. Ler não marca nada como visto.Leitura
_sendEnvia uma mensagem da caixa: to, cc, bcc, subject, text, html, reply_to, in_reply_to, references e attachments.Escrita
_changemove e copy para to_folder; flag e unflag com flags; delete; create_folder.Escrita. delete e marcar deleted são destrutivos.
Argumentos de _read · o correio não lido do financeiro
{
  "operation": "search",
  "from": "[email protected]",
  "unseen": true
}
Argumentos de _send · uma resposta com um arquivo
{
  "to": "Ana Lima <[email protected]>",
  "bcc": "[email protected]",
  "subject": "Re: Invoice 42",
  "text": "Paid today. The receipt is attached.",
  "in_reply_to": "<[email protected]>",
  "attachments": [{ "filename": "receipt.csv", "content_type": "text/csv", "content_base64": "YW1vdW50LGR1ZQo0MjAwLEZyaWRheQo=" }],
  "intent": "Confirm the payment of invoice 42"
}
Argumentos de _change · arquivar a fatura paga
{
  "operation": "move",
  "uids": [4102],
  "to_folder": "Archive",
  "intent": "File the paid invoice"
}
  • search devolve o total e as mensagens mais novas, 20 por padrão e 100 no máximo, cada uma com uid, remetente, assunto, data e marcas.
  • fetch devolve os cabeçalhos, o texto, o HTML e a lista de anexos com seu part.
  • Uma mensagem sai sempre da própria caixa. A cópia oculta chega aos seus destinatários e nunca entra na mensagem.
  • Uma alteração só toca as mensagens que nomeia. Um uid que a pasta não tem volta como missing.

Escolha o que espera por você

O correio funciona sem perguntar por padrão. Para ver cada mensagem antes de sair, abra o agente em Agentes, encontre a caixa na lista «Acesso» e ponha a coluna de escrita em «Exige aprovação», ou ative «Perguntar sempre».

O cartão de aprovação mostra cada destinatário, cópia oculta incluída, o assunto, o texto e cada arquivo por nome e tamanho. Sai exatamente a mensagem do cartão.

Limites e segurança

  • Uma mensagem leva até 100 destinatários, 20 anexos e 10 MiB no total.
  • Uma mensagem é lida até 80 MiB, o texto e o HTML até 2 MiB cada. Uma resposta maior é guardada, e o fetch_body a lê.
  • Uma operação dura até 120 segundos.
  • Sempre TLS com certificado verificado: SMTP em 465 ou 587, IMAP em 993 ou 143. A porta 25 é recusada.
  • O registro guarda os destinatários, o assunto e os nomes dos arquivos de cada mensagem. O texto fica de fora.