Como Exportar Endereços de E-mail do Gmail para uma Planilha (4 Formas)

Equipe 8apps·

O Gmail não tem botão para exportar endereços. Estas são as quatro rotas que funcionam – Outros contatos, exportação do Contatos, Takeout e Apps Script.

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.

RotaBoa paraCusta a você
Outros contatosTodo mundo para quem você já escreveuTrês cliques, mas nenhuma filtragem
Exportação do ContatosUm CSV limpo de contatos salvosSó contatos, não interlocutores
Google TakeoutUm arquivo completo da caixa de entradaUm arquivo compactado, não uma lista
Apps ScriptEndereços de uma busca específicaUma tarde, e vai expirar
Um complementoO mesmo, sem a tardeNí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.

  1. Acesse contacts.google.com
  2. 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:

  1. Acesse contacts.google.com
  2. Marque os contatos desejados. Para todos, marque qualquer contato e depois, no topo à esquerda, Ações de seleção → Todos
  3. No topo à direita, Mais ações → Exportar
  4. Escolha Google CSV
  5. 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

OperadorO que fazExemplo
label:Restringe a um marcador do Gmaillabel:clientes
from:Um remetente, ou um domínio inteirofrom:@acme.com
to:Mensagens enviadas a um endereçoto:vendas@suaempresa.com
cc:Mensagens em que um endereço estava em cópiacc:me
newer_than:Recência relativanewer_than:6m
older_than:Tudo antes de um pontoolder_than:2y
after: / before:Limites de data absolutosafter:2026/01/01
has:attachmentSó mensagens com arquivos anexadoshas:attachment
list:Um endereço de lista de distribuição-list:news@example.com
category:Uma das categorias da caixa de entradacategory: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() e getCc() 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:

CampoUse quando
DeVocê quer as pessoas que escreveram para você
ParaVocê quer as pessoas a quem uma mensagem foi endereçada
CcVocê quer todo mundo incluído numa conversa — muitas vezes a rede útil mais ampla
CcoVocê está percorrendo seus próprios e-mails enviados
Responder aRemetentes direcionam respostas a um endereço diferente do de envio
Linha de assuntoEndereços aparecem em assuntos, por exemplo em consultas encaminhadas
Corpo da mensagemEndereç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:

  1. Ela processa seus e-mails dentro da sua conta Google ou envia para um servidor de terceiros?
  2. 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 filtragemOutros contatos
Um CSV de contatos que você já salvouGoogle Contatos → Exportar
Fazer backup ou migrar uma caixa de entrada inteiraGoogle Takeout
Endereços de uma busca específica, e você programaApps Script
Endereços de uma busca específica, e você não programaUm complemento
Três endereços de uma conversaCopiar e colar, honestamente

A última linha importa. Nem toda tarefa precisa de uma ferramenta.


Fontes


Leitura relacionada