O que o Chui faz com um calendário, o que nunca faz e como desligá-lo.
Um calendário liga-se nas Definições, através da Google ou da Microsoft. É só de leitura: o Chui não consegue criar, mover nem cancelar nada nele, nem o quer fazer.
O que isso te dá:
O que é guardado e durante quanto tempo. O Chui guarda nos seus servidores as reuniões do próximo dia e meio. É isso que lhe permite propor gravar uma no momento em que começa. Para cada uma, guarda os dados do convite que ajudam o Chui a gravar e a dar nome à reunião. Hoje, isso é:
Uma reunião que terminou é apagada no prazo de vinte e quatro horas. Desligar o calendário apaga-as todas de uma vez. Nada mais antigo é guardado. Nada sobre as pessoas de um convite é pesquisado, enriquecido ou guardado à parte. Uma reunião guardada com uma gravação faz parte dessa gravação e existe enquanto ela existir.
A forma como o Chui anuncia uma reunião é uma definição:
Dez minutos antes de uma reunião sobre a qual o Chui sabe alguma coisa, o telemóvel recebe um Briefing em vez do lembrete habitual. Traz o nome da reunião e até três linhas curtas:
Ao tocar no Briefing, abre-se o ecrã do Briefing, com as mesmas linhas (uma por pessoa) e o botão que começa a gravar. O mesmo ecrã abre-se a partir da reunião em «Próximas».
O Briefing é feito a partir de todas as reuniões que podes abrir: as tuas e as de um colega que a tua equipa partilha contigo. Usa também as pessoas que nelas aparecem. Nunca usa o e-mail nem a Internet.
Quando a última ocorrência foi uma gravação de um colega, o Briefing diz de quem era. Assim, quando envias alguém a uma reunião em teu lugar, o teu próximo Briefing já sabe o que lá se decidiu.
Uma reunião sem ninguém que o Chui conheça e sem gravação anterior não recebe Briefing e mantém o lembrete habitual. Por isso, nunca há um Briefing vazio. O Briefing segue a definição dos lembretes: «Nenhum» também o desliga.
Notas para a próxima vez. Na página de uma pessoa, em «Para a próxima vez», podes deixar uma nota curta, como «perguntar pelo arrendamento do escritório». A nota vai para o topo do Briefing da próxima reunião para a qual essa pessoa for convidada. Por isso, também aparece na notificação dez minutos antes, que é o lembrete.
Uma nota só chega a uma reunião através do endereço de e-mail da pessoa no convite. Se o Chui não tiver o endereço de uma pessoa, a nota nunca chega à reunião. Quando uma reunião com essa pessoa é gravada, o Chui lê o resumo e marca a nota como feita se o assunto foi abordado. Caso contrário, espera pela reunião seguinte. Uma reunião sobre a qual o Chui não tinha mais nada a dizer recebe um Briefing quando há uma nota à espera.
Algumas organizações exigem que um administrador aprove uma aplicação antes de esta poder ler calendários. O Chui avisa quando isso acontece e dá-te um link para enviares a quem trata disso. Com um clique nesse link, essa pessoa aprova o Chui para toda a empresa.
Remover um calendário nas Definições faz com que as próximas reuniões deixem de aparecer e apaga as que estão guardadas. As tuas gravações ficam: agora são reuniões, não entradas do calendário.
Um assistente ligado ao Chui consegue ver o que aí vem. list_upcoming() é o que responde a «o que tenho hoje?». Também pode listar os calendários ligados com list_calendars().
O assistente lê a mesma vista diária consolidada que a aplicação mostra. Os eventos de dia inteiro e as reuniões que recusaste já estão de fora. Uma reunião que o Chui gravou aparece marcada como gravada. Cada reunião traz um event_id. Se o Chui tiver um Briefing para uma reunião, ela aparece marcada com has_briefing, e get_brief() devolve esse Briefing («prepara-me para a próxima reunião»).
Também pode escrever o Briefing. prepare_write_brief() mostra o que o Briefing de uma reunião diz agora e o que passaria a dizer. Depois, write_brief() escreve-o. Serve para corrigir um Briefing feito pelo Chui ou para escrever um para uma reunião sobre a qual o Chui não sabia nada. O Chui nunca refaz um Briefing escrito desta forma.
O assistente também pode tratar das tuas notas para a próxima reunião com alguém:
leave_note();list_notes();prepare_update_note() e depois update_note();prepare_remove_note() e depois remove_note().Não consegue ligar um calendário. Uma permissão de calendário pertence à tua conta e dura mais do que o assistente. Terminar a sessão do assistente não a retiraria. Por isso, o Chui recusa-se a iniciar um consentimento de calendário em nome de um assistente, seja qual for a forma do pedido. connect_calendar() responde com instruções que deves seguir num navegador. É aí que o consentimento acontece, e sempre acontecerá.
Consegue desligar um calendário, mas isso está dividido em dois passos para que a pergunta seja sempre feita. prepare_disconnect_calendar() não altera nada. Responde com o nome da conta e uma lista exata do que desapareceria. Depois, disconnect_calendar() aceita apenas um token emitido por essa primeira chamada. Assim, nunca pode agir sobre um calendário cujos detalhes não recebeu, nem sobre outro calendário.
Vale a pena ler o que desaparece antes de dizeres que sim:
As tuas gravações, os títulos e as listas de convidados ficam intactos.
O que o Chui pode e não pode prometer aqui. O Chui produz sempre essa lista, e o teu assistente recebe instruções para ta mostrar e esperar por um sim. Mas o Chui não consegue verificar se o assistente o fez. Um assistente configurado para aprovar tudo automaticamente pode executar os dois passos seguidos. Se isso for importante para ti, deixa esta ferramenta a exigir a tua aprovação nas definições do próprio assistente. É essa opção que o impede, e o Chui prefere dizer-to a deixar-te pensar o contrário.
Nada a que um assistente tenha acesso escreve sozinho no teu calendário. O Chui nunca pediu permissão para isso.
O que um assistente vê dos dados de calendário de uma GRAVAÇÃO está em O que acontece depois de parares: o nome da própria reunião, quem foi convidado e que outras gravações são ocorrências da mesma reunião recorrente.