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:
|
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:
|
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 | 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,
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:
|
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:
|
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:
|
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: |
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.
 |
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:
|
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.