> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flunora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gmail e Google Agenda

> A conexão é de cada pessoa, não da organização. O que a Flunora acessa, o que ela nunca acessa e como revogar.

<Info>
  Depende da chave `google`. Na barra lateral, **Emails**, e as reuniões na **Agenda**.
</Info>

Diferente de todas as outras integrações, esta é **por pessoa**. Cada vendedor autoriza a
própria conta e a Flunora age em nome dela. Não existe uma conexão da organização que dê
acesso à caixa de entrada de todo mundo.

<Warning>
  Nem administrador, nem dono, nem super admin leem a correspondência ou o calendário de
  quem trabalha na conta. Papel de administrador dá acesso aos dados do CRM, não à
  correspondência de terceiros.
</Warning>

O que a organização enxerga de uma reunião é o registro dela no histórico do contato, e
esse sim segue a regra de papel.

## Consentimento em dois passos

O Google separa escopos por sensibilidade, e a Flunora pede o mínimo em cada momento.

<Steps>
  <Step title="Conectar">
    Pede o necessário para agir em seu nome: criar evento no calendário e enviar email.
    É o que habilita criar reunião com link de chamada e responder a partir do CRM.
  </Step>

  <Step title="Ler a caixa de entrada">
    É um segundo consentimento, pedido separadamente. Sem ele, você envia e cria
    reuniões, mas a caixa de entrada não aparece no produto.
  </Step>
</Steps>

A tela mostra o que a sua conta concedeu, a partir do que o Google devolveu, e não a
partir do que a plataforma supõe ter pedido.

## O que acontece na conexão

A caixa de entrada e a agenda são sincronizadas: as mensagens recentes, com uma janela
inicial, e os eventos de um intervalo em volta de hoje. A partir daí a sincronização é
incremental, trazendo só o que mudou.

<Note>
  Quando o marcador de sincronização do Google vence, o que acontece de tempos em
  tempos, a plataforma volta para a carga por janela sozinha. Não é erro e não pede nada
  de você.
</Note>

As threads são ligadas ao contato correspondente, então a conversa aparece na ficha dele
sem ninguém copiar nada.

## Sugestões de contato

Depois da primeira sincronização, os correspondentes mais frequentes que ainda não são
contatos aparecem como sugestão, e podem ser promovidos em lote. É o caminho mais rápido
de trazer para o CRM as pessoas com quem o time já conversa.

## Enviar e responder

Responder pelo produto entra na **mesma** conversa na caixa do destinatário. Isso exige
mais do que apontar a thread, e é um detalhe que costuma sair errado em integrações
caseiras: sem os cabeçalhos de referência, o Gmail do outro lado abre uma conversa nova.

Quando a Aurora escreve um email, o envio exige a sua aprovação, um por um. Veja
[Permissões](/aurora/permissoes).

## Reuniões com link de chamada

Criar a reunião pela Flunora cria o evento, convida os participantes e gera o link no
mesmo passo. Sem esse pedido explícito de conferência, o Google cria o evento sem link e
sem erro.

## Quando a conexão cai

O acesso do Google vale por uma hora e é renovado sozinho. Quando a renovação é recusada,
porque a senha mudou, o acesso foi revogado ou o administrador do domínio interveio, a
conta é marcada como precisando de religação e a tela pede isso, em vez de falhar em
silêncio.

## Revogar

A qualquer momento, pela tela de conexão ou pela sua conta Google. A partir dali a
plataforma para de ler e de enviar por aquela conta. O que já foi registrado no CRM,
como as reuniões no histórico do contato, continua lá, porque é registro de CRM e não
cópia da sua caixa.

## Segurança de exibição

O corpo de um email é renderizado num quadro isolado, sem execução de script. Email é
conteúdo escrito por terceiros, e exibi-lo direto na página seria dar a um remetente
qualquer o direito de rodar código na sua sessão.
