blog
Painéis

Agenda e contatos do webmail para o Google: .ics e .vcf

Como exportar agenda e contatos do webmail da sua hospedagem, conferir se os compromissos que se repetem vieram junto e importar tudo no Google sem usar terminal.

JR · · 7 min de leitura · 2 tabelas

Resposta curta: A agenda e os contatos saem do webmail em dois arquivos: um `.ics` com a agenda e um `.vcf` com os contatos. Você exporta os dois dentro do webmail da hospedagem, confere o conteúdo num editor de texto simples e importa no Google Agenda e no Google Contatos, tudo por telas clicáveis, sem usar terminal.

Neste artigo
  1. O que o e-mail da sua hospedagem guarda além das mensagens
  2. O que são os arquivos .ics e .vcf e para onde cada um vai
  3. O que ter em mãos antes de exportar
  4. Exportando a agenda e os contatos do webmail
  5. Conferindo o arquivo antes de importar
  6. Importando no Google Agenda e no Gmail
  7. Os erros que mais aparecem e como resolver
  8. O que não apagar depois que a importação funcionou

O que o e-mail da sua hospedagem guarda além das mensagens

Quando você contrata uma hospedagem, costuma vir junto um e-mail com o seu domínio (o endereço do seu site, como suaempresa.com.br). Para ler esse e-mail sem instalar nada, existe o webmail: uma tela de e-mail que abre dentro do navegador, como o Gmail abre, só que hospedada no mesmo servidor do seu site. Servidor é o computador que fica sempre ligado, numa sala refrigerada, guardando os arquivos do seu site e as suas mensagens de e-mail.

Dentro do webmail, além das mensagens, costumam existir dois cadernos:

Pense assim: o webmail é a mesa. A agenda é o caderno de compromissos em cima dela. Os contatos são a caderneta de endereços ao lado. Quando você decide usar o Google Agenda e o Gmail no dia a dia, precisa copiar esses dois cadernos para lá. Não existe mágica: você gera um arquivo com o conteúdo e sobe esse arquivo no Google.

O que são os arquivos .ics e .vcf e para onde cada um vai

São dois formatos antigos, abertos e entendidos por praticamente todo programa de agenda e de contatos.

Arquivo Serve para Analogia Para onde vai
.ics Agenda: eventos, horários, repetições Cópia do caderno de compromissos Google Agenda
.vcf Contatos: nome, telefone, e-mail Cópia da caderneta de endereços Google Contatos (que aparece no Gmail)

O .vcf também é chamado de vCard, que é só o nome bonito do cartão de visita digital. Um arquivo .vcf pode ter um contato só ou a lista inteira dentro dele.

Os dois são arquivos de texto. Se você abrir num editor simples, vai ver palavras legíveis como BEGIN:VEVENT e SUMMARY. Isso é útil na hora de conferir, e é a conferência que a maioria das pessoas pula.

O que ter em mãos antes de exportar

Reserve vinte minutos. Faça num horário em que você possa conferir o resultado com calma, não cinco minutos antes de uma reunião.

Exportando a agenda e os contatos do webmail

Entrar no webmail com o e-mail completo e a senha da caixa

Abra o navegador, digite o endereço do webmail, preencha o e-mail completo e a senha. O esperado é cair numa tela com a caixa de entrada e, em algum canto, ícones ou abas de Agenda e Contatos.

Exportar todos os contatos de uma vez

Abra a seção de Contatos (ou "Catálogo de endereços"). Procure o botão Exportar. Normalmente há duas opções: exportar todos os contatos ou só os selecionados. Escolha todos.

O esperado: o navegador baixa um arquivo terminado em .vcf. Guarde numa pasta que você ache depois, como a Área de Trabalho.

Exportar a agenda, um calendário por arquivo

Abra a seção de Agenda (ou "Calendário"). Procure Exportar. Se o webmail perguntar qual calendário, escolha o seu calendário pessoal; se houver mais de um, exporte um de cada vez e dê nomes diferentes aos arquivos.

O esperado: um arquivo terminado em .ics na pasta de downloads.

Quando o webmail não tem botão de exportar

Alguns webmails antigos não oferecem o botão. No caso específico do Horde dentro do cPanel, existe um script de servidor documentado pela cPanel, o export_horde_calendars_to_ics, que gera os arquivos .ics dos calendários do Horde a partir do servidor (documentação oficial da cPanel).

Isso não é tarefa sua. Esse script roda no servidor, por quem administra a máquina. Se o seu webmail não tem o botão de exportar, abra um chamado com o seu provedor pedindo a exportação dos calendários do Horde em .ics. Cite o nome do script: isso economiza meia dúzia de mensagens de ida e volta.

Do webmail até os arquivos salvosEntrar no webmailE-mail completo e senhaExportar contatosGera arquivo .vcfExportar agendaGera arquivo .icsGuardar os arquivosPasta fácil de achar
Cada exportação gera um arquivo separado: contatos no .vcf, agenda no .ics.

Conferindo o arquivo antes de importar

Este é o passo que evita dor de cabeça. Você vai olhar o arquivo por dentro, sem terminal e sem programa novo.

Como abrir um .ics ou .vcf no Bloco de Notas

Clique com o botão direito no arquivo .ics, escolha "Abrir com" e selecione o Bloco de Notas (Windows) ou o TextEdit (Mac). Vai aparecer texto. Não se assuste, você não precisa entender tudo.

As quatro palavras que dizem se a exportação veio completa

No arquivo .vcf, procure por BEGIN:VCARD. Cada ocorrência é um contato. Se você tinha cerca de duzentos contatos e encontra dez, exportou só uma parte.

Conferindo o arquivo antes de importarAbrir no Bloco de NotasBotão direito, Abrir comArquivo tem conteúdo?Poucas linhas indica exportação vaziaProcurar BEGIN:VEVENTCada ocorrência é um compromissoProcurar RRULEMarca os eventos que repetemProcurar TZID ou ZIndica o fuso horárioSó então importar no GoogleComece por uma agenda nova
Conferência do .ics antes de importar, sem terminal e sem programa novo.

Importando no Google Agenda e no Gmail

Importar o .ics no Google Agenda

  1. Abra o Google Agenda no computador.
  2. Clique na engrenagem, depois em Configurações.
  3. No menu da esquerda, clique em Importar e exportar.
  4. Selecione o arquivo .ics, escolha em qual agenda os eventos vão entrar e clique em Importar.

O esperado: uma mensagem dizendo quantos eventos foram importados. Anote esse número.

Importar o .vcf no Google Contatos

  1. Abra o Google Contatos (pelo menu de aplicativos do Google, ou pelo endereço contacts.google.com).
  2. No menu da esquerda, clique em Importar.
  3. Selecione o arquivo .vcf e confirme.

O esperado: os contatos aparecem agrupados num rótulo com a data da importação. Esse rótulo é útil: se algo der errado, dá para selecionar o grupo inteiro e apagar.

Os erros que mais aparecem e como resolver

Sintoma Causa provável O que fazer
Arquivo exportado vazio ou com poucas linhas Calendário errado selecionado, ou agenda estava em outro módulo do webmail Repetir a exportação escolhendo cada calendário disponível, um por um
Todo evento aparece duas vezes no Google O mesmo .ics foi importado duas vezes, ou a conta do webmail ainda está sincronizada com o Google Apagar a agenda duplicada criada na importação e importar uma vez só, com a sincronização antiga desligada
Aniversários e compromissos com uma hora (ou um dia) de diferença Fuso horário do webmail diferente do fuso da conta Google Depende do arquivo: se não houver TZID no .ics, ajustar o fuso em Configurações do Google Agenda para Brasília e refazer a importação; se houver TZID, o horário já vem travado pelo arquivo, então conferir o fuso configurado no webmail e exportar de novo
Reunião semanal virou um evento único O arquivo não trouxe a linha de repetição Verificar se há RRULE no .ics; se não houver, recriar a repetição manualmente no Google
Contatos chegaram com nomes estranhos ou acentos quebrados Codificação de caracteres (a tabela que o computador usa para transformar letras em números) do arquivo exportado Exportar de novo escolhendo, se o webmail permitir, a opção UTF-8 (o padrão de codificação que faz acentos e cedilha aparecerem certos)

Uma recomendação que não ajuda a vender nada: importe primeiro numa agenda nova e separada, não na sua agenda principal. No Google Agenda, crie uma agenda chamada "Importado" e mande os eventos para lá. Se vier duplicado ou com horário errado, você apaga a agenda inteira em dois cliques e tenta de novo. Se misturar com a agenda principal, a limpeza é evento por evento.

O que não apagar depois que a importação funcionou

Mantenha os arquivos .ics e .vcf guardados por pelo menos um mês. Eles são a sua cópia de segurança. Não apague a conta de e-mail da hospedagem no mesmo dia: passe alguns dias usando o Google e confira se nada ficou para trás, principalmente compromissos distantes, como uma renovação anual ou um aniversário de dezembro.

Vale ainda lembrar de uma separação que confunde muita gente: levar a agenda e os contatos para o Google não leva as mensagens de e-mail junto, e não muda para onde seu e-mail chega. O endereço continua sendo entregue no servidor da hospedagem, a menos que você mude a configuração de entrega de e-mail do domínio, que é outra tarefa, com outros riscos.

Se em algum ponto o botão de exportar simplesmente não existir no seu webmail, pare e fale com quem hospeda o seu site. É um pedido legítimo, documentado pelo fabricante do painel, e bem mais rápido do que copiar trezentos contatos na mão.

Referências

  1. Documentação oficial (cpanel) — The export_horde_calendars_to_ics Script. Consultado em 2026-10-14.
Leia também