Skip to main content

Conexão de email

Ação responsável por criar uma conexão personalizada com um servidor de emails. Essa conexão será necessária para a utilização de qualquer ação de emails.

Importante

Para que seja possível obter emails das caixas do Gmail, é necessário fazer configurações adicionais na sua conta do Gmail. Veja aqui um tutorial de como configurar sua conta Gmail para utilizar esta ação.

Opções​

Host​

Este campo deve ser preenchido com o host IMAP do seu provedor de e-mails. Cada provedor tem seu próprio endereço de host.

Exemplo de hosts:

  • Gmail: imap.gmail.com
  • Outlook: outlook.office365.com

Caso o usuário possua seu próprio servidor SMTP de emails, basta preencher esse campo com o endereço de host. SMTP é um protocolo de comunicação entre servidores de email. Ele permite que o usuário envie emails utilizando um servidor de email próprio.

Exemplo: smtp.servidor.com

Porta​

Este campo deve ser preenchido com o número da porta em que o serviço de email está hospedado no servidor. Caso o usuário não tenha um servidor de email próprio, ele poderá utilizar a porta do seu provedor de email pessoal. Cada provedor tem sua própria porta para o endereço do host. Exemplo:

  • Gmail: 993
  • Outlook: 993

Usuário​

Este campo deve ser preenchido com o nome de usuário que é capaz de dar acesso ao servidor.

Exemplo: nomedousuario@servidor.com

Caso o usuário não tenha um servidor de email próprio, ele poderá utilizar o seu email pessoal.

Exemplo: suporte@roberty.app

Senha​

Este campo deve ser preenchido com a senha do usuário passado no campo anterior e que é capaz de dar acesso ao servidor.

Caso o usuário não possua um servidor de emails, ele poderá utilizar a senha de seu email pessoal, exceto para Gmails que necessita de uma senha de aplicativo. Veja como obter a senha de aplicativo Gmail aqui.

Nome da caixa​

Este campo deve ser preenchido com o nome da caixa de email que será utilizada para a leitura/envio de emails.

Exemplo: INBOX

Segurança TLS​

Este campo é uma seleção de Sim ou Não. O usuário deverá selecionar Sim se o servidor SMTP utilizado possuir segurança TLS.TLS (Transport Layer Security) é um protocolo para criptografar e proteger as comunicações entre os servidores.

Para gmail ou outlook a segurança TLS é obrigatória.

Opções avançadas​

Parâmetros avançados​

Este campo deve ser preenchido em formato JSON como mostrado no exemplo abaixo:

return {
  tlsOptions: {
    rejectUnauthorized: false,
  }
}

O código mostrado acima deve ser passado quando o usuário estiver utilizando emails com domínio de gmail e outlook.

Retornos

Código customizado​

actions['id-de-conexao-de-email'].host //.host retorna o host do servidor de e-mails preenchido pelo usuário.
actions['id-de-conexao-de-email'].port //.port retorna a porta do servidor de e-mails preenchido pelo usuário.
actions['id-de-conexao-de-email'].user //.user retorna o usuário preenchido pelo usuário.
actions['id-de-conexao-de-email'].password //.password retorna a senha do usuário preenchida pelo usuário.
actions['id-de-conexao-de-email'].tls //.tls retorna verdadeiro (true) se existir segurança TLS, falso (false) caso contrário.

Seleção de campos​

retornos retornos