Sincronização bidirecional com Google Agenda

A integração com Google Agenda transforma o atendente em uma central única de compromissos. Reuniões marcadas no SiteUp aparecem no calendário pessoal do atendente e do cliente; eventos criados direto no Google Calendar aparecem na timeline do contato relacionado. Este artigo explica como autorizar e o que esperar do comportamento bidirecional.

O que é "bidirecional"

A propagação é via push notifications do Google Calendar API — sem polling, mudanças aparecem em segundos.

Pré-requisitos

• Conta Google (pessoal ou Workspace) do atendente
• Permissão pra atendente conectar serviços externos (configurável pelo administrador)
• Conta SiteUp com módulo de Agendamentos ativo

Passo 1 — Autorizar o OAuth

Cada atendente conecta sua própria conta Google. Não existe conexão "da empresa" — é por usuário, pra respeitar privacidade do calendário pessoal.

1. Perfil → Integrações → Google Agenda
2. Clique em Conectar com Google
3. Selecione a conta Google
4. Conceda os escopos solicitados:
   • calendar.events — criar/editar eventos
   • calendar.readonly — listar calendários disponíveis
5. Volte ao SiteUp — uma lista dos seus calendários aparece

Passo 2 — Escolher os calendários

Você decide quais calendários sincronizam. Casos comuns:

• Atendentes B2C: usam um calendário "Atendimento SiteUp" dedicado pra não misturar com pessoal
• Atendentes B2B: sincronizam direto no calendário principal pra evitar conflitos
• Times comerciais: criam um calendário compartilhado da equipe e cada atendente sincroniza esse

Você pode marcar:

• Calendário primário pra escrita (onde o SiteUp cria eventos)
• Calendários adicionais pra leitura (eventos aparecem na timeline mas o SiteUp não escreve neles)

Criando reuniões pelo SiteUp

Dentro de uma conversa, clique em Agendar reunião. O modal pede:

• Título (ex.: "Demo SiteUp - Maria Silva")
• Data e horário
• Duração
• Descrição (opcional, vai pro evento)
• Vídeo conferência (Google Meet automático, ou cole link Zoom)

Ao salvar:

1. Evento é criado no seu Google Calendar
2. Convite Google Calendar é enviado pro e-mail do contato
3. Mensagem automática vai pro WhatsApp do contato com link do Meet (template configurável)
4. Lembrete cai 1h antes via push do SiteUp

Quando o evento vem do Google Calendar

Se o atendente criar um evento direto no Google Calendar com um convidado cujo e-mail já existe como contato no SiteUp, o evento aparece automaticamente na timeline do contato com:

• Título e descrição do evento
• Status (confirmado, tentativo, cancelado)
• Link do Meet/Zoom
• Histórico de alterações

Isso é útil quando o atendente prefere agendar pelo Google Calendar (mais rápido pra alguns) e ainda quer o registro no CRM.

Múltiplos calendários e fusos

A integração lida bem com cenários complexos:

• Múltiplos calendários do atendente: você escolhe o destino padrão por evento
• Fusos diferentes entre atendente e cliente: SiteUp normaliza ambos. O atendente vê em São Paulo, o cliente em Lisboa, o evento é o mesmo
• Atendente em viagem: respeita o fuso atual do dispositivo

Comportamentos importantes

• Eventos privados no Google Calendar (marcados como "Privado") não sincronizam pro SiteUp, mesmo com contato vinculado
• Eventos sem convidados não aparecem na timeline (não há contato pra associar)
• Reagendamento pelo Google Calendar atualiza o evento no SiteUp e dispara nova mensagem ao contato apenas se a configuração "notificar mudanças" estiver ativa
• Desconectar a conta Google pausa a sincronização mas mantém o histórico já registrado

Solução de problemas comuns

Próximos passos

• Webhooks customizados — pra reagir a "reunião agendada" e disparar lembretes adicionais
• API REST: autenticação — pra criar eventos programaticamente