---
title: Conectar Google Workspace
description: Como conectar uma conta Google ao seu escritório para que os agents consultem e criem eventos na agenda, leiam e editem planilhas, e o que fazer quando a autorização precisa ser renovada.
---

# Conectar Google Workspace

Imagina que um agent precisa marcar uma consulta com um cliente, mas não tem acesso à sua agenda — ele consegue conversar, mas não consegue efetivamente agendar nada. Conectar sua conta Google resolve exatamente isso: dá ao agent acesso à sua agenda do Google para consultar horários livres e criar eventos, além de ler e manipular planilhas do Google Sheets, sem que você precise copiar e colar nada manualmente.

## O que essa conexão habilita

Ao conectar sua conta Google, você libera **duas integrações no catálogo de ferramentas**: **Google Calendar** e **Google Sheets**. Os agents passam a poder consultar sua agenda e criar eventos, além de ler dados, adicionar linhas e manipular planilhas do Google Sheets.

<Dica>

Gmail, Drive e Docs **ainda não** fazem parte desta integração — estão previstos para versões futuras. Se seu agent depende de e-mail ou de documentos do Google hoje, isso ainda não está disponível por aqui.

</Dica>

<Dica>

**Reconectar para as novas integrações.** Se você já tinha o Google Workspace conectado antes de Google Sheets e Google Calendar serem adicionados como integrações separadas do catálogo, suas conexões antigas continuam funcionando com os dados e capacidades que já tinha. Para usar as integrações novas (Google Sheets e Google Calendar como itens separados do catálogo), reconecte sua conta clicando em **Reconectar** — você receberá a solicitação de novas autorizações do Google e, depois de aceitar, as duas integrações (Google Calendar e Google Sheets) ficarão disponíveis no catálogo e a conexão antiga "Google Workspace" será substituída automaticamente.

</Dica>

## Que conta conectar

A conexão é **uma conta por escritório** (workspace), não uma conta por usuário nem por agent. Depois de conectada, todos os agents do workspace que tiverem a ferramenta de Calendar habilitada agem **como essa conta**: os eventos que eles criam aparecem no Google Agenda como criados por ela.

<Dica>

Use a conta operacional do escritório (a agenda que já é compartilhada com a equipe), não a conta pessoal de um advogado específico. Como só existe uma conexão por workspace, essa é a conta que todos os agents vão enxergar.

</Dica>

<Secao icon="list-checks">Como conectar</Secao>

<Passos>
  <Passo>

Acesse **Conexões** → **Integrações** no menu lateral.

  </Passo>
  <Passo>

Localize o card **Google Workspace** e clique em **Conectar conta Google**.

  </Passo>
  <Passo>

Uma janela pop-up abre com a tela de login e consentimento do Google. Escolha (ou faça login com) a conta que vai representar o escritório.

<Cuidado>

Se o seu navegador bloquear pop-ups, libere a exibição de pop-ups para o Atende Direito e clique em **Conectar conta Google** novamente.

</Cuidado>

  </Passo>
  <Passo>

O Google mostra a tela de consentimento pedindo autorização para os seguintes acessos:

| O que o Google pede | Por que a plataforma precisa disso |
|---|---|
| Ver seu endereço de e-mail | Identifica qual conta está conectada e exibe o e-mail na tela de Integrações |
| Ver informações básicas do seu perfil (nome, foto) | Confirma para você, visualmente, qual conta foi conectada |
| Ver, editar, compartilhar e excluir permanentemente eventos do Google Agenda | Permite que os agents consultem horários livres e criem eventos na agenda |
| Ler e editar planilhas do Google Sheets | Permite que os agents leiam dados, adicionem linhas e manipulem planilhas |

Revise a lista e clique em **Continuar** (ou **Permitir**) para autorizar.

  </Passo>
  <Passo>

O pop-up fecha sozinho e o card muda para o estado **Conectado**, mostrando o e-mail da conta e a data da conexão.

  </Passo>
</Passos>

<Cuidado>

Se a conta escolhida **já havia autorizado** o Atende Direito antes (por exemplo, uma reconexão manual feita fora do fluxo normal) e a conexão falhar, revogue o acesso em [myaccount.google.com/permissions](https://myaccount.google.com/permissions) e tente conectar de novo. Esse passo garante que o Google emita as credenciais completas na nova autorização.

</Cuidado>

## Acesso restrito durante o período inicial

Enquanto o aplicativo do Atende Direito estiver em fase de homologação junto ao Google, **só contas previamente autorizadas conseguem concluir a conexão** — outras contas recebem um aviso de "app não verificado" ou são bloqueadas na tela de consentimento. Se você tentar conectar e isso acontecer, fale com o suporte para que seu e-mail seja adicionado à lista de contas liberadas.

## Quando a autorização precisa ser renovada

De tempos em tempos, o Google pode invalidar a autorização que ele deu ao Atende Direito. Isso acontece, por exemplo, quando:

- alguém revoga o acesso manualmente em [myaccount.google.com/permissions](https://myaccount.google.com/permissions);
- a senha da conta Google é trocada;
- uma política do Google Workspace do escritório revoga acessos de terceiros.

Quando isso acontece, o card muda para o estado **Precisa reconectar**, com um aviso destacado explicando que a autorização expirou ou foi revogada. Enquanto isso não for resolvido, os agents **param de conseguir consultar e criar eventos na agenda**, além de perder acesso às planilhas — o restante do atendimento continua funcionando normalmente.

Para resolver, clique em **Reconectar** no card — o fluxo é o mesmo passo a passo de conectar pela primeira vez.

## Como desconectar

1. Acesse **Conexões** → **Integrações** e clique no card **Google Workspace** conectado para abrir o painel de gerenciamento.
2. Clique em **Desconectar** e confirme.

<Cuidado>

Ao desconectar, a agenda e as planilhas deixam de estar disponíveis para os agents imediatamente. **Eventos que já foram criados no Google não são apagados nem alterados** — a desconexão só remove o acesso da plataforma daquele momento em diante.

</Cuidado>

## Nota técnica (para quem administra a conta)

O token de acesso (a credencial que autoriza a plataforma a falar com o Google em nome da conta conectada) é renovado automaticamente antes de expirar — você não precisa fazer nada para mantê-lo válido no dia a dia.

Essa renovação garante margem suficiente para execuções de agent de até **15 minutos**. Se algum agent do seu escritório estiver configurado com um tempo limite de execução maior que isso, chamadas ao Google Calendar feitas perto do fim dessa janela podem falhar por token expirado. Esse cenário não é comum — a maioria dos agents roda em poucos minutos —, mas fica registrado aqui caso você configure limites de execução personalizados.

## Saiba mais

- [Ferramentas do Agent](/guia/agents/ferramentas) — como vincular integrações do catálogo (incluindo Google Calendar e Google Sheets) a um agent