## Visão geral

A Agenda da ConversaLabs sincroniza nos **dois sentidos** com o **Google Calendar**: eventos criados
na plataforma aparecem no Google e eventos criados no Google aparecem na plataforma, sem duplicar e
sem entrar em loop. A conexão é feita uma vez via **autorização Google (OAuth)** e fica **permanente**
— ela se renova sozinha até que você desconecte manualmente.

Você pode conectar **várias contas do Google** à mesma conta ConversaLabs, e cada conta do Google
pode expor **vários calendários** para espelhar. A autorização é compartilhada (você não precisa
criar um app Google próprio).

## Pré-requisitos

- Módulo **Agenda** habilitado na conta (opcional, desligado por padrão — peça a um administrador).
- Perfil com permissão para configurar integrações (em geral, administrador).
- Uma conta Google com acesso ao Google Calendar.
- Ao autorizar, conceda as permissões de calendário solicitadas — sem elas a sincronização não
  funciona.

## Passo a passo

1. Abra a **Agenda** e vá até a área de **conexões / integrações do Google**.
2. Clique para **conectar o Google Calendar**. Você será levado à tela de autorização do Google.
3. Escolha a conta Google e **autorize o acesso** ao seu calendário.
4. De volta à plataforma, **selecione quais calendários** daquela conta você quer espelhar.
5. (Opcional) Repita o processo para **conectar outras contas** do Google.
6. Aguarde a primeira sincronização: os eventos existentes passam a aparecer na Agenda.

## Configurações & opções

- **Várias conexões**: cada conta Google conectada aparece separadamente, com seus calendários.
- **Seleção de calendários**: ligue apenas os calendários que deseja espelhar.
- **Atribuição**: vincule cada calendário (nativo ou do Google) a agentes, equipes ou caixas de
  entrada, conforme a operação.
- **Google Meet, convidados, lembretes e recorrência**: quando criados na plataforma, são levados ao
  Google; quando criados no Google, voltam para a plataforma.
- **Desconectar**: a conexão permanece ativa e auto-renovável até você desconectar manualmente, o que
  revoga o acesso no Google e remove a conexão.

## Casos de uso

- Centralizar o calendário pessoal/da equipe do Google dentro da operação de atendimento.
- Deixar que agendamentos da página pública respeitem os horários ocupados do Google.
- Conectar a agenda de mais de uma pessoa ou setor à mesma conta ConversaLabs.

## Dicas, limites e boas práticas

- A sincronização é em **tempo quase real** (atualizações chegam rápido), com uma **verificação
  periodica** de segurança para garantir que nada fique de fora.
- Eventos criados pela plataforma são marcados internamente para **evitar loops** de ida e volta.
- Na versão atual, o provedor externo suportado é o **Google Calendar**. Outros provedores estão
  previstos para uma fase futura.
- Suas credenciais do Google ficam **guardadas com segurança** no servidor e **nunca** são exibidas
  no painel.

## Solução de problemas

- **A autorização falhou**: refaça o fluxo e confirme que concedeu as permissões de calendário.
- **Conectei, mas não vejo eventos**: confirme que selecionou ao menos um calendário para espelhar e
  aguarde a primeira sincronização.
- **Um evento sumiu ou duplicou**: verifique se a conexão continua ativa; a verificação periodica
  reconcilia diferenças automaticamente. Em último caso, reconecte a conta.
- **Parei de receber atualizações**: a conexão pode ter sido revogada no Google — reconecte-a.

## Veja também

- [Visão geral de Agenda e Agendamentos](/hc/ajuda/articles/calendar-scheduling-overview-pt-br)
- [Tipos de evento, disponibilidade e buffers](/hc/ajuda/articles/calendar-scheduling-tipos-de-evento-disponibilidade-buffers-pt-br)
- [Página pública de agendamento](/hc/ajuda/articles/calendar-scheduling-pagina-publica-de-agendamento-pt-br)
- [Reagendar, cancelar, Google Meet e arquivo .ics](/hc/ajuda/articles/calendar-scheduling-reagendar-cancelar-meet-ics-pt-br)