Comunicação
Conectar o Gmail a um agente de IA autônomo
O Gmail concentra as conversas com clientes e a comunicação interna. Um agente Atako pode classificar mensagens, preparar rascunhos e limpar uma caixa de entrada, sem nunca ver sua senha do Google.
Em 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 lista as mensagens não lidas com list_messages, classifica-as por label com add_label_to_message (faturamento, bug, dúvida geral), e então redige uma resposta em rascunho com create_draft para cada solicitação clara. Um humano revisa e envia com send_draft. O agente só usa send_email se esse grant específico tiver sido concedido.
Limpeza periódica da caixa de entrada
Newsletters, notificações automáticas, confirmações de recebimento: o agente busca essas mensagens com search_messages (ex.: from:noreply), verifica seu label com list_labels, e então as envia para a lixeira com trash_message em vez de deixá-las se acumular na caixa principal. A caixa continua legível sem que um humano gaste dez minutos toda manhã nessa triagem manual repetitiva, semana após semana.
Acompanhamento dos fios de clientes a serem retomados
O agente busca os fios sem resposta há mais de três dias com search_messages, recupera o contexto completo com get_thread, os rotula com add_label_to_message, e então prepara um rascunho de retomada com create_draft. Nada sai sem validação humana: o agente apenas prepara o terreno para que a retomada saia no mesmo dia, sem esperar que um vendedor se lembre por conta própria.
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 Configurações → Integrações
Um admin escolhe o Gmail na lista de conectores disponíveis.
- 2
Verificar as ações expostas
A janela exibe todas as ações de leitura e escrita, incluindo send_email, antes da autorização.
- 3
Autenticar pela tela do Google
Redirecionamento para o consentimento do Google, nenhuma senha é transmitida ao Atako.
- 4
Conceder o acesso a um agente
Escolhem-se as ações precisas por agente, por exemplo apenas create_draft para ficar mais cauteloso.
Por que conectar um agente autônomo ao Gmail
O Gmail concentra as conversas com clientes, fornecedores e a equipe interna. Um agente autônomo conectado a ele não se limita a responder a um comando pontual: ele roda continuamente e decide, conforme a instrução recebida, buscar uma mensagem, classificá-la ou preparar uma resposta, graças ao tool calling.
A conexão usa OAuth 2.0, escopo https://www.googleapis.com/auth/gmail.modify (escopos do Gmail do Google). Esse escopo permite ler, compor e enviar, mas não excluir uma mensagem de forma imediata e permanente.
É isso que torna útil um fluxo como a triagem de caixa de suporte, próximo do que faz um agente de triagem de suporte ou de automação de suporte: ele recebe cada nova mensagem e prepara uma resposta sem esperar que um humano abra uma conversa de chat. O Gmail está entre as 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 é send_email: uma vez concedida em escopo de escrita, o agente envia sem passar por você de novo. A prática mais segura é conceder apenas create_draft, o agente prepara, um humano revisa e dispara o envio com send_draft.
O escopo gmail.modify cobre toda a caixa conectada, não uma etiqueta ou label específica. O limite real vem, portanto, do grant: liste as ações exatas de que o agente precisa em vez de conceder tudo de uma vez já na conexão.
A documentação não menciona um limite de taxa específico para o conector do Gmail. Cada chamada, enviada ou recusada, continua consultável no log de auditoria da página do agente. E, como em qualquer conta OAuth, se o token expirar ou for revogado do lado do Google, a conexão passa para o status de erro até uma nova reconexão.
Casos de uso relacionados
Integrações relacionadas
Perguntas frequentes
O agente pode enviar um e-mail no meu lugar sem validação?
Sim, se o grant incluir send_email em escopo de escrita, o agente envia diretamente. A maioria das empresas prefere conceder apenas create_draft: o agente prepara a resposta, um humano revisa e envia com send_draft.
É preciso um plano pago para conectar o Gmail?
Sim, um plano Atako ativo é necessário, mas o Gmail está entre as integrações já incluídas no plano Standard, sem custo adicional por conector.
Como revogar o acesso do Atako à minha caixa do Gmail?
Em Configurações → Integrações, clique em Revoke na conexão Gmail. O token criptografado é removido imediatamente, e todos os agentes que o usavam perdem o acesso na hora.
O escopo gmail.modify permite excluir e-mails definitivamente?
Não, esse escopo permite ler, compor, enviar e enviar para a lixeira, mas não excluir uma mensagem de forma imediata e permanente, isso exigiria um escopo mais amplo do que o usado pelo conector.
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.