Nesta secção é explicado como configurar uma ligação a um serviço/caixa de correio eletrónico para utilizá-lo para sincronizar os e-mails recebidos como Tickets no módulo do GlobalSuite®.
Dados Gerais
As secções para configurar (que para poder editá-las é necessário ativar a ligação) são as seguintes:
-
Nome: Nome ou identificador do conector
-
Utilizador: User ou conta de e-mail utilizada para a sincronização
-
Server Name / IP: Endereço, domínio ou caminho do servidor de e-mail ao qual conectar
-
Porta: Porta de ligação para o servidor de e-mail
-
Protocolo mail: Protocolo utilizado para obter os e-mails (POP3 / IMAP)
NOTA: A palavra-passe do utilizador deverá ser introduzida no momento de realizar a sincronização, esse dado não é armazenado no GlobalSuite®
OAuth
Caso a autenticação seja realizada através do protocolo OAuth, existem dois possíveis fornecedores a utilizar, que são:
Microsoft Graph API
Os campos a preencher são os seguintes:
-
ID do Cliente: identificador público da aplicação registada no fornecedor OAuth, usado para solicitar tokens em seu nome.
-
Segredo do Cliente: chave confidencial da aplicação (tipo “palavra-passe” da app) que é usada juntamente com o ID do Cliente para autenticar ao pedir um token.
-
ID do Diretório (tenant): identificador do tenant/diretório (ex., Azure AD) onde a aplicação está registada e contra o qual os tokens são emitidos.
-
Token de Atualização: token de longa duração que permite obter novos access tokens sem repetir o consentimento/login do utilizador (típico no Gmail).
-
URL do Endpoint de Token: URL do serviço OAuth onde as credenciais (e/ou refresh token) são trocadas para obter o access token.
-
Scope de Permissões: lista de permissões solicitadas que define o que o token pode fazer (ex., ler e-mails, modificá-los/marcá-los como lidos, etc.).
Gmail API
Os campos a preencher para conectar com uma conta de e-mail do Gmail (ou GSuite) são os seguintes:
-
ID do Cliente: identificador público da aplicação registada no fornecedor OAuth, usado para solicitar tokens em seu nome.
-
Segredo do Cliente: chave confidencial da aplicação (tipo “palavra-passe” da app) que é usada juntamente com o ID do Cliente para autenticar ao pedir um token.
-
Token de Atualização: token de longa duração que permite obter novos access tokens sem repetir o consentimento/login do utilizador (típico no Gmail).
-
Scope de Permissões: lista de permissões solicitadas que define o que o token pode fazer (ex., ler e-mails, modificá-los/marcá-los como lidos, etc.).
Conectado com
Permite marcar em que opções de Ticketing (para que tipos de ticket) estará disponível a sincronização desta ligação. O mapeamento de quais campos do e-mail, como remetente, assunto e corpo do e-mail, são carregados em quais campos do ticket criado será configurado em Ajustes > Configuração > Tickets: Email