IMAP

objetivo o conector imap (internet message access protocol) tem como objetivo permitir a integração da plataforma com servidores de correio eletrônico para a leitura e gestão de mensagens recebidas principais cenários de uso monitoramento de caixa de entrada verificação constante para processamento automático de e mails recebidos integração com sistemas legados captura de notificações ou alertas enviados por sistemas que se comunicam apenas via e mail extração e automação de dados coleta de informações contidas no corpo das mensagens para alimentar fluxos de trabalho gestão de documentos processamento e armazenamento automático de anexos recebidos configuração da conexão como configurar no painel da fluid acesse conexões > nova conexão > imap preencha os campos de conexão host nome do host ou ip do servidor imap porta porta do servidor imap (padrão 993) nome de usuário usuário da conta imap senha senha da conta imap modo de criptografia ssl/tls ou starttls padrão ssl/tls ignorar erros de ssl ignora erros de certificado ssl padrão false (opcional) configurações avançadas e proxy configure apenas se sua rede exigir clique em salvar conexão e utilize o botão testar para validar o acesso requisitos (criando conexão) a conexão define os parâmetros técnicos para que a fluid estabeleça comunicação com o seu servidor imap campos da conexão campo tipo obrigatório descrição host string sim nome do host ou ip do servidor imap porta string sim porta do servidor imap padrão 993 nome de usuário string sim usuário da conta imap senha string sim senha da conta imap modo de criptografia string sim ssl/tls ou starttls padrão ssl/tls ignorar erros de ssl boolean não ignora erros de certificado ssl padrão false observações de segurança utilize conexões criptografadas (ssl/tls) sempre que possível para proteger os dados em trânsito monitore o acesso ao servidor imap para detectar atividades suspeitas ou não autorizadas mantenha o servidor imap atualizado com os patches de segurança mais recentes implemente políticas de backup regulares para garantir a recuperação dos dados em caso de perda configurando um fluxo recurso e mail operação buscar e mail permite recuperar um e mail específico de uma mailbox a busca utiliza o uid (unique identifier), garantindo precisão absoluta na recuperação da mensagem, sem riscos de capturar o item errado em caso de assuntos duplicados campos da operação campo tipo obrigatório descrição mailbox string sim pasta onde o e mail está localizado (ex inbox ) e mail uid integer sim identificador único do e mail dentro da mailbox alterar status string sim define como o e mail será marcado no servidor ( peek , seen ou unseen ) incluir anexos boolean não indica se os anexos devem ser baixados para o diretório da engine status do e mail (flags) define como o e mail será tratado no servidor após a leitura peek apenas visualiza o conteúdo (não altera o status atual seen marca o e mail como lido unseen mantém ou marca o e mail como não lido nota sobre anexos e latência ao habilitar incluir anexos , os arquivos são salvos no diretório da engine a resposta retornará os metadados e o caminho (path) de referência do arquivo atenção o download de arquivos volumosos pode aumentar significativamente a latência (tempo de resposta) da operação operação buscar e mails permite a recuperação de várias mensagens simultaneamente através de filtros flexíveis campos principais campo tipo obrigatório descrição mailbox string sim pasta de origem (ex inbox ) critérios de busca object sim filtros específicos (remetente, assunto, datas, etc) alterar status string sim define o status do e mail no servidor após a busca limite integer sim máximo de e mails processados (padrão e máximo 100 ) incluir anexos boolean não indica se deve baixar os anexos subcampos dos critérios de busca subcampo tipo obrigatório descrição filtrar por status array não filtra por e mails seen , unseen ou deleted de (from) string não filtra pelo endereço do remetente para (to) string não filtra pelo endereço do destinatário assunto string não busca termos específicos no assunto desde (since) date não e mails recebidos a partir desta data ( yyyy mm dd ) antes de (before) date não e mails recebidos antes desta data ( yyyy mm dd ) ordem string sim ordenação dos resultados asc (antigos) ou desc (novos) status do e mail (flags) define como o e mail será tratado no servidor após a leitura peek apenas visualiza o conteúdo (não altera o status atual seen marca o e mail como lido unseen mantém ou marca o e mail como não lido nota sobre anexos e latência ao habilitar incluir anexos , os arquivos são salvos no diretório da engine a resposta retornará os metadados e o caminho (path) de referência do arquivo atenção o download de arquivos volumosos pode aumentar significativamente a latência (tempo de resposta) da operação operação excluir e mail remove um e mail específico utilizando seu uid campos da operação campo tipo obrigatório descrição mailbox string sim pasta onde o e mail está localizado e mail uid integer sim identificador único da mensagem remover permanentemente boolean não se ativado, apaga definitivamente (expunge) remoção permanente vs exclusão simples ativado (true) o e mail é apagado imediatamente não há possibilidade de recuperação desativado (false) o e mail é marcado para exclusão ele deixará de aparecer na lista principal, mas continuará ocupando espaço até que uma limpeza seja executada pelo servidor recurso mailbox operação listar mailboxes retorna as pastas disponíveis no servidor, incluindo contagem de mensagens totais e não lidas campos da operação campo tipo obrigatório descrição mailbox string não nome da mailbox pai para listar subpastas guia de listagem de pastas nível principal deixe o campo vazio para listar as pastas raiz (inbox, sent, etc) subpastas informe o caminho completo da pasta pai (ex inbox/financeiro ) na pratica listar mailboxes listar mailboxes principais listar subpastas buscar e mail buscar e mail utilizando flag peek (sem alterar status) buscar e mail utilizando flag seen (marcar como lido) \\ buscar e mail utilizando flag unseen (manter ou marcar como não lido) buscar e mail incluindo anexos (atenção à latência) buscar multiplos e mails buscar e mails filtrando por remetente e assunto buscar e mails filtrando por data e status buscar e mails incluindo anexos (atenção à latência) excluir e mail excluir e mail sem remoção permanente excluir e mail com remoção permanente observações finais o conector imap é ideal para leitura e processamento para envio, utilize o conector https //docs fluidapi io/smtp sempre teste as operações em ambientes controlados para evitar a perda acidental de mensagens considere as políticas de retenção do seu servidor de e mail para evitar problemas de armazenamento conclusão o conector imap oferece a flexibilidade necessária para transformar sua caixa de entrada em uma fonte de dados automatizada, permitindo que sua aplicação reaja a novos e mails de forma inteligente e organizada