criadordeagentes

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

  1. 1
    Acesse console.cloud.google.come crie um projeto (qualquer nome, ex: “meu-agente”).
  2. 2
    No menu, busque “Google Calendar API” e clique em Ativar.
  3. 3
    Busque “Contas de serviço” (Service Accounts) → Criar conta de serviço. Dê um nome e conclua (não precisa de papel/role).
  4. 4
    Abra a conta criada → aba Chaves Adicionar chave → JSON. Um arquivo .json é baixado — é a credencial.
  5. 5
    Copie 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).
  6. 6
    No painel do agente → Modelo & recursos Variáveis de ambiente: crie uma variável GOOGLE_SERVICE_ACCOUNT_JSON e cole o conteúdo do arquivo .json. Reinicie o agente.
  7. 7
    No 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.