API do Gmail: o que dá para fazer e como usar com agentes de IA
A API do Gmail dá acesso programático às caixas de e-mail do Gmail e do Google Workspace: mensagens, conversas, rótulos e rascunhos. É usada por empresas que querem automatizar triagem, respostas e registro de e-mails em outros sistemas. O acesso é por OAuth 2.0 com projeto no Google Cloud.
Os grandes recursos da API, em português claro.
Leitura, busca com a mesma sintaxe do Gmail, envio e movimentação de e-mails e threads.
Criação e edição de rascunhos que podem ser revisados antes do envio.
Criação e aplicação de rótulos para organizar a caixa.
Download e envio de arquivos anexados.
Avisos de mudanças na caixa via Google Cloud Pub/Sub.
Filtros, respostas automáticas, encaminhamento e assinaturas.
Como se acessa a API do Gmail.
- Com credencial da sua empresaOAuth 2.0 com projeto no Google Cloud e escopos do Gmail; em contas Workspace, o administrador pode autorizar uma conta de serviço com delegação de domínio.
- Documentação oficialdevelopers.google.com/gmail/api
- Escopos amplos de Gmail são classificados como restritos pelo Google e podem exigir verificação do app.
- Há cotas de uso por usuário e por projeto.
- E-mails contêm dados pessoais e sigilosos: limite quais caixas o agente acessa.
- api gmail
- gmail api documentação
- gmail api enviar email
- integração api gmail
- gmail api python
- gmail api oauth
- gmail api ler emails
O que um agente do iTeam faz com a API do Gmail.
O agente lê e-mails do contato@, classifica por assunto, cria o lead no CRM e prepara rascunho de resposta para o vendedor revisar.
Anexos de nota fiscal e boleto são identificados, salvos na pasta certa e lançados como conta a pagar para conferência.
O agente acompanha propostas enviadas e, sem resposta após o prazo combinado, sugere um follow-up no tom da empresa.
Executivos recebem um resumo diário dos e-mails que pedem decisão, separados do resto.
Da credencial ao agente trabalhando, com aprovação.
Crie o projeto no Google Cloud
Ative a API do Gmail, configure a tela de consentimento e escolha os escopos mínimos, como leitura e rascunhos.
Autorize as caixas no iTeam
Cada caixa é autorizada por OAuth ou por delegação do administrador; o token fica no cofre e você define o que cada agente pode fazer.
Comece com rascunhos
No início o agente só cria rascunhos e rótulos; envio direto é liberado depois para mensagens de baixo risco.
Dúvidas sobre a API do Gmail.
A API do Gmail é gratuita?
Sim, de forma geral o uso da API não é cobrado dentro das cotas do Google; o custo é a própria conta Gmail ou Workspace.
Preciso programar para usar a API do Gmail com o iTeam?
Não. O iTeam já conecta ao Gmail e o time de implantação ajuda com o projeto no Google Cloud e as autorizações.
O agente envia e-mail em meu nome sem eu ver?
Só se você liberar. O padrão é o agente preparar rascunhos e enviar depois da sua aprovação.