Agenda
Conectar o Google Agenda a um agente de IA autônomo
O Google Agenda concentra os compromissos e a disponibilidade de toda a empresa. Um agente Atako pode propor horários, criar eventos e identificar conflitos, sem nunca ver sua senha do Google.
Em 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 compromisso. O agente verifica horários livres com check_availability na agenda relevante, propõe dois ou três horários compatíveis, e então cria o evento com create_event assim que o horário escolhido é confirmado. O convite é enviado automaticamente aos participantes assim que o evento é criado, se o grant create_event tiver escopo de escrita; sem ele, o agente apenas lista os horários disponíveis em uma mensagem preparada, sem nunca agendar o compromisso por conta própria.
Detecção de conflitos e reservas duplicadas
O agente lista os próximos eventos com list_events, identifica duas reuniões que se sobrepõem ou um compromisso que ficou sem confirmação por vários dias, e prepara uma proposta de resolução. Ele não move nem cancela nada por conta própria: cancel_event e update_event continuam sendo ações distintas, concedidas separadamente se a empresa quiser que o agente aja diretamente em vez de apenas sinalizar o conflito ao organizador.
Busca de horário em comum para uma entrevista ou reunião de equipe
Para organizar uma entrevista de contratação ou uma reunião envolvendo várias agendas, o agente lista as agendas acessíveis com list_calendars, consulta a disponibilidade delas com check_availability, e então identifica o primeiro horário em comum no período solicitado. Ele só cria o evento depois que esse horário é validado por um humano, a menos que create_event tenha sido explicitamente concedido para automatizar totalmente 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 Configurações → Integrações
Um admin escolhe o Google Agenda na lista de conectores disponíveis.
- 2
Verificar as ações expostas
A janela exibe 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 é transmitida ao Atako.
- 4
Conceder o acesso a um agente
Escolhem-se as ações precisas por agente, por exemplo apenas check_availability e list_events para permanecer apenas leitura.
Por que conectar um agente autônomo ao Google Agenda
O Google Agenda concentra compromissos, reuniões e disponibilidade de grande parte das empresas, especialmente as que usam Google Workspace. Um agente autônomo conectado a ele não se limita a responder a um comando pontual: ele roda continuamente e decide, 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 usa OAuth 2.0 e o escopo do Google Agenda calendar.events (escopos OAuth do Google). Esse escopo permite ler, criar e modificar eventos de agenda, nunca excluir a própria conta Google ou alterar suas configurações de segurança.
É isso que torna útil um fluxo como a busca de um horário em comum para uma entrevista, próximo do que faz um agente de operações de RH, ou o agendamento de um compromisso comercial, próximo de um agente de operações de receita: ele recebe um pedido e prepara o próximo passo (um horário, um evento, um lembrete de confirmação) sem esperar que um humano abra sua agenda para comparar manualmente a disponibilidade de várias pessoas. O Google Agenda está entre as 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 é create_event: uma vez concedida em escopo de escrita, o agente marca um compromisso e o Google envia automaticamente o convite a todos os participantes, sem passar por você de novo. A prática mais segura é conceder apenas check_availability e list_events: o agente propõe horários, um humano cria o evento final e dispara o envio dos convites por conta própria.
O escopo calendar.events cobre toda a agenda da conta conectada, não uma agenda secundária específica. O limite real vem, portanto, do grant: liste as ações exatas de que o agente precisa, por exemplo apenas leitura para um uso de mera consulta, em vez de conceder criação e cancelamento de uma vez já na conexão.
update_event e cancel_event alteram ou removem um evento existente, inclusive para os demais participantes se já tiverem aceitado o convite original. Reserve essas duas ações para um agente cujo papel realmente exija isso, e mantenha cancel_event separado de create_event no grant se quiser que ele possa propor sem nunca poder cancelar.
A documentação não menciona um limite de taxa específico para o conector do Google Agenda, aplicam-se as cotas padrão da API do Google Calendar. Cada chamada, enviada ou recusada, continua consultável no log de auditoria da página do agente. E, como em qualquer conta OAuth, se o token expirar ou for revogado do lado do Google, a conexão passa para o status de erro até uma nova reconexão.
Casos de uso relacionados
Integrações relacionadas
Perguntas frequentes
O agente pode criar um compromisso e enviar o convite sem validação?
Sim, se o grant incluir create_event em escopo de escrita, o agente cria o evento e o Google envia o convite aos participantes automaticamente. A maioria das empresas prefere limitar o agente a check_availability e list_events: ele propõe horários, um humano cria o compromisso final.
É preciso um plano pago para conectar o Google Agenda?
Sim, um plano Atako ativo é necessário, mas o Google Agenda está entre as integrações já incluídas no plano Standard, sem custo adicional por conector.
Como revogar o acesso do Atako à minha agenda do Google?
Em Configurações → Integrações, clique em Revoke na conexão Google Agenda. O token criptografado é removido imediatamente, e todos os agentes que o usavam perdem o acesso na hora.
O escopo calendar.events permite ver a agenda de outros colegas?
Não, esse escopo cobre apenas a conta Google conectada. O agente só vê a agenda de um colega se ela tiver sido explicitamente compartilhada com essa conta previamente, e apenas 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.