Skip to main content
Atualmente, a integração do Gmail opera por meio de aplicativos menos seguros. No entanto, a partir de 15 de junho de 2024, o Google Workspace deixará de suportar esses aplicativos menos seguros. Isso afetará a integração do Gmail no AirysChat. Para garantir que sua integração do Gmail continue funcionando, você precisará configurar um aplicativo OAuth no Google Workspace.
As configurações existentes continuarão a funcionar até 30 de setembro de 2024. No entanto, recomendamos a configuração de um aplicativo OAuth o mais rápido possível para evitar qualquer interrupção.
Este guia o guiará pelo processo de configuração de um aplicativo OAuth no Google Workspace.

​
Registre o aplicativo

Para habilitar o Google OAuth no AirysChat, você precisa fornecer o ID do cliente, o segredo do cliente e a URL de retorno de chamada. Você pode encontrar as instruções para gerar esses detalhes aqui. Depois de seguir essas etapas, você poderá obter um ID do Cliente e um Segredo. Use a URL de retorno de chamada https://<your-instance-url>/google/callback ao registrar o aplicativo. Esta URL é usada para redirecionar o usuário de volta para a instância do AirysChat após a autenticação. Defina as variáveis de ambiente GOOGLE_OAUTH_CLIENT_ID e GOOGLE_OAUTH_CLIENT_SECRET na sua instalação do AirysChat usando os valores que você copiou do Google API Console.
Se você já configurou o fluxo de login do Google OAuth Você pode usar o mesmo aplicativo, simplesmente adicionando a nova URL de retorno de chamada. Não remova a URL de retorno de chamada anterior.
Depois de definir essas variáveis de ambiente, reinicie o servidor do AirysChat para aplicar as alterações. Agora, os usuários poderão fazer login usando suas contas do Google. Você notará que o aplicativo que você está usando está no modo de teste; abordaremos isso mais adiante no guia. Por enquanto, você pode ignorar isso.

​
Configure o aplicativo

Para buscar os e-mails da caixa de entrada do cliente, você precisa configurar os escopos corretos. Os seguintes escopos são necessários:
  • https://mail.google.com/: Para ler, enviar, excluir e gerenciar seu e-mail.
  • email: Para visualizar o endereço de e-mail do usuário.
  • profile: Para visualizar o nome e a foto, etc.
Você pode configurar os escopos no Google API Console seguindo as etapas abaixo:
  1. Vá para o Google API Console.
  2. Selecione o projeto que você criou anteriormente.
  3. Clique na guia “Tela de consentimento OAuth” (OAuth consent screen) e clique no botão “Editar aplicativo” (Edit App).
  4. Adicione os escopos necessários na seção “Escopos para APIs do Google” (Scopes for Google APIs).
  5. Clique no botão “Salvar” (Save).
Aqui está uma demonstração mostrando como adicionar o escopo https://mail.google.com/:

​
Publicando o aplicativo

Se você estiver usando o AirysChat dentro de uma organização com menos de 100 usuários, você pode continuar a usar o aplicativo em modo de teste. No entanto, se você estiver usando o AirysChat em uma organização com mais de 100 usuários ou usando o aplicativo para atender a vários clientes, precisará publicar o aplicativo para torná-lo disponível para todos os usuários. Para publicar o aplicativo, você precisa passar pelo processo de verificação, pois usamos um escopo restrito. Você pode encontrar as instruções para verificar o aplicativo aqui. É importante notar que o processo de verificação pode levar alguns dias para ser concluído. Assim que o aplicativo for verificado, você poderá publicá-lo e torná-lo disponível para todos os usuários.