Integração com Google Calendar
Gerenciamento de eventos e agendas com integração ao Google Calendar para o CrewAI.
Visão Geral
Permita que seus agentes gerenciem eventos de calendário, agendas e disponibilidade através do Google Calendar. Crie e atualize eventos, gerencie participantes, verifique disponibilidade e otimize seu fluxo de agendamento com automação potencializada por IA.
Pré-requisitos
Antes de usar a integração com o Google Calendar, certifique-se de ter:
- Uma conta CrewAI Enterprise com assinatura ativa
- Uma conta Google com acesso ao Google Calendar
- Sua conta Google conectada pela página de Integrações
Configurando a Integração com Google Calendar
1. Conecte sua Conta Google
- Acesse Integrações do CrewAI Enterprise
- Encontre Google Calendar na seção de Integrações de Autenticação
- Clique em Conectar e complete o fluxo OAuth
- Conceda as permissões necessárias para acesso ao calendário e contatos
- Copie seu Token Enterprise nas Configurações da Conta
2. Instale o Pacote Necessário
Ações Disponíveis
GOOGLE_CALENDAR_CREATE_EVENT
GOOGLE_CALENDAR_CREATE_EVENT
Descrição: Cria um evento no Google Calendar.
Parâmetros:
eventName
(string, obrigatório): Nome do evento.startTime
(string, obrigatório): Horário de início – Aceita timestamp Unix ou formatos de data ISO8601.endTime
(string, opcional): Horário de término – Padrão para uma hora após o início, se deixado em branco.calendar
(string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.attendees
(string, opcional): Participantes – Aceita um array de e-mails ou e-mails separados por vírgula.eventLocation
(string, opcional): Local do evento.eventDescription
(string, opcional): Descrição do evento.eventId
(string, opcional): ID do evento – Um ID da sua aplicação para associar a este evento. Você pode usar esse ID para sincronizar atualizações posteriores neste evento.includeMeetLink
(boolean, opcional): Incluir link do Google Meet? – Cria automaticamente um link para conferência Google Meet para este evento.
GOOGLE_CALENDAR_UPDATE_EVENT
GOOGLE_CALENDAR_UPDATE_EVENT
Descrição: Atualiza um evento existente no Google Calendar.
Parâmetros:
eventId
(string, obrigatório): ID do evento – O ID do evento a ser atualizado.eventName
(string, opcional): Nome do evento.startTime
(string, opcional): Horário de início – Aceita timestamp Unix ou formatos de data ISO8601.endTime
(string, opcional): Horário de término – Padrão para uma hora após o início, se deixado em branco.calendar
(string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.attendees
(string, opcional): Participantes – Aceita um array de e-mails ou e-mails separados por vírgula.eventLocation
(string, opcional): Local do evento.eventDescription
(string, opcional): Descrição do evento.
GOOGLE_CALENDAR_LIST_EVENTS
GOOGLE_CALENDAR_LIST_EVENTS
Descrição: Lista eventos do Google Calendar.
Parâmetros:
calendar
(string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.after
(string, opcional): Após – Filtra eventos que começam após a data fornecida (Unix em milissegundos ou timestamp ISO). (exemplo: “2025-04-12T10:00:00Z ou 1712908800000”).before
(string, opcional): Antes – Filtra eventos que terminam antes da data fornecida (Unix em milissegundos ou timestamp ISO). (exemplo: “2025-04-12T10:00:00Z ou 1712908800000”).
GOOGLE_CALENDAR_GET_EVENT_BY_ID
GOOGLE_CALENDAR_GET_EVENT_BY_ID
Descrição: Obtém um evento específico pelo ID no Google Calendar.
Parâmetros:
eventId
(string, obrigatório): ID do evento.calendar
(string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.
GOOGLE_CALENDAR_DELETE_EVENT
GOOGLE_CALENDAR_DELETE_EVENT
Descrição: Exclui um evento do Google Calendar.
Parâmetros:
eventId
(string, obrigatório): ID do evento – O ID do evento do calendário a ser excluído.calendar
(string, opcional): Calendário – Use as Configurações de Workflow do Connect Portal para permitir que o usuário selecione em qual calendário o evento será adicionado. Padrão para o calendário principal do usuário se deixado em branco.
GOOGLE_CALENDAR_GET_CONTACTS
GOOGLE_CALENDAR_GET_CONTACTS
Descrição: Obtém contatos do Google Calendar.
Parâmetros:
paginationParameters
(objeto, opcional): Parâmetros de Paginação.
GOOGLE_CALENDAR_SEARCH_CONTACTS
GOOGLE_CALENDAR_SEARCH_CONTACTS
Descrição: Pesquisa contatos no Google Calendar.
Parâmetros:
query
(string, opcional): Termo de pesquisa para buscar contatos.
GOOGLE_CALENDAR_LIST_DIRECTORY_PEOPLE
GOOGLE_CALENDAR_LIST_DIRECTORY_PEOPLE
Descrição: Lista pessoas do diretório.
Parâmetros:
paginationParameters
(objeto, opcional): Parâmetros de Paginação.
GOOGLE_CALENDAR_SEARCH_DIRECTORY_PEOPLE
GOOGLE_CALENDAR_SEARCH_DIRECTORY_PEOPLE
Descrição: Pesquisa pessoas no diretório.
Parâmetros:
query
(string, obrigatório): Termo de pesquisa para buscar contatos.paginationParameters
(objeto, opcional): Parâmetros de Paginação.
GOOGLE_CALENDAR_LIST_OTHER_CONTACTS
GOOGLE_CALENDAR_LIST_OTHER_CONTACTS
Descrição: Lista outros contatos.
Parâmetros:
paginationParameters
(objeto, opcional): Parâmetros de Paginação.
GOOGLE_CALENDAR_SEARCH_OTHER_CONTACTS
GOOGLE_CALENDAR_SEARCH_OTHER_CONTACTS
Descrição: Pesquisa outros contatos.
Parâmetros:
query
(string, opcional): Termo de pesquisa para buscar contatos.
GOOGLE_CALENDAR_GET_AVAILABILITY
GOOGLE_CALENDAR_GET_AVAILABILITY
Descrição: Obtém informações de disponibilidade para calendários.
Parâmetros:
timeMin
(string, obrigatório): Início do intervalo. Em formato ISO.timeMax
(string, obrigatório): Fim do intervalo. Em formato ISO.timeZone
(string, opcional): Fuso horário usado na resposta. Opcional. O padrão é UTC.items
(array, opcional): Lista de calendários e/ou grupos para consulta. Padrão para o calendário padrão do usuário.
Exemplos de Uso
Configuração Básica de Agente de Calendário
Filtrando Ferramentas Específicas do Calendário
Gerenciamento e Atualização de Eventos
Gerenciamento de Contatos e Disponibilidade
Workflows de Agendamento Automatizado
Solução de Problemas
Problemas Comuns
Erros de Autenticação
- Certifique-se de que sua conta Google possui as permissões necessárias para acessar o calendário
- Verifique se a conexão OAuth inclui todos os escopos necessários para a API do Google Calendar
- Confirme se as configurações de compartilhamento do calendário permitem o nível de acesso necessário
Problemas na Criação de Eventos
- Verifique se os formatos de horário estão corretos (ISO8601 ou timestamps Unix)
- Assegure-se de que os endereços de e-mail dos participantes estão corretamente formatados
- Verifique se o calendário de destino existe e está acessível
- Confirme se os fusos horários estão especificados corretamente
Disponibilidade e Conflitos de Horário
- Use formato ISO adequado para os intervalos de horário ao verificar disponibilidade
- Certifique-se de que os fusos horários estão consistentes em todas as operações
- Verifique se os IDs dos calendários estão corretos ao consultar múltiplos calendários
Pesquisa de Contatos e Pessoas
- Assegure-se de que os termos de pesquisa estão devidamente formatados
- Verifique se as permissões para acesso ao diretório foram concedidas
- Certifique-se de que as informações de contato estão atualizadas e acessíveis
Atualização e Exclusão de Eventos
- Verifique se os IDs dos eventos estão corretos e se os eventos existem
- Assegure-se de que você possui permissões de edição para os eventos
- Verifique se a propriedade do calendário permite modificações
Obtendo Ajuda
Precisa de ajuda?
Entre em contato com nosso time de suporte para assistência na configuração da integração com o Google Calendar ou solução de problemas.