E-MAIL - TOOLZZ CONNECT

Esse é um tutorial da plataforma Toolzz Connect

Eduardo avatar
Escrito por Eduardo
Atualizado há mais de uma semana

Nesse artigo você encontrará as seguintes informações:

  • Conectando e-mail para fazer

  • Gatilhos

  • Ações

  • Iterators


Sobre:

O aplicativo E-mail permite baixar e-mails via IMAP, enviar e-mails via SMTP, criar novos rascunhos, mover e copiar e-mails de uma pasta para outra, marcar e-mails como lidos ou não lidos e excluir e-mails.


Conectando e-mail para fazer

Para criar uma conexão, você pode autorizar o Toolzz Connect a interagir com um aplicativo de terceiros ou usar seu próprio ClientID e Secret por meio de configurações avançadas.

Você pode usar o seguinte:

  • Conta pessoal (não recomendado)

    As contas pessoais são simplesmente um conjunto de credenciais usadas por uma pessoa individual e somente essa pessoa. Eles fornecem o contexto de segurança apropriado para esse usuário e as ações feitas pela conta podem ser atribuídas apenas a esse usuário em circunstâncias normais. Por exemplo, a maioria das empresas fornece uma conta pessoal para cada funcionário gerenciar seu próprio e-mail.

  • Contas de serviço

    Os administradores de aplicativos de terceiros geralmente criam contas de serviço que representam outro aplicativo ou processo, em vez de um ser humano, para fornecer o contexto de segurança apropriado. As credenciais para tal conta podem ser armazenadas e gerenciadas por um grupo seleto de pessoas, em vez de serem mantidas em particular por apenas uma pessoa. Todas as ações realizadas por uma conta de serviço (por exemplo, acessar, editar ou criar um registro em um aplicativo de terceiros) só podem ser atribuídas a essa conta de serviço e a qualquer pessoa que tenha acesso à conta. Por exemplo, uma grande corporação pode optar por criar uma conta de e-mail especial, "corp_suporte@acme.com" com uma senha compartilhada por várias pessoas.


Conectar usando uma conta do Gmail

Passo a passo:

1º passo: entre no Toolzz Connect e abra o módulo de e-mail.

2º passo: clique no botão "Add" e selecione a opção "Google Restricted".

3º passo: no campo "Connection name", insira um nome para a conexão e clique em "Save".

4º passo: confirme o acesso clicando em "Permitir".

A conexão foi estabelecida.


Conectar outro e-mail usando IMAP

Passo a passo:

1º passo: entre no Toolzz Connect e abra o módulo de e-mail.

2º passo: clique no botão "Add" e selecione o tipo de conexão como "Others (IMAP)".

3º passo: no campo "Connection name" insira um nome para a conexão. Essa é uma ação opcional.

4º passo: no campo "Email provider", selecione a conta de e-mail.

Se a extensão da sua conta de e-mail não for mencionada na lista, selecione "Other" e forneça os seguintes detalhes:

Use Secure Connection (TLS):

Digite o endereço do servidor de correio recebido (IMAP). Entre em contato com seu provedor de serviços de e-mail se não tiver essas informações disponíveis.

Port:

Digite o número da porta.

Use Secure Connection (TLS):

Selecione para estabelecer uma conexão segura entre os servidores.

Use explicit TLS

Selecione para manter sua conexão criptografada.

User name

Insira o seu endereço de e-mail.

Password

Coloque sua senha.

Reject unauthorized certificates

Disponível como configurações avançadas.

Se "Sim", o certificado do servidor é verificado em relação à lista de CAs fornecidas. Para certificados autoassinados, como eles não serão combinados com as CAs integradas, defina esta opção como "Sim" e carregue seu certificado no campo "Certificate authority" ou defina esta opção como "Não" (isso fará com que todas as validações de certificado sejam ignoradas).

Certificate authority

Adicione sua autoridade de certificação a esta configuração. Um certificado autoassinado também pode ser usado como uma autoridade de certificação. O Toolzz Connect usará isso para verificar a identidade do seu servidor SMTP. Isso garante a verificação de identidade baseada em certificado bidirecional do protocolo mTLS.

Observação

Para usar o mTLS, talvez seja necessário permitir a lista de endereços IP de Toolzz Connect, além de fornecer os arquivos acima. Entre em contato com sua equipe de TI para obter mais informações.

5º passo: preencha os campos:

  • User name: digite seu endereço de e-mail.

  • Password: digite sua senha.

6º passo: clique em "Save".

A conexão foi estabelecida.


Conexão usando Microsoft SMTP/IMAP OAuth

A Microsoft substituiu a autenticação básica no Exchange Online . Use este método de conexão se a autenticação básica não for bem-sucedida.

Você pode conectar o aplicativo usando autenticação básica ou credenciais de cliente .

Conecte-se usando a conta da Microsoft

Você pode se conectar usando sua conta pessoal ou de trabalho.]

Passo a passo:

1º passo: entre no Toolzz Connect e abra o módulo de e-mail.

2º passo: clique no botão "Add" e selecione o tipo de conexão como "Microsoft SMTP/IMAP OAuth."

3º passo: no campo "Connection name" insira um nome para a conexão. Essa é uma ação opcional.

4º passo: se quiser, clique em "Show Advanced Settings" e insira as credenciais do cliente de seu aplicativo personalizado.

5º passo: clique em "Save".

Confirme sua conta para concluir a conexão.

Obtenha as credenciais do cliente

Para se conectar usando credenciais de cliente, você deve criar um aplicativo personalizado em seu Portal do Microsoft Azure.

Observação

A configuração do aplicativo do Azure é de sua responsabilidade. O Toolzz Connect sugere consultar sua equipe de TI ao fazer isso. As instruções fornecidas abaixo são apenas orientações.

Passo a passo:

1º passo: acesse Portal do Azure > Azure Active Directory > Registros de aplicativos > Novo registro .

2º passo: insira os detalhes do aplicativo.

Name

Nome do aplicativo.

Supported account types

Selecione o tipo de conta com base em suas preferências. Se você estiver selecionando uma opção multilocatário, Contas em qualquer diretório organizacional (<seu serviço> - Locatário único), o usuário que estabelece a conexão:

  • terá que usar o ID do locatário durante a criação da conexão

  • terá que estar no mesmo ID do inquilino

Redirect URI (Optional)

Selecione as seguintes opções:

3º passo: os detalhes da "Client ID" e "Tenant ID" aparecem na tela do aplicativo. Para adicionar um segredo do cliente, clique em "Add a certificate or secret".

4º passo: clique em "Add a certificate or secret", insira uma descrição, selecione o período de expiração do segredo do cliente e clique em "Add".

Observação

Após a data de expiração definida, a conexão apresentará um erro.

5º passo: copie o "Value" que é o segredo do cliente.

6º passo: no menu à esquerda, clique em "API permissions" para adicionar as permissões do aplicativo.

Selecione o aplicativo "Microsoft 365 Email" e adicione as permissões abaixo:

Para o aplicativo "E-mail", selecione o aplicativo Microsoft Graph e adicione as permissões abaixo:

Agora você tem todas as informações para se conectar ao aplicativo E-mail usando o Microsoft.

Para obter mais informações, consulte a seguinte documentação da Microsoft.


Gatilhos

Assistir e-mails

Dispara quando um novo e-mail é recebido para processamento de acordo com os critérios especificados.

Connection

Estabeleça uma conexão com sua conta de e-mail .

Folder

Selecione a pasta cujos e-mails você deseja monitorar.

Criteria

Selecione os critérios dos e-mails que deseja monitorar:

  • All Emails - Todos os e-mails

  • Only Read Emails - Ler apenas e-mails

  • Only Unread Emails - Somente e-mails não lidos

Sender Email Address

Digite o endereço de e-mail do remetente cujos e-mails você deseja monitorar.

Recipient Email Address

Digite o endereço de e-mail do destinatário cujos e-mails você deseja monitorar.

Subject

Digite o assunto do e-mail que você deseja assistir.

Phrase

Digite quaisquer palavras-chave para assistir apenas os e-mails que contêm frases específicas.

Mark message(s) as read when fetched

Selecione a opção para marcar o e-mail não lido como lido após recuperar os detalhes.

Maximum number of results

O número máximo de e-mails que a plataforma deve retornar durante um ciclo de execução do cenário.


Ações

Você pode copiar e excluir e-mails, além de criar rascunhos com os seguintes módulos.

Copiar um e-mail

Copia um e-mail ou um rascunho para uma pasta selecionada.

Connection

Estabeleça uma conexão com sua conta de e-mail.

Source Folder

Selecione a pasta da qual você deseja copiar o e-mail. Por exemplo, Caixa de entrada, Principal, Trabalho e assim por diante.

Destination Folder

Selecione a pasta para a qual você deseja copiar o e-mail. Por exemplo, Caixa de entrada, Principal, Trabalho e assim por diante.

Email ID (UID)

Digite o UID da ID de e-mail do e-mail que você deseja copiar para a pasta de destino. Você pode obter o UID do e-mail usando o módulo "Watch Email" do Toolzz Connect ou o módulo "Search Email".

Criar um Rascunho

Copia um e-mail ou um rascunho para uma pasta selecionada.

Connection

Estabeleça uma conexão com sua conta de e-mail.

Folder

Selecione a pasta na qual você deseja criar o rascunho de e-mail.

To

Digite o endereço de e-mail para o qual você deseja enviar o e-mail.

Subject

Digite a linha de assunto do e-mail.

Content Type

Selecione o tipo de conteúdo para o e-mail:

  • HTML

  • Plain Text - Texto simples

HTML

Insira o conteúdo do e-mail no formato HTML usando tags HTML ou em texto simples, conforme selecionado no campo Tipo de conteúdo.

Attachments

Adicione um anexo:

File name (Nome do arquivo)

Digite o nome do arquivo. Por exemplo, sample.doc.

Data (Dados)

Digite o caminho para a pasta para carregar o anexo.

Content-ID (ID do conteúdo)

Insira o ID do conteúdo para inserir o anexo (imagem) no conteúdo.

Copy Recipient

Digite o endereço de e-mail para quem você deseja enviar uma cópia deste e-mail.

Blind Copy Recipient

Digite o endereço de e-mail para quem você deseja enviar uma cópia deste e-mail sem que os endereços de e-mail apareçam no e-mail.

From

Digite o endereço de e-mail que aparece no campo "From".

Sender

Digite o endereço de e-mail que aparece no campo "Sender".

Reply-To

Digite os detalhes do e-mail para o qual você está enviando este e-mail como resposta.

In-Reply-To

Insira os detalhes do e-mail para o qual você está redigindo este e-mail em resposta.

References

Insira os detalhes de qualquer referência que você deseja adicionar ao e-mail.

Priority

Selecione a prioridade:

  • High - Alto

  • Low - Baixo

  • Normal

Headers

Adicione os cabeçalhos:

Key

Adicione a chave.

Value

Digite o valor da chave.

Excluir um e-mail

Remove um e-mail ou rascunho de uma pasta selecionada.

Connection

Estabeleça uma conexão com sua conta de e-mail.

Folder

Selecione a pasta do e-mail que você deseja excluir. Por exemplo, Caixa de entrada, Principal, Trabalho e assim por diante.

Email ID (UID)

Insira o UID do e-mail do e-mail que você deseja excluir. Você pode obter o UID do e-mail usando o módulo "Watch Email" do Toolzz Connect ou o módulo "Search Email".

Expunge

Se selecionado, remove permanentemente todas as mensagens marcadas como Excluídas na caixa de correio aberta no momento. Quando você usa o Gmail, o comportamento é determinado pela configuração em Configurações > Encaminhamento POP/IMAP na seção de acesso IMAP.

Obter e-mails

Retorna emails que correspondem aos critérios especificados.

Connection

Estabeleça uma conexão com sua conta de e-mail.

Folder

Selecione a pasta cujos detalhes de e-mail você deseja recuperar. Por exemplo, Caixa de entrada, Principal, Trabalho e assim por diante.

Mark message(s) as read when fetched

Selecione a opção se quiser marcar o e-mail não lido como lido após recuperar os detalhes.

Criteria

Selecione os e-mails que deseja recuperar:

  • All Emails - Todos os e-mails

  • Only Read Emails - Ler apenas e-mails

  • Only Unread Emails - Somente e-mails não lidos

Sender email address

Digite o endereço de e-mail do remetente cujos e-mails você deseja recuperar.

Recipient email address

Digite o endereço de e-mail do destinatário cujos e-mails você deseja recuperar.

From date

Insira a data para recuperar os e-mails processados ​​a partir da data especificada.

Before date

Insira a data para recuperar os e-mails processados ​​na data especificada ou antes dela.

Subject

Digite o assunto do e-mail que você deseja recuperar.

Phrase

Insira quaisquer palavras-chave para recuperar apenas aquelas que contêm essas frases.

Email ID (UID)

Insira a ID de e-mail (UID) do e-mail cujos detalhes você deseja recuperar. Você pode obter o UID do e-mail usando o módulo "Watch Email" do Toolzz Connect ou o módulo "Search Email".

Maximum number of results

O número máximo de e-mails que a plataforma deve retornar durante um ciclo de execução do cenário .

Continue the execution of the route even if the module returns no results

Selecione se deseja continuar a executar o módulo mesmo se nenhum resultado for retornado.

Marcar um e-mail como lido

Marca um e-mail ou um rascunho em uma pasta selecionada como lido, definindo o sinalizador Ler.

Connection

Estabeleça uma conexão com sua conta de e-mail.

Folder

Selecione a pasta do e-mail que deseja marcar como lida. Por exemplo, Caixa de entrada, Principal, Trabalho e assim por diante.

Email ID (UID)

Digite o UID do e-mail do e-mail que você deseja marcar como lido. Você pode obter o UID do e-mail usando o módulo "Watch Email" do Toolzz Connect ou o módulo "Search Email".

Mover um e-mail

Move um e-mail escolhido ou um rascunho para uma pasta selecionada.

Connection

Estabeleça uma conexão com sua conta de e-mail.

Source Folder

Selecione a pasta da qual você deseja mover o e-mail. Por exemplo, Caixa de entrada, Principal, Trabalho e assim por diante.

Destination Folder

Selecione a pasta à qual você deseja adicionar o e-mail. Por exemplo, Caixa de entrada, Principal, Trabalho e assim por diante.

Email ID (UID)

Insira o UID da ID de e-mail do e-mail que você deseja mover para a pasta de destino. Você pode obter o UID do e-mail usando o módulo "Watch Email" do Toolzz Connect ou o módulo "Search Email".

Enviar um email

Envia um novo e-mail.

Connection

Estabeleça uma conexão com sua conta de e-mail.

Observação

Para usar uma caixa de correio diferente do tipo GOOGLE, defina uma nova conexão que funcione com o protocolo SMTP.

Save Message after Sending

Selecione se deseja salvar o e-mail em sua caixa de correio depois de enviá-lo.

To

Digite o endereço de e-mail para quem você deseja enviar o e-mail.

Subject

Digite a linha de assunto do e-mail.

Content Type

Selecione o tipo de conteúdo para o e-mail:

  • HTML

  • Plain Text - Texto simples

Content

Insira o conteúdo do e-mail no formato HTML usando tags HTML ou no texto simples conforme selecionado no campo Type field (Tipo de conteúdo).

Attachments

Adicione um anexo:

File name (Nome do arquivo)

Digite o nome do arquivo. Por exemplo, sample.doc.

Dados (Data)

Digite o caminho para a pasta para carregar o anexo.

ID do conteúdo (Content-ID)

Insira o ID do conteúdo para inserir o anexo (imagem) no conteúdo.

Copy Recipient

Digite o endereço de e-mail para quem você deseja enviar uma cópia deste e-mail.

Blind Copy Recipient

Digite o endereço de e-mail para quem você deseja enviar uma cópia deste e-mail sem que seus endereços de e-mail apareçam no e-mail.

From

Insira o endereço de e-mail (e o nome, se necessário) que aparece no campo "From" do e-mail. Use a construção correta: name@email.com ou "Name" name@email.com

Sender

Digite o endereço de e-mail que aparece no campo "Sender field".

1. Abra as configurações avançadas da ação "Send an email" usando a caixa de seleção.

2. Digite o nome ou e-mail do remetente

Use a construção correta, conforme mostrado na dica na captura de tela abaixo. name@email.com ou "Name" name@email.com

Reply-To

Digite os detalhes do e-mail para o qual você está enviando este e-mail como resposta.

In-Reply-To

Insira os detalhes do e-mail para o qual você está redigindo este e-mail em resposta.

References

Insira os detalhes de qualquer referência que você deseja adicionar ao e-mail.

Priority

Selecione a prioridade do e-mail:

  • High - Alto

  • Low - Baixo

  • Normal

Headers

Adicione os cabeçalhos:

Key

Adicione a chave. Por exemplo, Remetente, Data, Para e assim por diante.

Value

Digite o valor para a chave.

O ID de e-mail exclusivo no protocolo IMAP

O ID de e-mail exclusivo conhecido como 'ID de e-mail (UID)' é o identificador do e-mail. A ID do e-mail é específica para cada uma das pastas do e-mail.

📢 Informações importantes

Para obter e excluir o mesmo e-mail da mesma pasta, você pode ver abaixo:

Obtendo um e-mail da sua caixa de entrada

Excluindo o e-mail da sua caixa de entrada


Iterators

Iterar anexos

Itera anexos recebidos um por um.

O módulo "Itarator" (iterador) de e-mail permite gerenciar anexos de e-mail separadamente. Por exemplo, você pode configurar para assistir e-mails para iterar os e-mails com anexos e receber alertas.

Para obter mais informações sobre iteradores, consulte Iterator.

Pronto! Agora você já sabe tudo sobre a ferramenta "E-mail" do Toolzz Connect.


Respondeu à sua pergunta?