Ir para a navegação
ConfigurarIntegrações

Google Calendar

Conecte seus agentes da ElevenLabs ao agendamento do Google Calendar

Visão geral

Conecte seus agentes de IA da ElevenLabs ao Google Calendar para gerenciar agendamentos e compromissos do calendário. Essa integração permite que seus agentes verifiquem a disponibilidade, criem, atualizem e excluam eventos com participantes e conferência opcional do Google Meet, listem próximos eventos e descubram calendários acessíveis por meio de uma conversa natural.

Recursos

RecursoSuporte
Modo de retenção zero (ZRM)Não compatível
Anexos em ferramentasNão compatível — as ferramentas operam apenas com texto

Aviso de segurança

Aviso de segurança: google_calendar_update_event e google_calendar_delete_event são ferramentas privilegiadas. Elas são executadas com acesso total ao calendário da conta Google conectada, e não apenas aos eventos criados pelo seu agente. Qualquer pessoa que possa falar com o agente pode alterar ou cancelar qualquer evento nesse calendário, incluindo eventos que não criou, porque o agente pode consultar IDs de eventos com google_calendar_list_events. Uma confirmação no prompt do sistema é uma orientação para o modelo, não um controle de segurança.

Habilite essas ferramentas apenas em agentes com a autenticação ativada ou quando o ID do evento vier de uma fonte confiável. Não as adicione a agentes públicos. Os participantes sempre são notificados quando um evento é atualizado ou excluído.

Configuração

Esta integração usa o Google OAuth 2.0 para autenticação. Você autoriza a ElevenLabs a acessar seu Google Calendar em seu nome.

1

Clique em Conectar na ElevenLabs

Na configuração da integração da ElevenLabs, clique em Conectar. Você será redirecionado ao Google para autorizar o acesso.

2

Selecione sua conta Google

Escolha a conta Google cujos dados de calendário seu agente deve acessar. Se seu navegador estiver conectado a várias contas Google, selecione a correta.

3

Autorize o acesso ao calendário

Revise as permissões solicitadas e clique em Permitir. A integração solicita acesso para gerenciar eventos em calendários dos quais você é proprietário, visualizar sua lista de calendários e verificar informações de livre/ocupado.

Escopos do OAuth

A integração solicita os seguintes escopos do Google OAuth 2.0:

EscopoFinalidade
calendar.events.ownedCriar, ler, atualizar e excluir eventos em calendários dos quais você é proprietário.
calendar.calendarlist.readonlyVisualizar a lista de calendários acessíveis à sua conta (nomes e IDs).
calendar.freebusyVerificar a disponibilidade de livre/ocupado entre calendários sem expor detalhes dos eventos.

Como funciona

O agente agenda reuniões usando chamadas de ferramentas para avançar pelo processo de agendamento. As abas abaixo mostram um resumo geral e um prompt detalhado do sistema.

1

Descobrir calendários

O agente lista os calendários acessíveis para identificar o correto para o agendamento. Para a maioria dos usuários, este é o calendário principal.

2

Verificar disponibilidade

O agente verifica a disponibilidade de livre/ocupado ao:

  • Usar a ferramenta google_calendar_check_availability para consultar blocos de horário ocupados.
  • Verificar se o horário solicitado está livre.
  • Sugerir alternativas caso o horário solicitado entre em conflito com um evento existente.
  • Confirmar o horário selecionado com a pessoa que está ligando.
3

Coletar dados dos participantes

Quando um horário é definido, o agente:

  • Coleta o nome completo e o endereço de e-mail do participante.
  • Confirma o e-mail repetindo-o para a pessoa que está ligando.
  • Verifica as informações de fuso horário.
4

Criar o evento

O agente:

  • Chama a ferramenta google_calendar_create_event com os detalhes confirmados.
  • Opcionalmente adiciona um link do Google Meet se for solicitada uma videoconferência.
  • Confirma a criação do evento e informa ao participante que ele receberá um convite do calendário.

Ferramentas do agente

Ao adicionar ferramentas do Google Calendar a um agente, as seguintes ferramentas integradas ficam disponíveis:

FerramentaDescrição
google_calendar_check_availabilityVerifique a disponibilidade de livre/ocupado de um ou mais calendários dentro de um intervalo de tempo. Retorna blocos de horário ocupados para que o agente encontre horários livres. Use antes de criar eventos para evitar conflitos.
google_calendar_create_eventCrie um novo evento em um Google Calendar com participantes, local e conferência do Google Meet opcionais. Envia notificações por e-mail a todos os participantes.
google_calendar_list_eventsListe os próximos eventos de um calendário dentro de um intervalo de tempo, ordenados pelo horário de início. Compatível com pesquisa de texto livre em resumos, descrições, locais e dados dos participantes.
google_calendar_update_eventPrivilegiada. Atualize qualquer evento no calendário, por exemplo, para reagendá-lo ou alterar seu título, local ou participantes. Somente os campos fornecidos são alterados. Os participantes são notificados.
google_calendar_delete_eventPrivilegiada. Exclua qualquer evento no calendário, cancelando-o para todos os participantes. Primeiro, use a lista de eventos para encontrar o ID do evento. Para eventos recorrentes, use o ID de uma ocorrência ou seu recurringEventId (toda a série).
google_calendar_list_calendarsListe todos os calendários acessíveis à conta Google conectada. Retorna nomes e IDs dos calendários. Use para descobrir qual calendário usar antes de verificar a disponibilidade ou criar eventos.