Skip to main content
Acessar Studio

Google

O Roberty Studio oferece quatro tipos de conexão Google, cada um vinculado a um serviço específico:

ConexãoServiço
Google DriveGerenciamento de arquivos e pastas no Drive
GmailEnvio e leitura de e-mails
Google CalendarCriação e consulta de eventos
Google SheetsLeitura e escrita em planilhas

O processo de criação e autenticação é o mesmo para todos os quatro tipos — a diferença está apenas em qual serviço cada conexão habilita dentro dos seus robôs e agentes.

Modos de autenticação​

SSO do Google (padrão)​

A forma mais simples. Ao criar a conexão, uma janela de login será aberta — faça login com a conta desejada e autorize o acesso. Nenhuma configuração adicional é necessária.

Credenciais próprias (Bring Your Own Credentials)​

Para organizações que precisam usar um aplicativo Google Cloud próprio — seja por requisitos de segurança, limites de cota ou necessidade de controle sobre o app publicado. Neste modo, você informa o Client ID e o Client Secret do seu próprio projeto no Google Cloud.

O passo a passo abaixo serve para qualquer uma das quatro conexões. Se quiser habilitar mais de um serviço, basta ativar as APIs correspondentes no mesmo projeto.

Pré-requisito

É necessária uma conta no Google Cloud Console para criar e configurar o projeto.

1. Criar um projeto no Google Cloud​

  1. No Google Cloud Console, clique em Selecionar projeto (ou Ctrl+O) e depois em Novo projeto no canto superior direito.
  2. Escolha um nome para o projeto e clique em Criar.
  3. Certifique-se de que o novo projeto está selecionado antes de continuar.

2. Habilitar as APIs necessárias​

  1. No menu lateral, clique em APIs e Serviços.

  2. Clique em + Ativar APIs e Serviços.

  3. Busque e ative a API correspondente a cada conexão que deseja usar:

    Conexão no RobertyAPI a ativar
    Google DriveGoogle Drive API
    GmailGmail API
    Google CalendarGoogle Calendar API
    Google SheetsGoogle Sheets API

    Você pode ativar mais de uma API no mesmo projeto e reutilizar as mesmas credenciais para todas as conexões.

3. Criar a tela de consentimento OAuth​

  1. No menu lateral de APIs e Serviços, clique em Tela de permissão OAuth e depois em Vamos começar.
  2. Preencha o nome do aplicativo e o e-mail do responsável.
  3. Em Público, selecione Externo.

4. Criar o cliente OAuth​

  1. Após criar a tela de consentimento, clique em Criar um cliente OAuth.
  2. Em tipo de aplicativo, selecione Aplicativo da Web.
  3. Em URIs de redirecionamento autorizadas, adicione: 
    https://studio.roberty.app/oAuthCallback/redirect
  4. Clique em Criar.
  5. Ao finalizar, selecione o cliente criado e clique no ícone de download para salvar o arquivo de credenciais — você vai precisar do Client ID e do Client Secret contidos nele.

5. Publicar o aplicativo​

No menu lateral, acesse Público Alvo e clique em Publicar app.

6. Configurar a conexão no Roberty​

  1. No Studio, acesse Workspace → Conexões e crie uma nova conexão do tipo desejado (Google Drive, Gmail, Google Calendar ou Google Sheets).
  2. Selecione o modo Credenciais próprias.
  3. Informe o Client ID e o Client Secret obtidos no passo anterior.
  4. Conclua a autenticação OAuth na janela que será aberta.

Repita o passo 6 para cada tipo de conexão que quiser configurar — as credenciais do mesmo projeto podem ser reutilizadas.

Como trocar a conta autenticada​

Acesse a conexão e clique em Trocar conta. Uma nova janela de login será aberta para autenticação com outra conta.