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
- Abra a Agenda e vá até a área de conexões / integrações do Google.
- Clique para conectar o Google Calendar. Você será levado à tela de autorização do Google.
- Escolha a conta Google e autorize o acesso ao seu calendário.
- De volta à plataforma, selecione quais calendários daquela conta você quer espelhar.
- (Opcional) Repita o processo para conectar outras contas do Google.
- 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.