Visão Geral
Permita que seus agentes gerenciem e-mails, contatos e rascunhos através do Gmail. Envie e-mails, pesquise mensagens, gerencie contatos, crie rascunhos e otimize suas comunicações por e-mail com automação impulsionada por IA.Pré-requisitos
Antes de usar a integração com o Gmail, certifique-se de que você possui:- Uma conta CrewAI AMP com assinatura ativa
- Uma conta do Gmail com as permissões adequadas
- Conectou sua conta do Gmail através da página de Integrações
Configurando a Integração com o Gmail
1. Conecte sua Conta do Gmail
- Navegue até Integrações CrewAI AMP
- Encontre Gmail na seção de Integrações de Autenticação
- Clique em Conectar e conclua o fluxo OAuth
- Conceda as permissões necessárias para o gerenciamento de e-mail e contato
- Copie seu Token Empresarial 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..env:
Ações Disponíveis
gmail/send_email
gmail/send_email
Descrição: Envia um e-mail pelo Gmail.Parâmetros:
toRecipients(array, obrigatório): Para - Especifique os destinatários como uma única string ou um array JSON.from(string, obrigatório): De - Especifique o e-mail do remetente.subject(string, obrigatório): Assunto - Especifique o assunto da mensagem.messageContent(string, obrigatório): Conteúdo da Mensagem - Especifique o conteúdo do e-mail em texto simples ou HTML.attachments(string, opcional): Anexos - Aceita um único objeto de arquivo ou um array JSON de objetos de arquivo.additionalHeaders(object, opcional): Cabeçalhos Adicionais - Especifique quaisquer campos de cabeçalho adicionais aqui.
gmail/get_email_by_id
gmail/get_email_by_id
Descrição: Obtém um e-mail pelo ID no Gmail.Parâmetros:
userId(string, obrigatório): ID do Usuário - Especifique o endereço de e-mail do usuário. (exemplo: “user@domain.com”).messageId(string, obrigatório): ID da Mensagem - Especifique o ID da mensagem a ser recuperada.
gmail/fetch_emails
gmail/fetch_emails
Descrição: Pesquisa e-mails no Gmail usando filtros avançados.Parâmetros:
emailFilterFormula(object, opcional): Um filtro na forma normal disjuntiva - OU de grupos E de condições únicas.Campos disponíveis:from,to,date,label,subject,cc,bcc,category,deliveredto:,size,filename,older_than,newer_than,list,is:important,is:unread,is:snoozed,is:starred,is:read,has:drive,has:document,has:spreadsheet,has:presentation,has:attachment,has:youtube,has:userlabelspaginationParameters(object, opcional): Parâmetros de Paginação.
gmail/delete_email
gmail/delete_email
Descrição: Exclui um e-mail no Gmail.Parâmetros:
userId(string, obrigatório): ID do Usuário - Especifique o endereço de e-mail do usuário. (exemplo: “user@domain.com”).messageId(string, obrigatório): ID da Mensagem - Especifique o ID da mensagem para enviar para a lixeira.
gmail/create_a_contact
gmail/create_a_contact
Descrição: Cria um contato no Gmail.Parâmetros:
givenName(string, obrigatório): Primeiro Nome - Especifique o Primeiro Nome do contato a ser criado. (exemplo: “João”).familyName(string, obrigatório): Sobrenome - Especifique o Sobrenome do contato a ser criado. (exemplo: “Silva”).email(string, obrigatório): E-mail - Especifique o endereço de e-mail do contato a ser criado.additionalFields(object, opcional): Campos Adicionais - Informações adicionais de contato.
gmail/get_contact_by_resource_name
gmail/get_contact_by_resource_name
Descrição: Obtém um contato pelo nome do recurso no Gmail.Parâmetros:
resourceName(string, obrigatório): Nome do Recurso - Especifique o nome do recurso do contato a ser buscado.
gmail/search_for_contact
gmail/search_for_contact
Descrição: Pesquisa um contato no Gmail.Parâmetros:
searchTerm(string, obrigatório): Termo - Especifique um termo para buscar correspondências aproximadas ou exatas nos campos nome, apelido, endereços de e-mail, números de telefone ou organizações do contato.
gmail/delete_contact
gmail/delete_contact
Descrição: Exclui um contato no Gmail.Parâmetros:
resourceName(string, obrigatório): Nome do Recurso - Especifique o nome do recurso do contato a ser excluído.
gmail/create_draft
gmail/create_draft
Descrição: Cria um rascunho no Gmail.Parâmetros:
toRecipients(array, opcional): Para - Especifique os destinatários como uma única string ou um array JSON.from(string, opcional): De - Especifique o e-mail do remetente.subject(string, opcional): Assunto - Especifique o assunto da mensagem.messageContent(string, opcional): Conteúdo da Mensagem - Especifique o conteúdo do e-mail em texto simples ou HTML.attachments(string, opcional): Anexos - Aceita um único objeto de arquivo ou um array JSON de objetos de arquivo.additionalHeaders(object, opcional): Cabeçalhos Adicionais - Especifique quaisquer campos de cabeçalho adicionais aqui.
Exemplos de Uso
Configuração Básica de Agente Gmail
Filtrando Ferramentas Específicas do Gmail
Gerenciamento de Contatos
Pesquisa e Análise de E-mails
Fluxos de Trabalho Automatizados de E-mail
Precisa de Ajuda?
Precisa de Ajuda?
Entre em contato com nosso time de suporte para obter assistência na configuração ou solução de problemas da integração Gmail.
