Agenda
Conectar o Google Agenda a um agente de IA autônomo
O Google Agenda centraliza compromissos e disponibilidades de toda a empresa. O conector Google Agenda chega em breve: um agente da Atako poderá propor horários, criar eventos e sinalizar conflitos, sem nunca ver sua senha do Google.
Romain Laodicina · CTO da AtakoEm breve — crie sua conta e avisaremos assim que esta integração estiver pronta.
Fluxos de trabalho possíveis
Agendamento de compromisso com cliente sem idas e vindas
Um vendedor ou uma equipe de suporte recebe um pedido de reunião. O agente verificará os horários livres com check_availability na agenda em questão, proporá dois ou três horários adequados e criará o evento com create_event assim que o horário for confirmado. Se a permissão de create_event tiver escopo de escrita, o Google enviará o convite aos participantes na criação; sem ela, o agente só listará os horários livres numa mensagem preparada, sem nunca agendar sozinho.
Detecção de conflitos e reservas duplicadas
O agente listará os próximos eventos com list_events, identificará duas reuniões sobrepostas ou um compromisso sem confirmação há dias e preparará uma proposta de solução. Não moverá nem cancelará nada por conta própria: cancel_event e update_event continuarão sendo ações separadas, concedidas à parte se a empresa quiser que o agente aja diretamente em vez de avisar o organizador.
Busca de horário em comum para uma entrevista ou reunião de equipe
Para organizar uma entrevista ou uma reunião com várias agendas, o agente listará as agendas acessíveis com list_calendars, consultará a disponibilidade com check_availability e identificará o primeiro horário em comum no período pedido. Só criará o evento depois que um humano validar o horário, a menos que create_event tenha sido concedido expressamente para automatizar todo o agendamento.
Ações do conector
list_events
Leitura. Listar os eventos de uma agenda em um período determinado.
get_event
Leitura. Obter os detalhes completos de um evento, participantes incluídos.
search_events
Leitura. Buscar eventos com uma consulta de texto.
check_availability
Leitura. Verificar os horários livres e ocupados de uma ou mais agendas.
list_calendars
Leitura. Listar as agendas acessíveis à conta conectada.
create_event
Escrita. Criar um evento, com seus participantes.
update_event
Escrita. Modificar um evento existente: horário, participantes ou descrição.
respond_to_event
Escrita. Responder a um convite recebido: aceitar, recusar ou tentativo.
add_attendee
Escrita. Adicionar um participante a um evento existente.
cancel_event
Escrita. Cancelar um evento existente da agenda.
Pré-requisitos
- Papel de admin na empresa Atako para conectar a integração.
- Conta Google, pessoal ou Workspace, cuja agenda deve ser conectada.
- Consentimento OAuth do Google, escopo https://www.googleapis.com/auth/calendar.events.
- Um grant explícito por agente, em especial para create_event e cancel_event.
Como conectar
- 1
Abrir Contexto → Integrações
Quando o conector estiver no ar, um admin escolherá o Google Agenda na lista de conectores.
- 2
Verificar as ações expostas
A janela mostrará todas as ações de agenda, leitura e escrita, antes da autorização.
- 3
Autenticar pela tela do Google
Redirecionamento para o consentimento do Google; nenhuma senha será enviada à Atako.
- 4
Conceder o acesso a um agente
Você escolherá as ações exatas por agente, por exemplo só check_availability e list_events para ficar em leitura.
Por que conectar um agente autônomo ao Google Agenda
O conector Google Agenda ainda não está disponível. Esta página descreve o que ele fará quando estiver no ar.
O Google Agenda concentra compromissos, reuniões e disponibilidades de boa parte das empresas, sobretudo as que usam Google Workspace. Um agente autônomo conectado a ele não vai apenas responder a um comando pontual: vai rodar continuamente e decidir, conforme a instrução recebida, verificar um horário livre, identificar um conflito ou propor um compromisso, graças ao tool calling.
A conexão usará OAuth 2.0 e o escopo calendar.events do Google Agenda (escopos OAuth do Google). Esse escopo permite ler, criar e alterar eventos, nunca excluir a própria conta Google nem mudar suas configurações de segurança.
É isso que tornará útil um fluxo como encontrar um horário em comum para uma entrevista, próximo do que faz um agente de operações de RH, ou agendar uma reunião comercial, próximo de um agente de revenue operations: ele receberá um pedido e preparará o passo seguinte (um horário, um evento, um lembrete de confirmação) sem esperar que alguém abra a agenda e compare à mão a disponibilidade de várias pessoas. O Google Agenda fará parte das integrações cobertas pelo plano Standard, sem linha de cobrança separada por conector.
Limites e boas práticas
A ação mais sensível do conector será create_event: uma vez concedida com escopo de escrita, o agente agendará um compromisso e o Google enviará o convite a cada participante, sem passar por você de novo. A prática mais segura será conceder apenas check_availability e list_events: o agente propõe horários, um humano cria o evento final e dispara os convites.
O escopo calendar.events cobre toda a agenda da conta conectada, não uma agenda secundária específica. O limite real virá, portanto, da permissão: liste as ações exatas de que o agente precisa, por exemplo só leitura para uma consulta simples, em vez de conceder criação e cancelamento de uma vez ao conectar.
update_event e cancel_event alterarão ou removerão um evento existente, inclusive para participantes que já aceitaram o convite original. Reserve essas duas ações a um agente cujo papel realmente as exija, e separe cancel_event de create_event se quiser que ele possa propor sem nunca cancelar.
Valerão as cotas padrão da API do Google Agenda. Cada chamada, enviada ou recusada, ficará visível no log de auditoria da página do agente. Como em qualquer conta OAuth, se o token expirar ou for revogado do lado do Google, a conexão passará para status de erro até ser reconectada.
Casos de uso relacionados
Integrações relacionadas
Escrito pelos agentes da Atako · Revisado e validado por Romain Laodicina · CTO da Atako
Perguntas frequentes
O agente poderá criar um compromisso e enviar o convite sem validação?+
Só se a permissão incluir create_event com escopo de escrita; aí o agente criará o evento e o Google enviará o convite. Limitar o agente a check_availability e list_events mantém um humano no circuito: ele propõe horários, um humano cria o compromisso final.
O Google Agenda estará incluído no plano Standard?+
Sim. Como todas as integrações, o Google Agenda estará incluído no plano Standard, sem custo extra por conector.
Como vou revogar o acesso da Atako à minha agenda do Google?+
Em Contexto → Integrações, com Revoke na conexão Google Agenda. O token criptografado será excluído na hora, e todos os agentes que o usavam perderão o acesso imediatamente.
O escopo calendar.events permitirá ao agente ver as agendas dos colegas?+
Não. Esse escopo cobre só a conta Google conectada. O agente só verá outra agenda se ela tiver sido compartilhada expressamente com essa conta antes, e dentro dos limites desse compartilhamento.
O que ler a seguir
Fontes
- Google Calendar API, referência · acessado em 7 de setembro de 2026
- OAuth 2.0 Scopes for Google APIs · acessado em 7 de setembro de 2026
CTO da Atako
Este conteúdo foi redigido pelos agentes de IA da Atako, depois revisado, corrigido e validado por Romain Laodicina, CTO da Atako.