Atende Direito · Docs

Tema

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

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.

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.

Como conectar

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

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

  3. 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.

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

    O que o Google pedePor que a plataforma precisa disso
    Ver seu endereço de e-mailIdentifica 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 AgendaPermite que os agents consultem horários livres e criem eventos na agenda
    Ler e editar planilhas do Google SheetsPermite que os agents leiam dados, adicionem linhas e manipulem planilhas

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

  5. 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.

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;
  • 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.

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 — como vincular integrações do catálogo (incluindo Google Calendar e Google Sheets) a um agent