Passar para o conteúdo principal

Como configurar uma caixa de e-mail no Themis

Configure uma caixa de e-mail Gmail ou Microsoft 365 para receber, responder e gerenciar solicitações diretamente pelo menu Solicitações do Themis

O menu Solicitações permite centralizar e gerenciar os e-mails recebidos diretamente dentro do Themis.

Para que as mensagens sejam importadas e fiquem disponíveis para direcionamento, acompanhamento e vinculação a processos, casos ou contratos, é necessário configurar previamente uma caixa de e-mail no sistema.

O Themis é compatível com diferentes provedores de e-mail. Neste artigo, você aprenderá como configurar caixas do Gmail e do Microsoft 365 (Outlook).

Configurando uma caixa de e-mail do Gmail

Acesse Configurações > Caixa de e-mail e clique em Adicionar.
​

Preencha os campos conforme abaixo:​

Informações gerais

  • Endereço de e-mail: Informe o endereço de e-mail que será utilizado.

  • Nome completo: Nome que será exibido como remetente das mensagens enviadas pelo Themis.

  • Tipo de caixa: Selecione Autenticação padrão.

  • Usuário: Informe novamente o endereço de e-mail.

  • Senha: Utilize uma senha de aplicativo do Google. Para gerar uma senha de aplicativo, siga as instruções do Google: Como criar uma senha de aplicativo no Google.

  • Servidor IMAP do e-mail: Para contas Gmail, utilize: imap.gmail.com

  • Porta:
    143 → conexão padrão sem criptografia
    993 → conexão segura (recomendado)

  • Protocolo: IMAP.

  • Apagar mensagens do servidor: Marque esta opção caso deseje que os e-mails sejam removidos da caixa após serem importados para o Themis. Se optar por manter as mensagens no servidor, verifique periodicamente o espaço disponível na conta.

  • Servidor SMTP do e-mail: smtp.gmail.com

  • Porta:
    25 → conexão padrão
    465 → SSL
    587 → TLS

  • Autenticação: Os tipos mais utilizados são:
    SSL
    StartTLS

  • Assinatura: Opcionalmente, configure uma assinatura que será adicionada ao final dos e-mails enviados pelo sistema.

  • Usuário de abertura: Selecione o usuário responsável pelo cadastro da caixa.

Após preencher todas as informações, clique em Salvar.

Configurando uma caixa de e-mail do Microsoft 365 (OAuth2)

Para contas Microsoft 365, a autenticação é realizada através do protocolo OAuth2, exigindo algumas configurações prévias no portal Microsoft Azure.
​

Etapa 1: Criar um aplicativo no Microsoft Azure

Acesse: Portal Microsoft Azure.
​

Pesquise por Registros de aplicativo e clique sobre a opção encontrada.
​


Clique em Novo registro.
​


Preencha:

  • Nome da aplicação (ex.: Themis)

  • Tipo de conta adequado ao ambiente
    ​​

  • URI de Redirecionamento

Selecione o tipo da plataforma: Web.
​

Utilize a URL de acesso ao seu Themis seguida da rota:
​

/configuracoes/oauth2/config


Exemplo:
​

https://seuambiente.themisweb.penso.com.br/configuracoes/oauth2/config

Etapa 2: Obter os dados da aplicação

Após criar o registro, na tela inicial do aplicativo:
​

Copie e guarde o ID do aplicativo (cliente), pois este será utilizado no campo clientId no Themis.
​


​Em "Pontos de extremidade":
​

​

Copie os seguintes endereços:
​

Ponto de extremidade de autorização OAuth 2.0 (v2): No Themis será utilizado no campo: userAuthURI.


​Ponto de extremidade do token OAuth 2.0 (v2): No Themis, será utilizado no campo: accessTokenURI.

Etapa 3: Criar o Client Secret

Acesse o menu Gerenciar> Certificados e Segredos > Segredos do Cliente.
​
Clique em Novo segredo do cliente.
​


Informe uma descrição, o prazo de validade desejado e clique em Adicionar.
​

‼️ Importante: Ao término da validade do segredo, será necessário gerar um novo segredo e realizar seu cadastro no Themis. Para evitar manutenções frequentes, recomendamos utilizar o maior prazo de validade disponível.

Após adicionar, copie o valor gerado.


Este valor será utilizado no Themis no campo: clientSecret.
​

Etapa 4: Conceder permissões ao aplicativo

Acesse o menu Gerenciar> Permissões de APIs > Adicionar Permissão.
​

  • Selecione a opção APIs que minha organização usa.

  • Pesquise por Office 365 Exchange Online e clique sobre ele.

  • Na página que irá abrir clique em Permissões Delegadas.
    ​

Pesquise por Mail e marque todas opções que contenham “Mail.ReadWrite” e “Mail.Send” e salve.
​
​


Microsoft Graph

Adicione novamente uma permissão.
​

Selecione:

  • Microsoft Graph

  • Permissões Delegadas

Marque:

  • email

  • offline_access

  • IMAP.AccessAsUser.All

  • SMTP.Send


Salve as alterações.
​

Etapa 5: Conceder consentimento administrativo

Ainda na tela de permissões de APIs, clique em: Conceder consentimento do administrador.
​

Confirme a operação para liberar o acesso do Themis à conta de e-mail.
​

Etapa 6: Habilitar protocolos de e-mail no Microsoft 365

Agora, é necessário que uma conta de administrador acesse o: Portal Microsoft 365 Admin Center.
​

No menu lateral clique em: Usuários > Usuários Ativos.
​


Selecione o usuário da caixa de e-mail que será integrada e clique na em E-mail > Gerenciar aplicativos de e-mail.
​

Marque as opções necessárias para utilização de:

  • IMAP

  • SMTP autenticado
    ​

Salve as alterações.

Etapa 7: Configurar a caixa dentro do Themis

Acesse o menu Configurações > Caixa de e-mail > Adicionar.
​

Preencha:

  • Endereço de e-mail: Informe o endereço de e-mail que será utilizado.
    ​Nome completo: Nome que será exibido como remetente das mensagens enviadas pelo Themis.

Em Tipo de Caixa, selecione OAuth2
​

Siga para o preenchimento dos campos:

  • clientId: ID do aplicativo obtido no Azure.

  • clientSecret: Segredo criado no Azure.

  • userAuthURI: Endpoint de autorização OAuth2.

  • accessTokenURI: Endpoint de token OAuth2.

  • Redirect URI: Utilize a mesma URI cadastrada no Azure.

  • Scope: Para contas Microsoft 365, utilize:
    ​https://outlook.office365.com/.default offline_access

Após preencher os dados, clique em Autenticar.
​

Uma nova janela será aberta para login na conta Microsoft e concessão das permissões necessárias.
​

Ao concluir a autenticação com sucesso, retorne ao Themis para finalizar o cadastro.
​

Complete os demais campos:

  • Usuário: Endereço de e-mail da conta.

  • Servidor IMAP: outlook.office365.com

  • Porta: 993

  • Protocolo: IMAP

  • Servidor SMTP: smtp.office365.com

  • Porta: 587

  • Autenticação: StartTLS. Ou conforme configuração adotada pela sua organização.

  • Assinatura: Opcionalmente, configure uma assinatura que será adicionada ao final dos e-mails enviados pelo sistema.

  • Usuário de abertura: Selecione o usuário responsável pelo cadastro da caixa.

Após preencher todas as informações, clique em Salvar.

Utilizando a caixa configurada

Após salvar a configuração, os e-mails recebidos passarão a ser importados para o menu Solicitações > E-mail, onde poderão ser:

  • Atribuídos a responsáveis

  • Vinculados a processos, casos e contratos

  • Respondidos diretamente pelo Themis

  • Classificados por etiquetas

  • Mensurados através de indicadores e relatórios

  • Acompanhados até sua conclusão
    ​

Ficou com alguma dúvida? Entre em contato com nosso time de suporte pelo e-mail suporte@aurum.com.br ou, se preferir, utilize o ícone de chat disponível diretamente no Themis. Estamos à disposição para ajudar.
​

Estes artigos podem interessar a você:

Respondeu à sua pergunta?