> ## Documentation Index > Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt > Use this file to discover all available pages before exploring further. # Gmail > Gerenciamento de e-mail com Gmail API e OAuth 2.0 ## Autenticação e Configuração A integração com o Gmail requer autenticação OAuth 2.0 por meio do Google Cloud Platform. As organizações devem criar um projeto no Google Cloud Console, ativar a Gmail API e configurar a tela de consentimento do OAuth. A integração suporta contas pessoais do Gmail e contas empresariais do Google Workspace (anteriormente G Suite). Os tokens de autenticação são armazenados com segurança e atualizados automaticamente para manter o acesso contínuo. ## Escopos de API Necessários * **gmail.readonly**: Acesso somente leitura a e-mails e configurações. * **gmail.send**: Enviar e-mails em nome do usuário. * **gmail.compose**: Criar e gerenciar rascunhos de e-mails. * **gmail.modify**: Acesso completo para ler, redigir, enviar e modificar e-mails. * **gmail.labels**: Gerenciar etiquetas e categorias de e-mails. ## Operações Disponíveis Com todas as permissões necessárias configuradas, o toolkit permite as seguintes operações: ### Gerenciamento de E-mails * **Pesquisar E-mails**: Pesquisa avançada usando a sintaxe de consulta do Gmail (from:, to:, subject:, has:attachment, is:unread, etc.). * **Obter Conteúdo do E-mail**: Recuperar o e-mail completo com cabeçalhos, corpo (texto simples/HTML) e lista de anexos. * **Enviar E-mail**: Redigir e enviar novos e-mails com múltiplos destinatários, CC/CCO, anexos e conteúdo HTML. * **Responder ao E-mail**: Responder a threads existentes mantendo o histórico de conversas e o encadeamento. * **Encaminhar E-mail**: Encaminhar mensagens para outros destinatários com comentários adicionais opcionais. * **Obter Anexos**: Baixar anexos de e-mails para processamento ou armazenamento. * **Excluir E-mail**: Mover e-mails para a lixeira ou excluir permanentemente da lixeira. * **Arquivar E-mail**: Remover da caixa de entrada, mantendo em Todos os E-mails. * **Marcar como Spam**: Reportar e mover e-mails indesejados para a pasta de spam. * **Marcar como Importante/Estrelado**: Sinalizar e-mails importantes para fácil recuperação. ### Gerenciamento de Rascunhos * **Criar Rascunho**: Salvar composições de e-mail como rascunhos sem enviar. * **Atualizar Rascunho**: Modificar o conteúdo, destinatários ou anexos de um rascunho existente. * **Enviar Rascunho**: Enviar um rascunho de e-mail criado anteriormente. * **Listar Rascunhos**: Visualizar todos os rascunhos de e-mail salvos. * **Excluir Rascunho**: Remover rascunhos de e-mail da pasta de rascunhos. ### Operações de Etiquetas * **Listar Etiquetas**: Obter todas as etiquetas disponíveis, incluindo etiquetas do sistema e personalizadas. * **Criar Etiqueta**: Criar etiquetas personalizadas para organização de e-mails. * **Aplicar Etiqueta**: Adicionar uma ou múltiplas etiquetas aos e-mails. * **Remover Etiqueta**: Remover etiquetas dos e-mails. * **Renomear Etiqueta**: Alterar nomes de etiquetas para melhor organização. * **Excluir Etiqueta**: Remover etiquetas personalizadas (os e-mails permanecem intactos). ### Operações de Thread * **Obter Thread**: Recuperar a thread de conversa completa com todas as mensagens. * **Listar Threads**: Consultar threads de conversa com base em critérios de pesquisa. * **Modificar Thread**: Aplicar operações em lote a todos os e-mails em uma thread. ### Gerenciamento de Status * **Marcar como Lido**: Atualizar o status de leitura para um ou múltiplos e-mails. * **Marcar como Não Lido**: Sinalizar e-mails como não lidos para atenção posterior. * **Mover para Lixeira**: Mover e-mails para a pasta de lixeira. * **Restaurar da Lixeira**: Restaurar e-mails da lixeira para a caixa de entrada. ## Opções de Configuração Configuração do toolkit Gmail com seleção de ferramentas * **Filtros de Consulta**: Definir filtros padrão para pesquisas (por exemplo, pesquisar apenas nos últimos 30 dias). * **Máximo de Resultados**: Configurar o número máximo de e-mails a serem recuperados por consulta (padrão 50, máximo 500). * **Incluir Spam/Lixeira**: Se deve incluir pastas de spam e lixeira nas pesquisas. * **Tratamento de Anexos**: Definir limites de tamanho e verificação de vírus para anexos baixados. * **Etiquetas Padrão**: Aplicar automaticamente etiquetas aos e-mails enviados pelo agente. * **Modo Thread**: Ativar/desativar o agrupamento automático de threads para respostas. ## Casos de Uso * **Gerenciamento Inteligente de Caixa de Entrada**: Categorizar, etiquetar e priorizar automaticamente e-mails recebidos com base na análise de conteúdo. * **Extração de Leads**: Verificar e-mails em busca de informações de contato, extrair leads e popular sistemas de CRM. * **Respostas Automatizadas**: Gerar respostas contextuais a consultas comuns usando o conhecimento da KB. * **Monitoramento de E-mails**: Acompanhar palavras-chave ou remetentes específicos e acionar fluxos de trabalho ou notificações. * **Gerenciamento de Newsletters**: Arquivar, resumir ou cancelar inscrição automaticamente de e-mails promocionais. * **Suporte ao Cliente**: Roteirizar e-mails de suporte para as equipes apropriadas com base na classificação de conteúdo. * **Rastreamento de Despesas**: Extrair recibos de e-mails, processar anexos e registrar em sistemas contábeis. * **Coordenação de Reuniões**: Analisar e-mails de convite para reuniões e sincronizar com sistemas de calendário. ## Melhores Práticas * **Usar Sintaxe de Consulta do Gmail**: Aproveitar operadores de pesquisa avançados para filtragem precisa de e-mails. * **Operações em Lote**: Processar múltiplos e-mails em operações únicas para reduzir chamadas de API. * **Respeitar Cotas de API**: A Gmail API possui limites de cota diária (1 bilhão de unidades de cota/dia para o Google Workspace). * **Implementar Backoff Exponencial**: Tratar limitação de taxa de forma elegante com lógica de retentativa. * **Respostas Seguras para Threads**: Sempre usar IDs de thread ao responder para manter o contexto da conversa. * **Organização de Etiquetas**: Criar uma hierarquia clara de etiquetas para classificação automática. ## Considerações sobre Cotas de API A Gmail API usa um sistema de cota em que diferentes operações custam diferentes quantidades. Custos típicos: Enviar e-mail (100 unidades), Obter mensagem (5 unidades), Listar mensagens (1 unidade). Monitore o uso no Google Cloud Console para evitar atingir os limites. Para aplicações de alto volume, solicite aumentos de cota por meio do Google. ## Problemas Comuns e Soluções * **Cota Excedida**: Implementar cache e operações em lote para reduzir chamadas de API. Solicitar aumento de cota se necessário. * **Erro de Grant Inválido**: Token expirado ou revogado. Reautenticar o usuário por meio do fluxo OAuth. * **Permissões Ausentes**: Certificar-se de que todos os escopos necessários foram solicitados durante o consentimento do OAuth. * **Falhas no Download de Anexos**: Anexos grandes podem atingir o limite de tempo; usar download em streaming para arquivos >5MB.