Skip to main content

Como configurar e-mail de entrada com OAuth

Introdução

Este guia explicará como configurar conexões de e-mail de entrada usando um Provedor OAuth. Como exemplo usaremos uma conta da Microsoft, porém os passos devem ser semelhantes para outros provedores.

Neste guia, configuraremos uma conta pessoal usando um Provedor OAuth de grupo. Os provedores de OAuth do grupo devem ser usados por muitos usuários no sistema.

Como administrador, você pode criar três tipos de registros:

  1. Pessoal

    1. Estes são acessíveis apenas pelo usuário que os criou

    2. Os registros pessoais devem ser usados ao configurar o acesso a contas pessoais, como 'john.doe@example-inc.onmicrosoft.com'

    3. A configuração dessas contas só pode ser acessada pelo proprietário da conta e pelos administradores do sistema

  2. Grupo

    1. Registros que serão usados por muitos usuários

    2. Os registros de grupo devem ser usados por contas em um domínio que devem ser usados por vários usuários, por exemplo todos os membros da equipe de suporte teriam acesso a support@example-inc.onmicrosoft.com

  3. Retorno

    1. Registros destinados a serem usados apenas para ler e-mails devolvidos de campanhas

Se você ainda não configurou o Provedor OAuth ou não sabe como, consulte Como configurar um Guia do Provedor OAuth da Microsoft.

2.

Criar Createuma anconexão OAuth Connection 

LoginAutentique-se intona yousua SuiteCRMinstância instanceHelloCloud e clique no nome do usuário para acessar o perfil do usuário.

On the navbar global menu click on "Profile"suitecrm-profile-link.pnghelp_profile.png

OnNo yourseu "Profile"Perfil" clickclique onno themenu "External OAuth Connection" sidebarna menubarra entry.suitecrm-oauth-connection-menu-link.pnglateral.

Thathelp_extauth.png

should

 

take

Este youmódulo toé theo "Externalque manterá a referência de todas as Conexões OAuth Connections"existentes. moduleEle listarmazena viewos tokens gerados após a autenticação.

suitecrm-external-oauth-connection-list-view.png

Vamos

Thiscriar moduleuma isnova the one that will keep the reference of all the existingconexão OAuth Connections.pessoal. Itclique storesem the tokens generated after the authentication.

Lets create a new Personal"Conexão OAuth Connection. click on "Personal OAuth Connection"pessoal"

suitecrm-new-personal-oauth-connection-link.png

ThisIsso shoulddeve takelevá-lo youpara toa thevisualização creationde view.criação.

suitecrm-oauth-connection-create-blank.pnghelp_perscreate.png

AddAdicione um nome significativo à sua conexão, pode ser o nome de usuário da sua conta ou algo que o ajude a meaningfulidentificar namee todiferenciar youra connection,conexão itde canoutras beconexões the username of your account, or something that helps you identify and differentiate the connection from other existing connections.existentes.

suitecrm-oauth-connection-name-field.png

Agora

Nowselecione selectno on thecampo "Provider"Provedor", field,selecione select theo Microsoft OAuth Provider thatque youvocê previouslycriou created.anteriormente.

suitecrm-oauth-connection-provider-field.png

Após

Afterselecionar selectingo theprovedor provideré ithora isde timeautenticar, toclique authenticate,no click on thebotão "Authenticate" button.Autenticar".

suitecrm-oauth-connection-authenticate.png

WhenAo clickingclicar theno buttonbotão, uma janela pop-up deve ser exibida com a popuppágina window should display with theda Microsoft pagepara for Authentication.autenticação.

microsoft-authenticate-popup.png

AfterDepois goingde throughpassar allpor thetodas authenticationas popupetapas steps,do thepop-up popupde shouldautenticação, closeo andpop-up thedeve fieldsfechar one theos Externalcampos no registro Conexão OAuth ConnectionExterna recorddevem shouldser be populated.preenchidos.

DoNão notarmazene storeou orcompartilhe sharenenhum any of thedos tokens. TheseEstes workfuncionam almostquase ascomo passwords.senhas. TheySão areinformações sensitive information.sensíveis.

suitecrm-oauth-connection-configured.pngVá em frente e salve seu registro.

Go

Configure aheaduma and save yourConta record.

de Entrada de E-mail

suitecrm-save-button.png

Agora

3.é Configurehora ande Inboundcriar Emailuma Account 

conta

Nowde ite-mail isde timeentrada. toClique createno anlink Inbound Email Account. Click on the "Inbound Email Accounts" sidebardo menu link.da barra lateral "Contas de e-mail de entrada".

suitecrm-inbound-email-accounts-menu-link.png

ThisVamos shouldcriar takeuma younova toconta thede Inbounde-mail Emailsde moduleentrada listpessoal. view.

clique

suitecrm-inbound-email-accounts-listview.png

Lets create a new Personal Inbound Email Account. click onem "NewNova Personalconta Inboundde Emaile-mail Account"de entrada pessoal"

suitecrm-new-inbound-email-account-link.png

ThisAdicione shouldum takenome yousignificativo toà thesua createentrada, viewpode ser o nome de usuário da sua conta ou algo que o ajude a identificar e diferenciar essa conta de email de entrada de outras contas existentes.

suitecrm-inbound-email-create-blank.png

Selecione

Addo a meaningful name to your inbound, it can be the username of your account, or something that helps you identify and differentiate this inbound email account from other existing accounts.

suitecrm-oauth-connection-name-field.png

Select thetipo "OAuth" typeno on thecampo Auth Type field.Type.

suitecrm-inbound-email-auth-type-field.png

ByAo selectingselecionar theo OAuthtipo type,OAuth, theo campo "External OAuth Connection" fieldagora shoulddeve nowser display.exibido. ClickClique onna theseta arrowpara toselecionar selecta theconexão OAuth Connectionque youvocê createdcriou before.anteriormente.

GroupOs Inbounde-mails Emailsde shouldentrada bedo linkedgrupo todevem Groupser Externalvinculados aos registros de conexão OAuth Connectionexterna records.do Ifgrupo. theySe areeles linkedestiverem Personalvinculados, Externalpodem ocorrer erros de registros de conexão OAuth Connectionexterna records errors may occurpessoal

suitecrm-inbound-email-external-oauth-connection-field.png

ClickClique onno thebotão arrowde buttonseta shouldpara openabrir um pop-up onde você pode selecionar a popup where you can select theconexão OAuth Connectionque we’vecriamos created before.antes.

suitecrm-oauth-connection-select-popup.png

Digite

Entero thenome usernamede forusuário yourda account.sua Itconta. shouldDeve beser theo samemesmo you’veque usedvocê tousou createpara thecriar OAutha Connection.conexão OAuth.

suitecrm-inbound-email-username-field.png

EnterDigite servero addressendereço fordo yourservidor account.para E.g.sua forconta. Por exemplo. para a Microsoft, seria outlook.office365.com.

Aqui estamos usando uma conta da Microsoft itcomo wouldexemplo. be outlook.office365.com.

Embora

Herevocê wedeva aredefinir usingo aendereço Microsoftdo accountservidor asque example.está Though you should set the address of the server you are usingusando

suitecrm-inbound-email-server-field.png

DependingDependendo ondas yourconfigurações serverdo configurationsseu enableservidor, theative o ssl ande setdefina thea port.porta. E.g.Por forexemplo. para a Microsoft, você deve ativar a caixa de seleção "Usar SSL", que mudará a porta para "993", que é o padrão.

Aqui estamos usando uma conta da Microsoft youcomo shouldexemplo. enableEmbora thevocê "Usedeva SSL" checkbox which is going to change the port to "993" which is the default.

Here we are usingdefinir a Microsoftporta accountdo asservidor example.que Thoughestá you should set the port of the server you are usingusando

suitecrm-inbound-email-port-field.png

NowAgora setdefina theos valuesvalores forpara theas folders.pastas. ClickClique theno botão "Select"Selecionar" buttonao nextlado tode eachcada folderpasta topara openabrir theo popuppop-up thatque willmostrará showos youvalores the available values.disponíveis.

DoNão nottente trypreencher toesses fillcampos theseantes fieldsde beforedefinir settingos theseguintes following fields:campos: ExternalConexão OAuth Connection,externa, UserNome Name,do usuário, MailEndereço Serverdo Address,servidor de correio, MailPorta Serverdo Port,servidor de correio, UseUsar SSL.SSL. OtherwiseCaso youcontrário, willvocê justverá seeapenas anum emptymenu dropdownsuspenso onvazio theno popup.pop-up.

suitecrm-inbound-email-monitored-folders.pnghelp_mailfolders.png

ForEm Microsoft:seguida, thedefina followingo isvalor anpara exampleos ofoutros how the fields should look after being configured:campos.

suitecrm-inbound-email-folders-configured.pngVá em frente e salve seu registro.

Configure o E-mail de Entrada para ser exibido no módulo de E-mails

Para que a conta configurada apareça no módulo de e-mails, você precisa ir ao seu perfil e selecioná-la como uma das contas a serem exibidas.

Next,help_profile.png

set

Isso thedeve valuelevá-lo for the other fields. The following is an example ofpara a fullypágina configurede account, except for the "Outbound Email Account" field which is not in the scope of this guide to explain how to configureperfil.

suitecrm-inbound-email-fully-configured.pnghelp_profileedit.png

GoRole aheadaté and save youro record.final da página e clique no botão "Configurações"

suitecrm-save-button.pnghelp_profilemailsett.png

4.

Isso Configuredeve theabrir Inboundum Emailmodal tocom displayuma onseção the"Gerenciamento Emailsde module 

pastas"

Forno thefinal. configuredNesta accountseção to show on the emails module, you need must go to your profile and select itselecione as onecontas ofque thedevem accountsaparecer toem show.seu módulo de Emails.

OnÉ thepossível navbarselecionar globalvárias menu click on "Profile"suitecrm-profile-link.png

This should take you to the profile page.

suitecrm-user-profile.png

Scroll to the end of the page a click on the "Settings" button

suitecrm-settings-button.png

This should open a modal with a "Folder Management" section at the end. On this section select the accounts that should display on your Emails module.

It is possible to select multiple accounts.contas.

suitecrm-profile-folder-management.png

ClickClique em "Done"Concluído"

suitecrm-done-button.pngVá em frente e salve seu perfil.

GoEssa aheaddeve and save yourser profile.a sua conta de e-mail de entrada configurada.

Acesse a conta configura no módulo de E-mails

No menu, clique no link do módulo "E-mails"

suitecrm-save-button.pnghelp_emails.png

ThatNo shouldmenu, beclique yourno Inboundlink Emaildo account configured.

5. Access the configured account on Emails module 

On the menu click on themódulo "Emails" module linkE-mails".

suitecrm-navbar-emails-link.pngDependendo do número de e-mails de entrada que você configurou, o de entrada que você acabou de configurar pode não ser aquele a ser exibido por padrão.

OnPara themudar menupara clicka onconta thede "Emails"e-mail modulede link.

entrada

suitecrm-email-list-example-1.png

que

Dependingvocê onacabou thede numberconfigurar, ofclique Inboundno Emailsbotão youda havecaixa configured,de theentrada inboundatual, youlocalizado haveno justcanto configuredsuperior may not be the one to display by default.

To change to the Inbound Email account you have just configured click on the current inbox button, located on the top right.direito.

suitecrm-emails-current-inbox-button.png

AUm modal shoulddeve showaparecer withcom theas Inboundcontas Emailde accountse-mail youde haveentrada configuredque onvocê theconfigurou Folderno Managementgerenciamento withinde yourpastas profileem seu perfil

suitecrm-current-inbox-selection.png

WithinDentro thedo modal, clickclique onna theconta Inboundde Emaile-mail Accountde youentrada haveque justvocê configured.acabou Thatde shouldconfigurar. reloadIsso thedeve pagerecarregar anda showpágina thee Inboundmostrar Emailo thate-mail youde configuredentrada que você configurou

suitecrm-configured-email-list-example.png