O Gmail consegue encontrar exatamente as mensagens certas. O Google consegue exportar tudo o que é seu. Nada conecta as duas coisas.
Não existe em lugar algum do Gmail um botão do tipo "selecione estes resultados e exporte os remetentes para uma planilha". Esse é o ponto de partida honesto, e é por isso que essa pergunta aparece tanto.
Ou seja, a pergunta não é como aperto o botão. É qual das quatro soluções de contorno serve para o que você realmente quer fazer.
| Rota | Boa para | Custa a você |
|---|---|---|
| Outros contatos | Todo mundo para quem você já escreveu | Três cliques, mas nenhuma filtragem |
| Exportação do Contatos | Um CSV limpo de contatos salvos | Só contatos, não interlocutores |
| Google Takeout | Um arquivo completo da caixa de entrada | Um arquivo compactado, não uma lista |
| Apps Script | Endereços de uma busca específica | Uma tarde, e vai expirar |
| Um complemento | O mesmo, sem a tarde | Níveis gratuitos têm limite |
Percorra essa tabela em ordem. A maior parte de quem chega a essa pergunta procura a primeira linha e nunca ouviu falar dela.
1. Outros contatos — a resposta gratuita que quase ninguém acha
Se você já escreveu para alguém e nunca salvou essa pessoa, o Google provavelmente já salvou por você. O Google Contatos chama isso de Outros contatos, e é a rota mais rápida por larga margem.
- Acesse
contacts.google.com - Na barra lateral esquerda, clique em Outros contatos
A descrição do próprio Google: "If you email someone but you haven't added them as a contact, Google Contacts automatically saves their email address in your 'Other contacts' group."
Duas coisas que ninguém menciona.
Só existe no computador. O Google afirma claramente que em iPhone, iPad ou Android você não verá Outros contatos.
E pode estar desativado — em dois lugares distintos. Na sua Conta do Google, em Pessoas e compartilhamento → Contatos → Informações de contato salvas de interações, e no Gmail, em Configurações → Criar contatos para preenchimento automático, onde uma das opções é "Eu mesmo adicionarei os contatos."
Se Outros contatos está vazio, o motivo é uma dessas configurações. Vale conferir antes de concluir que o recurso está quebrado.
O problema é que Outros contatos é tudo, em uma pilha indiferenciada. Não há filtragem, nem intervalo de datas, nem "só as pessoas deste marcador". Se você quer alguns dos seus interlocutores em vez de todos, continue lendo.
2. Exportar seus contatos para CSV
Uma vez que as pessoas que você quer estejam de fato no Contatos:
- Acesse
contacts.google.com - Marque os contatos desejados. Para todos, marque qualquer contato e depois, no topo à esquerda, Ações de seleção → Todos
- No topo à direita, Mais ações → Exportar
- Escolha Google CSV
- Clique em Exportar
Esse CSV abre direto no Google Planilhas ou no Excel.
A limitação é real, e é a mesma de antes. Isso exporta registros de contatos. Não faz ideia do que está no seu e-mail, então não consegue responder "todo mundo para quem escrevi sob label:clientes nos últimos seis meses". Contatos e Gmail são produtos separados que por acaso compartilham uma conta.
3. Google Takeout — a rota que parece certa e não é
O Takeout, em takeout.google.com, exporta o Gmail em três etapas: Selecionar dados → Personalizar arquivo → Receber arquivo. O que volta é conteúdo de mensagens, cabeçalhos e anexos — a caixa de entrada inteira, em um formato de arquivo de e-mail feito para importar em outro cliente.
É um backup genuinamente bom. É uma lista de endereços ruim:
- Sem estrutura de colunas. Não é uma planilha e não vira uma. Tirar endereços de lá significa fazer o parsing do arquivo você mesmo.
- Sem remoção de duplicatas. Um contato que aparece em 40 conversas aparece 40 vezes.
- Sem delimitação real. Você pode escolher quais marcadores incluir, mas não "só os últimos seis meses" ou "só deste remetente".
- Não é imediato. O Google observa que a exportação "could take from a few minutes to a few days" dependendo do tamanho da conta. Mensagens criptografadas continuam criptografadas.
O Takeout é a ferramenta certa para fazer backup ou migrar uma caixa de entrada. É a ferramenta errada para montar uma lista.
4. Apps Script — controle total, e uma parede de seis minutos
Esta é a rota "faça você mesmo", e a primeira que de fato corresponde à tarefa. O serviço Gmail no Apps Script te dá tudo de que você precisa: pesquisar seus e-mails, percorrer as conversas correspondentes, ler os campos From, To e Cc de cada mensagem, escrever os resultados em uma planilha.
A delimitação acontece na string de busca — e a mesma string funciona na caixa de busca do Gmail, no Apps Script e na Gmail API, então você aprende uma vez só:
label:clientes newer_than:6m has:attachment
Os operadores que vale conhecer
| Operador | O que faz | Exemplo |
|---|---|---|
label: | Restringe a um marcador do Gmail | label:clientes |
from: | Um remetente, ou um domínio inteiro | from:@acme.com |
to: | Mensagens enviadas a um endereço | to:vendas@suaempresa.com |
cc: | Mensagens em que um endereço estava em cópia | cc:me |
newer_than: | Recência relativa | newer_than:6m |
older_than: | Tudo antes de um ponto | older_than:2y |
after: / before: | Limites de data absolutos | after:2026/01/01 |
has:attachment | Só mensagens com arquivos anexados | has:attachment |
list: | Um endereço de lista de distribuição | -list:news@example.com |
category: | Uma das categorias da caixa de entrada | category:primary |
list: é o subestimado. Com um menos na frente, é a forma limpa de descartar uma newsletter que você fica coletando sem querer.
Combine à vontade. label:conferencia-2026 newer_than:3m has:attachment é uma lista real e útil. in:anywhere não é — arrasta Spam e Lixeira junto.
Confira a contagem de resultados no Gmail antes de escrever uma linha de código. Se a consulta devolve 4.000 conversas, está frouxa, e a planilha será ruído por melhor que seja o script.
Três coisas vão te morder
- Os campos de endereço são strings, não arrays.
getTo()egetCc()devolvem uma única string separada por vírgulas, e cada valor chega como"Nome Exibido" <addr@example.com>. Você vai dividir, aparar e fazer parsing antes de ter algo utilizável. - Seis minutos. O Apps Script mata qualquer execução isolada em seis minutos. Uma caixa de entrada grande precisa de lotes com cursor armazenado e acionador por tempo — que é a maior parte da tarde que essa rota custa.
- Cotas diárias de leitura. 20.000 em uma conta pessoal do Gmail, 50.000 no Google Workspace.
Nada disso é impeditivo. São os motivos de essa rota levar uma tarde em vez de dez minutos.
Onde o Contact Extractor se encaixa
O Contact Extractor é a rota quatro sem a tarde. Ele roda como complemento em Apps Script dentro da sua própria conta Google, aceita a mesma sintaxe de busca do Gmail e escreve os resultados em uma planilha, sem duplicatas.
Ele existe por causa da lacuna específica que esta página descreve: o Takeout te entrega um arquivo compactado, e o Contatos não enxerga seus e-mails. Essa lacuna é o produto inteiro.
Etapa 1: teste a consulta no Gmail
Monte a busca primeiro no Gmail, onde você vê os resultados antes de se comprometer com qualquer coisa, exatamente como acima.
Etapa 2: abra o complemento na planilha de destino
Crie ou abra a planilha do Google em que a lista deve aterrissar:
Extensões → Contact Extractor by 8apps → Open App
Etapa 3: recrie a busca como filtros
Informe o mesmo escopo que você acabou de testar — marcador do Gmail, De, Para, Assunto, datas de início/fim, além de operadores avançados em Advanced Options.
Uma consulta compatível com o Gmail é montada enquanto você digita, e o Verify a abre no Gmail para você confirmar que está olhando o mesmo conjunto de mensagens que testou. É a etapa que pega um erro antes de ele virar uma planilha de 4.000 linhas.
Etapa 4: escolha de quais campos ler
Em vez de despejar mensagens inteiras, você escolhe quais partes de cada mensagem ler. Cada correspondência devolve o endereço de e-mail e o nome associado a ele:
| Campo | Use quando |
|---|---|
| De | Você quer as pessoas que escreveram para você |
| Para | Você quer as pessoas a quem uma mensagem foi endereçada |
| Cc | Você quer todo mundo incluído numa conversa — muitas vezes a rede útil mais ampla |
| Cco | Você está percorrendo seus próprios e-mails enviados |
| Responder a | Remetentes direcionam respostas a um endereço diferente do de envio |
| Linha de assunto | Endereços aparecem em assuntos, por exemplo em consultas encaminhadas |
| Corpo da mensagem | Endereços estão escritos em assinaturas ou dentro do texto |
Comece estreito. De e Cc cobrem a maioria dos casos reais. Acrescentar Corpo da mensagem amplia bastante a captura, mas também traz todo endereço no-reply escrito num rodapé.
Etapa 5: exclua o seu próprio domínio
Coloque o seu domínio no campo Exclude domains — apenas suaempresa.com, não um endereço completo. Sem isso, boa parte da maioria das exportações são os seus próprios colegas.
Etapa 6: salve e extraia
Os endereços são escritos na planilha, sem duplicatas conforme entram. Quem aparece em 40 conversas aparece uma vez.
Se o conjunto de mensagens continua crescendo — um marcador ativo, um alias compartilhado, uma campanha em andamento —, configure a tarefa para rodar de hora em hora e a planilha se mantém atual sozinha.
Limpando a planilha
Seja qual for a rota, uma passagem de limpeza vale a pena:
- Filtre endereços no-reply.
=FILTER(A2:A, NOT(REGEXMATCH(A2:A, "(?i)no-?reply|donotreply"))) - Agrupe por domínio para ver quais empresas estão realmente representadas:
=ARRAYFORMULA(IFERROR(REGEXEXTRACT(A2:A, "@(.*)$"))) - Confira duplicatas de novo se você combinou várias exportações:
=UNIQUE(A2:A)
Antes de escrever para qualquer um deles
Extrair endereços da sua própria caixa de entrada é um exercício de registros. Enviar e-mails para essa lista é um ato de marketing, e só o segundo é regulado.
As diretrizes do Google para remetentes são diretas: "Don't send messages to people who didn't sign up to get messages from you" e "Don't purchase email addresses from other companies."
A FTC é igualmente clara de que não há exceção para business-to-business — "The law makes no exception for business-to-business email" — e lista a coleta automatizada de endereços entre as violações agravadas da CAN-SPAM.
Na prática: fique com as pessoas com quem você de fato se correspondeu. Descarte correspondências de list:, remetentes no-reply e endereços que só apareceram numa cadeia de cópias. Uma lista construída a partir de correspondência real é mais defensável e consideravelmente mais propensa a receber resposta.
Uma nota sobre permissões
Qualquer ferramenta que leia o seu Gmail vai pedir acesso ao Gmail pela própria tela de consentimento do Google, e você deveria ler o que ela pede. Duas coisas para conferir em qualquer coisa que instalar:
- Ela processa seus e-mails dentro da sua conta Google ou envia para um servidor de terceiros?
- Passou pela revisão de segurança do Google?
O Contact Extractor roda como complemento em Apps Script dentro da sua própria conta Google, escreve apenas na planilha que você escolher e é certificado CASA 2. Ele lê as mensagens que os seus filtros selecionam, e apenas os campos que você escolhe — extraindo os endereços de e-mail e nomes que encontra ali, e nada mais.
Qual rota você deve usar?
| Você quer… | Use |
|---|---|
| Todo mundo para quem você já escreveu, sem filtragem | Outros contatos |
| Um CSV de contatos que você já salvou | Google Contatos → Exportar |
| Fazer backup ou migrar uma caixa de entrada inteira | Google Takeout |
| Endereços de uma busca específica, e você programa | Apps Script |
| Endereços de uma busca específica, e você não programa | Um complemento |
| Três endereços de uma conversa | Copiar e colar, honestamente |
A última linha importa. Nem toda tarefa precisa de uma ferramenta.
Fontes
- Exportar contatos – Ajuda do Google Contatos
- Adicionar ou mover contatos / Outros contatos – Ajuda do Google Contatos
- Mudar quem é salvo e sugerido como contato – Ajuda do Google Contatos
- Fazer o download dos seus dados do Google e Fazer o download dos dados do Gmail
- Operadores de pesquisa que você pode usar no Gmail
- Apps Script – GmailMessage reference e Quotas for Google Services
- Diretrizes para remetentes de e-mail – Ajuda do Gmail
- CAN-SPAM Act compliance guide – FTC