Pular para o conteúdo principal

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:

Configurando a Integração com Google Calendar

1. Conecte sua Conta Google

  1. Acesse Integrações do CrewAI AMP
  2. Encontre Google Calendar na seção de Integrações de Autenticação
  3. Clique em Conectar e complete o fluxo OAuth
  4. Conceda as permissões necessárias para acesso ao calendário e contatos
  5. Copie seu Token Enterprise em Configurações de Integração

2. Instale o Pacote Necessário

3. Configuração de variável de ambiente

Para usar integrações com Agent(apps=[]), você deve definir a variável de ambiente CREWAI_PLATFORM_INTEGRATION_TOKEN com seu Enterprise Token.
Ou adicione ao seu arquivo .env:

Ações Disponíveis

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.
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.
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”).
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.
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.
Descrição: Obtém contatos do Google Calendar.Parâmetros:
  • paginationParameters (objeto, opcional): Parâmetros de Paginação.
Descrição: Pesquisa contatos no Google Calendar.Parâmetros:
  • query (string, opcional): Termo de pesquisa para buscar contatos.
Descrição: Lista pessoas do diretório.Parâmetros:
  • paginationParameters (objeto, opcional): Parâmetros de Paginação.
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.
Descrição: Lista outros contatos.Parâmetros:
  • paginationParameters (objeto, opcional): Parâmetros de Paginação.
Descrição: Pesquisa outros contatos.Parâmetros:
  • query (string, opcional): Termo de pesquisa para buscar contatos.
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.