Documentação
Conectando o Google
Dá pra conectar o seu agente ao Google Calendar— aí “o que tenho hoje?” e o briefing matinal passam a mostrar a sua agenda de verdade. É uma receita avançada: exige uns 15 minutos de configuração no Google, mas só se faz uma vez.
Como funciona
Você cria uma “conta de serviço” no Google (um robô com e-mail próprio), compartilha o seu calendário com ela e entrega a credencial pro seu agente pelo painel. O agente passa a consultar a agenda sozinho — sem senha sua, sem acesso a mais nada.
Passo a passo
- 1Acesse
console.cloud.google.come crie um projeto (qualquer nome, ex: “meu-agente”). - 2No menu, busque “Google Calendar API” e clique em Ativar.
- 3Busque “Contas de serviço” (Service Accounts) → Criar conta de serviço. Dê um nome e conclua (não precisa de papel/role).
- 4Abra a conta criada → aba Chaves → Adicionar chave → JSON. Um arquivo .json é baixado — é a credencial.
- 5Copie o e-mail da conta de serviço (termina em
.iam.gserviceaccount.com). No Google Calendar (web), vá em configurações do seu calendário → Compartilhar com pessoas específicas→ adicione esse e-mail (permissão “Ver todos os detalhes” basta; “Fazer alterações” se quiser que o agente crie eventos). - 6No painel do agente → Modelo & recursos → Variáveis de ambiente: crie uma variável
GOOGLE_SERVICE_ACCOUNT_JSONe cole o conteúdo do arquivo .json. Reinicie o agente. - 7No Telegram, mande: “Você tem uma credencial do Google na variável GOOGLE_SERVICE_ACCOUNT_JSON. Use ela pra acessar meu Google Calendar (o calendário [seu e-mail]) e me diz o que tenho essa semana. Guarde como fazer isso pra usar sempre.”
Na primeira vez o agente monta o acesso (pode levar um minuto); depois ele lembra do caminho e fica instantâneo. A partir daí, inclua a agenda em qualquer rotina: “no briefing das 7h, inclua meus compromissos do dia”.
O que dá e o que não dá
- Funciona: ler agenda, listar compromissos, criar e alterar eventos (se você deu permissão de alteração).
- Não funciona por este caminho: Gmail pessoal — o Google só libera e-mail pra contas de serviço em planos corporativos (Workspace, com delegação de domínio). Pra Gmail, aguarde a integração oficial da plataforma.
Trate o JSON como uma senha
Cole a credencial somente no painel (variáveis de ambiente) — nunca no chat do Telegram. Ela dá acesso exatamente ao que você compartilhou com a conta de serviço: só o calendário, nada além. Pra revogar, basta remover o e-mail do compartilhamento do calendário.