Agenda: ligação com o Google Agenda

A Agenda conversa com o Google Agenda em dois caminhos, e os dois partem de você: o compromisso cadastrado aqui pode virar um evento no seu Google, e os eventos do seu Google podem ser trazidos para cá quando você mandar. Nada disso começa antes de você ligar a sua conta.

ONDE FICA
Tudo começa em Minha agenda, no botão Mais ações, no alto da tela. Esse botão oferece, no máximo, três itens além de Gerenciar situações: Vincular com o Google Agenda, Sincronizar com o Google Agenda e Desvincular do Google Agenda. Vincular aparece enquanto a sua conta não está ligada; depois de ligada, no lugar dele aparecem Sincronizar e Desvincular. Gerenciar situações depende da sua permissão para a tela de situações e não tem relação com o Google.

A REGRA QUE EXPLICA QUASE TUDO
O vínculo é de cada usuário, não da empresa. Quem liga a conta é a pessoa, e o sistema guarda essa ligação com o nome do usuário que estava logado na hora. Por isso ligar a sua conta não liga a conta de ninguém mais: cada colega precisa entrar com o próprio acesso e fazer o mesmo caminho pelo Mais ações. E por isso o compromisso vai para o Google da pessoa que está no campo Responsável do compromisso, não para o Google de quem cadastrou.

COMO LIGAR A SUA CONTA
Abra a Agenda, clique em Mais ações e depois em Vincular com o Google Agenda. O sistema leva você ao Google para autorizar o acesso ao calendário e devolve para a lista de compromissos com a mensagem de integração realizada. Se você já tinha ligado antes, o sistema avisa que você já está integrado. Depois de ligada, a conta fica registrada e o item do menu passa a ser Desvincular do Google Agenda.

COMO DESLIGAR A SUA CONTA
No mesmo Mais ações, clique em Desvincular do Google Agenda e confirme ("Deseja desvincular sua conta do Google Agenda?"). Ao final aparece "O Google Agenda foi desvinculado com sucesso!". O sistema apaga apenas o registro da ligação da sua conta. Os eventos que já tinham sido criados no Google continuam lá, porque desvincular não é o mesmo que apagar agenda: o desvínculo só encerra a autorização guardada aqui.

A OPÇÃO SINCRONIZAR COM O GOOGLE AGENDA
Dentro do compromisso, logo abaixo do campo Local, fica o interruptor Sincronizar com o Google Agenda. Ele aparece sempre, mas só fica liberado quando o responsável escolhido no compromisso tem conta do Google ligada. Quando não tem, o interruptor fica apagado e a tela explica: "O responsável ainda não vinculou a conta do Google. Para vincular, ele entra na Agenda e usa Mais ações › Vincular com o Google Agenda." Não é falta de permissão.

Em compromisso novo o interruptor começa desligado: ligue quando quiser que o compromisso vá para o Google. A escolha fica gravada no compromisso, então quem abrir depois para editar vê o interruptor como ficou, seja quem for. Arrastar o compromisso no calendário mantém a escolha. Ao trocar o responsável, o interruptor volta a ficar desligado; ligue de novo para o evento ir para a agenda do novo responsável.

CONVIDADOS E LINK DO GOOGLE MEET
Com o interruptor ligado aparece o campo Convidados: digite o e-mail e clique em Adicionar. Cabem até 3 convidados por compromisso. Quando a pessoa do compromisso tem e-mail no cadastro, a tela sugere esse e-mail logo abaixo ("E-mail do cadastro:"), para adicionar com um clique. As recusas da tela são "Informe no máximo 3 convidados por compromisso.", "Informe um e-mail válido." e "Este e-mail já está na lista de convidados.".

Quem envia o convite é o próprio Google, pela conta do responsável. Compromisso com convidados ganha automaticamente um link de reunião do Google Meet, que vai no convite e aparece ao abrir o compromisso, na linha Reunião no Google Meet. Sem convidados, o evento vai para o Google sem link de reunião. Alterar o compromisso atualiza o convite, e excluir avisa os convidados do cancelamento.

O QUE VAI PARA O GOOGLE
Vão o título do compromisso, a descrição, o local, a data e a hora. Se o compromisso não tem hora, o evento entra como dia inteiro, porque não há horário para posicionar. Se tem hora, o evento começa no horário marcado e termina uma hora depois, no fuso de Brasília; para horários a partir das 23h, o evento termina às 23:59. O evento é sempre criado no calendário principal da conta, então não adianta procurar em outro calendário. Os lembretes cadastrados no compromisso são enviados junto e viram lembretes do próprio evento no Google, na mesma antecedência em minutos: os de e-mail como lembrete de e-mail, os de SMS e WhatsApp como aviso de tela. Quando o compromisso não tem lembrete próprio, o evento fica com o lembrete padrão do calendário.

QUANDO O EVENTO SAI DA AGENDA DO GOOGLE
Excluir o compromisso na Agenda apaga o evento correspondente no Google. Desmarcar a caixa Sincronizar com o Google Agenda e salvar manda apagar o evento daquele compromisso; se ele continuar aparecendo, apague direto no Google. Trocar o responsável de um compromisso já sincronizado apaga o evento da agenda do responsável antigo e cria o evento na agenda do novo responsável, já que o evento sempre pertence à conta de quem responde pelo compromisso. Num compromisso que se repete, cada compromisso da série é um evento próprio no Google: com o interruptor ligado no cadastro, todos vão; editar ou excluir "este e os próximos" atualiza ou apaga o evento de cada um.

Se o Google recusar o envio (conexão caída, autorização vencida), o compromisso é salvo assim mesmo aqui na Agenda; o que deixa de acontecer é o evento no Google.

TRAZER OS EVENTOS DO GOOGLE PARA A AGENDA
O item Sincronizar com o Google Agenda faz o caminho de volta: ele lê os eventos do seu calendário principal, do último mês em diante, e cria ou atualiza os compromissos correspondentes aqui. Isso acontece somente quando você clica, nunca sozinho, e ao final o sistema informa quantos eventos foram processados. Os compromissos criados por essa importação ficam com você como responsável.

Antes de usar esse item, entenda três efeitos, porque eles mexem no que já está cadastrado. Primeiro: evento apagado ou cancelado no Google faz o compromisso correspondente ser excluído da Agenda, porque a importação trata o Google como origem e reproduz aqui o que aconteceu lá. Segundo: o que veio do Google sobrescreve o que foi digitado aqui, ou seja, título, descrição, local, data e hora são substituídos pelos do evento, o compromisso volta para a primeira situação cadastrada da sua empresa e passa a ter você como responsável, mesmo que antes fosse de outra pessoa. Terceiro: dos lembretes do evento, só os de e-mail são trazidos para o compromisso; lembretes de tela do Google não viram lembrete aqui.

O QUE COSTUMA DAR ERRADO
O interruptor Sincronizar com o Google Agenda está apagado. Olhe o campo Responsável: ele depende da conta daquela pessoa estar ligada, não da sua. Peça para o responsável entrar com o acesso dele e usar Vincular com o Google Agenda.

O convidado não recebeu o convite, ou não veio o link do Meet. Confira se o interruptor estava ligado ao salvar e se o e-mail está na lista de Convidados; o link do Meet só é criado quando há pelo menos um convidado. O convite sai pelo Google, então vale olhar também a caixa de spam do convidado.

O compromisso foi salvo com a caixa marcada e você não encontra o evento. Procure no calendário principal da conta do responsável, que é o único calendário usado, e confirme que a conta ligada é mesmo aquela.

O compromisso sumiu da Agenda depois de você clicar em Sincronizar com o Google Agenda. Verifique se o evento equivalente foi apagado ou cancelado no Google: nesse caso a exclusão aqui é o comportamento esperado da importação.

O texto do compromisso voltou ao que estava no Google e a situação voltou para a primeira da lista. Foi a importação: ela regrava o compromisso com os dados do evento. Se você edita bastante aqui, use Sincronizar com o Google Agenda com parcimônia.

Você desvinculou a conta e os eventos continuam no Google. É o esperado, porque desvincular encerra a autorização e não mexe no que já foi criado. Apague os eventos direto no Google se quiser removê-los.

Aparece a mensagem de credenciais inválidas ou token expirado ao sincronizar. Faça o que a mensagem pede: Desvincular do Google Agenda e depois Vincular com o Google Agenda de novo, para o sistema receber uma autorização nova.

Aparece a mensagem de que você não tem permissão ao tentar desvincular. Essa ação exige a permissão de usuário do sistema; fale com quem administra os usuários da sua conta.

Aparece a mensagem pedindo a url para autenticação do Google Agenda. Isso é configuração do endereço da sua conta e não se resolve pela tela da Agenda; acione o suporte.

O QUE NÃO É DESTA FONTE
Cadastro de usuário e permissões do sistema são do ERP e têm fonte própria; aqui tratamos apenas do compromisso e do aplicativo Agenda.