Comunicação
Conectar o Gmail a um agente de IA autônomo
O Gmail concentra as trocas com clientes e internas. O conector Gmail chega em breve: um agente da Atako poderá triar mensagens, preparar rascunhos e limpar uma caixa, sem nunca ver sua senha do Google.
Romain Laodicina · CTO da AtakoEm breve — crie sua conta e avisaremos assim que esta integração estiver pronta.
Fluxos de trabalho possíveis
Triagem e rascunhos de resposta para a caixa de suporte compartilhada
Uma caixa support@ recebe dezenas de mensagens por dia. O agente listará as mensagens não lidas com list_messages, vai classificá-las por marcador com add_label_to_message (cobrança, bug, dúvida geral) e redigirá um rascunho de resposta com create_draft para cada pedido claro. Um humano revisará e enviará com send_draft. O agente só usará send_email se tiver recebido essa permissão específica.
Limpeza periódica da caixa de entrada
Newsletters, notificações automáticas, confirmações de leitura: o agente buscará essas mensagens com search_messages (ex.: from:noreply), verificará o marcador com list_labels e vai movê-las para a lixeira com trash_message em vez de deixá-las acumular na caixa principal. A caixa continuará legível sem que alguém gaste dez minutos toda manhã nessa triagem manual.
Acompanhamento dos fios de clientes a serem retomados
O agente buscará com search_messages as conversas sem resposta há mais de três dias, recuperará o contexto completo com get_thread, vai marcá-las com add_label_to_message e preparará um rascunho de acompanhamento com create_draft. Nada sairá sem validação humana: o agente deixará tudo pronto para o acompanhamento sair no mesmo dia.
Ações do conector
list_messages
Leitura. Listar os identificadores de mensagens, filtráveis por label.
search_messages
Leitura. Buscar mensagens com uma consulta do Gmail.
get_message
Leitura. Obter uma mensagem completa, cabeçalhos e corpo incluídos.
get_thread
Leitura. Obter um fio de conversa inteiro.
list_drafts
Leitura. Listar os rascunhos existentes.
create_draft
Escrita. Criar um rascunho de resposta sem enviá-lo.
send_draft
Escrita. Enviar um rascunho existente.
send_email
Escrita. Enviar diretamente um e-mail a partir da conta conectada.
add_label_to_message
Escrita. Adicionar um label a uma mensagem.
trash_message
Escrita. Enviar uma mensagem para a lixeira.
Pré-requisitos
- Papel de admin na empresa Atako para conectar a integração.
- Conta Gmail ou Google Workspace cuja caixa deve ser conectada.
- Consentimento OAuth do Google, escopo https://www.googleapis.com/auth/gmail.modify.
- Um grant explícito por agente, em especial para a ação send_email.
Como conectar
- 1
Abrir Contexto → Integrações
Quando o conector estiver no ar, um admin escolherá o Gmail na lista de conectores.
- 2
Verificar as ações expostas
A janela mostrará todas as ações de leitura e escrita, send_email incluída, antes da autorização.
- 3
Autenticar pela tela do Google
Redirecionamento para o consentimento do Google; nenhuma senha será enviada à Atako.
- 4
Conceder o acesso a um agente
Você escolherá as ações exatas por agente, por exemplo só create_draft para ir com cautela.
Por que conectar um agente autônomo ao Gmail
O conector Gmail ainda não está disponível. Esta página descreve o que ele fará quando estiver no ar.
O Gmail concentra as trocas com clientes, fornecedores e a equipe. Um agente autônomo conectado a ele não vai apenas responder a um comando pontual: vai rodar continuamente e decidir, conforme a instrução recebida, buscar uma mensagem, classificá-la ou preparar uma resposta, graças ao tool calling. Diferente de uma ferramenta de automação por gatilho, que roda uma vez por evento e para, o agente percorrerá uma caixa inteira sozinho.
A conexão usará OAuth 2.0, escopo https://www.googleapis.com/auth/gmail.modify (escopos do Gmail do Google). Esse escopo permite ler, redigir e enviar, mas não excluir uma mensagem de forma imediata e permanente.
É isso que tornará útil um fluxo como a triagem da caixa de suporte, próximo do que faz um agente de triagem de suporte ou de automação do suporte: ele receberá cada nova mensagem e preparará uma resposta sem esperar que um humano abra uma conversa. O Gmail fará parte das integrações cobertas pelo plano Standard, sem linha de cobrança separada por conector.
Limites e boas práticas
A ação mais sensível do conector será send_email: uma vez concedida com escopo de escrita, o agente enviará sem passar por você de novo. A prática mais segura será conceder apenas create_draft: o agente prepara, um humano revisa e dispara o envio com send_draft. Antes de validar um rascunho, confira destinatário, assunto e anexos: depois de send_draft, o e-mail sai na hora e não pode ser recuperado.
O escopo gmail.modify cobre a caixa conectada inteira, não um marcador específico. O limite real virá, portanto, da permissão: liste as ações exatas de que o agente precisa em vez de conceder tudo de uma vez ao conectar.
Cada chamada, enviada ou recusada, ficará visível no log de auditoria da página do agente. Como em qualquer conta OAuth, se o token expirar ou for revogado do lado do Google, a conexão passará para status de erro até ser reconectada. A conta conectada continua sujeita às cotas de envio do Gmail, definidas pelo Google independentemente do conector: vale distribuir os envios automáticos ao longo do dia.
Como em toda integração da Atako, a conexão sozinha não dará nenhum acesso: nada estará disponível para um agente até que um admin escolha as ações exatas e seu escopo. Essa abordagem fechada por padrão permitirá dar a um agente só create_draft e a outro, dedicado a uma tarefa mais restrita, também send_email.
Casos de uso relacionados
Integrações relacionadas
Escrito pelos agentes da Atako · Revisado e validado por Romain Laodicina · CTO da Atako
Perguntas frequentes
O agente poderá enviar um e-mail em meu nome sem validação?+
Só se a permissão incluir send_email com escopo de escrita; aí o agente enviará diretamente. Conceder apenas create_draft mantém um humano no circuito: o agente prepara a resposta, um humano revisa e envia com send_draft.
O Gmail estará incluído no plano Standard?+
Sim. Como todas as integrações, o Gmail estará incluído no plano Standard, sem custo extra por conector.
Como vou revogar o acesso da Atako à minha caixa do Gmail?+
Em Contexto → Integrações, com Revoke na conexão Gmail. O token criptografado será excluído na hora, e todos os agentes que o usavam perderão o acesso imediatamente.
O escopo gmail.modify permitirá excluir e-mails definitivamente?+
Não. Esse escopo do Google permite ler, redigir, enviar e mover para a lixeira, mas não excluir uma mensagem de forma imediata e permanente; seria preciso um escopo mais amplo do que o que o conector usará.
O que ler a seguir
Fontes
- Gmail API, scopes OAuth · acessado em 4 de setembro de 2026
- Gmail API, guide d'envoi d'emails · acessado em 4 de setembro de 2026
CTO da Atako
Este conteúdo foi redigido pelos agentes de IA da Atako, depois revisado, corrigido e validado por Romain Laodicina, CTO da Atako.