Métodos de conector de e-mail

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura

    • Os métodos no Conector de e-mail recuperam, enviam e respondem a mensagens de e-mail e podem baixar anexos. Primeiro, use o método SetConfig para configurar a conexão com o servidor de e-mail.

    Use o método SetConfig para configurar as propriedades do servidor de e-mail e as credenciais de acesso. Este método deve preceder todos os outros métodos do Conector de e-mail na automação.

    O método GetMails recupera mensagens do servidor de e-mail e as passa para outros métodos como um objeto que contém uma ou mais mensagens. Os métodos ReadMail, ReplyMail e SaveAllAttachments operam em uma única mensagem de cada vez. Quando esses métodos recebem um objeto que contém mais de uma mensagem, a automação deve usar um método de loop Para cada ou Para para iterar cada mensagem na coleção.

    Config

    Configura a conexão com o servidor de e-mail para que a automação possa funcionar com mensagens.
    Nota:
    Você deve executar este método antes de executar qualquer outro método no Conector de e-mail.

    Para obter informações sobre como definir os parâmetros, consulte Configure as propriedades da porta.

    Tabela 1. Parâmetros do método SetConfig
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Necessário? Anotações
    Nome do usuário Nome de usuário para fazer login no servidor de e-mail Dados em Cadeia de caracteres (nenhum) Sim
    Senha Senha para fazer login no servidor de e-mail Dados em Cadeia de caracteres (nenhum) Sim
    Credenciais padrão de uso Envia as credenciais padrão do usuário conectado no momento para o servidor SMTP. Dados em Booliano Falso(a) Não
    SmtpMailServer Nome do servidor SMTP Dados em Cadeia de caracteres smtp.gmail.com Não O acesso ao Gmail usando o Conector de e-mail não é compatível no momento. Certifique-se de mudar o valor padrão.
    ImapMailServer Nome do servidor IMAP Dados em Cadeia de caracteres imap.gmail.com Não O acesso ao Gmail usando o Conector de e-mail não é compatível no momento. Certifique-se de mudar o valor padrão.
    SSL Use o protocolo Secure Socket Layer Dados em Booliano Verdadeiro(a) Não
    SmtpPort Número da porta SMTP Dados em Inteiro 587 Não
    ImapPort Número da porta do IMAP Dados em Inteiro 993 Não

    GetMails

    Retorna mensagens do servidor de e-mail para uso por outros métodos. Você pode definir o método para recuperar mensagens lidas (vistas) ou não lidas (não vistas) e especificar a pasta em que elas serão coletadas.

    Para obter informações sobre como definir os parâmetros, consulte Configure as propriedades da porta.

    Tabela 2. Parâmetros do método GetMails
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Necessário? Anotações
    FolderName Nome da pasta do imap em que o método busca a coleção (por exemplo, Caixa de entrada ) Dados em Cadeia de caracteres Caixa de Entrada Sim Para especificar uma pasta do imap aninhada, insira a hierarquia de pastas usando barras invertidas (por exemplo, Projeto/Reuniões)
    Filtrar Definido para obter somente não lidos ( Não visível ou ler ( Visto ) mensagens Dados em FilterMode Não visível Sim
    Retornar Retorna a coleção de e-mails como um objeto Saída de dados Objeto Objeto Sim

    MarkAsRead

    Marca as mensagens de uma pasta especificada como lidas.

    Para obter informações sobre como definir os parâmetros, consulte Configure as propriedades da porta.

    Tabela 3. Parâmetros do método MarkAsRead
    Parâmetro Descrição Tipo da porta Tipo de dados Valor padrão Necessário? Anotações
    MailObject O objeto de e-mail com base no qual a mensagem correspondente é marcada como lida Dados em Objeto Objeto Sim
    FolderName Nome da pasta IMAP para a qual o objeto de e-mail é obtido Dados em Cadeia de caracteres Caixa de Entrada Sim Para especificar uma pasta do imap aninhada, insira a hierarquia de pastas usando barras invertidas (por exemplo, Projeto/Reuniões)

    Marcar como não lido

    Marca as mensagens de uma pasta especificada como não lidas.

    Para obter informações sobre como definir os parâmetros, consulte Configure as propriedades da porta.

    Tabela 4. Parâmetros do método MarkAsRead
    Parâmetro Descrição Tipo da porta Tipo de dados Valor padrão Necessário? Anotações
    MailObject O objeto de e-mail com base no e-mail correspondente que está marcado como não lido. Dados em Objeto Objeto Sim
    FolderName Nome da pasta IMAP para a qual o objeto de e-mail é obtido. Dados em Cadeia de caracteres Caixa de Entrada Sim Para especificar uma pasta do imap aninhada, insira a hierarquia de pastas usando barras invertidas (por exemplo, Projeto/Reuniões)

    ReadMail

    Lê uma mensagem e retorna seus detalhes, incluindo assunto, corpo, remetente (de), destinatários no campo Cc, destinatários no campo Cco e o número de anexos.

    Para obter informações sobre como definir os parâmetros, consulte Configure as propriedades da porta.

    Tabela 5. Parâmetros do método ReadMail
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Necessário?
    MailObject MailObject que fornece os detalhes da última mensagem recebida Dados em Objeto Objeto Sim
    Assunto Assunto da mensagem Saída de dados Cadeia de caracteres Nenhum(a) Não
    Corpo da mensagem Corpo da mensagem Saída de dados Cadeia de caracteres Nenhum(a) Não
    Remetente Remetente da mensagem Saída de dados Cadeia de caracteres Nenhum(a) Não
    Cc Destinatários marcados em CC Saída de dados Cadeia de caracteres Nenhum(a) Não
    Cco Destinatários marcados em Cco Saída de dados Cadeia de caracteres Nenhum(a) Não
    AttachmentsCount Número de anexos na mensagem Saída de dados Inteiro Nenhum(a) Não

    ReplyMail

    Responde automaticamente a uma mensagem. Use os parâmetros para definir o corpo da mensagem e outros detalhes. Você pode incluir anexos.

    Para obter informações sobre como definir os parâmetros, consulte Configure as propriedades da porta.

    Tabela 6. Parâmetros do método ReplyMail
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Necessário? Anotações
    MailObject Objeto de mensagem que contém os detalhes da mensagem Dados em Objeto Objeto Sim
    ReplyToAll Respostas a todos os destinatários nos campos Para e Cc da mensagem Dados em Booliano Falso(a) Não
    Cco Respostas a todos os destinatários no campo Cco da mensagem Dados em Cadeia de caracteres Nenhum(a) Não
    Corpo da mensagem Corpo da mensagem de resposta Dados em Cadeia de caracteres Nenhum(a) Não
    IsHtmlBody Opção para indicar se o corpo da resposta está no formato HTML Dados em Booliano Falso(a) Não
    Anexos Anexos à mensagem de resposta Dados em Cadeia de caracteres Nenhum(a) Não Para anexar um arquivo:
    1. Cole o caminho para o arquivo no campo.
    2. Remova as aspas que envolvem o caminho.

    Para incluir vários anexos, separe os caminhos por vírgulas.

    Salvar Todos os Anexos

    Salva todos os anexos de uma mensagem na unidade local.

    Para obter informações sobre como definir os parâmetros, consulte Configure as propriedades da porta.

    Tabela 7. Parâmetros do método SaveAllAttachments
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Necessário?
    MailObject Mensagem da qual o método baixa os anexos Dados em Objeto Objeto Sim
    FolderPath Caminho do diretório para o qual os anexos são baixados Dados em Cadeia de caracteres Nenhum(a) Sim

    Enviar e-mail

    Envia uma mensagem. Use os parâmetros para definir o corpo da mensagem e outros detalhes. Você pode incluir anexos.
    Nota:
    Use o método SetConfig para definir o endereço de origem.

    Para obter informações sobre como definir os parâmetros, consulte Configure as propriedades da porta.

    Tabela 8. Parâmetros do método de sendmail
    Parâmetro Descrição Tipo de porta de dados Tipo de dados Valor padrão Necessário? Anotações
    Endereço Endereço para o qual a mensagem será enviada Dados em Cadeia de caracteres Nenhum(a) Sim
    Cc Endereços a serem incluídos no campo CC Dados em Cadeia de caracteres Nenhum(a) Não
    Cco Endereços a serem incluídos no campo Cco Dados em Cadeia de caracteres Nenhum(a) Não
    Assunto Assunto da mensagem Dados em Cadeia de caracteres Nenhum(a) Não
    Corpo da mensagem Corpo da mensagem Dados em Cadeia de caracteres Nenhum(a) Não
    IsHtmlBody Opção para indicar se o corpo da resposta está no formato HTML Dados em Cadeia de caracteres Falso(a) Não
    Anexos Anexos de mensagem Dados em Cadeia de caracteres Nenhum(a) Não Para anexar um arquivo:
    1. Cole o caminho para o arquivo no campo.
    2. Remova as aspas que envolvem o caminho.

    Para incluir vários anexos, separe os caminhos por vírgulas.