Pular para o conteúdo

Importar contatos de uma planilha

Traga até 5.000 contatos de uma vez com uma planilha CSV, confira as linhas recusadas e reimporte só o que precisou de correção.

Intermediário5 min de leituraAtualizado em 13 de novembro de 2026

A importação de contatos cria vários cadastros de uma vez a partir de uma planilha no formato CSV. É o caminho mais rápido para trazer os clientes de outro sistema ou de uma planilha do escritório. Cada linha vira um contato com nome, tipo de pessoa, perfil, CPF ou CNPJ, um e-mail e um telefone; os demais dados você completa depois, na edição de cada contato.

Onde fica

No menu lateral, Contatos › botão Adicionar › Importar planilha. Com a lista de contatos vazia, o botão Importar planilha também aparece no centro da página.

Preparar a planilha

A primeira linha da planilha precisa ter o cabeçalho com os nomes das colunas. Só a coluna nome é obrigatória; as outras podem ficar de fora ou em branco.

ColunaO que informarExemplo
nomeNome da pessoa ou razão social (obrigatório em todas as linhas)Maria Souza
tipoPF ou PJPF
clientesim ou nãosim
cpf_cnpjCPF ou CNPJ, com ou sem pontuação123.456.789-09
emailUm e-mailmaria@exemplo.com.br
telefoneUm telefone(11) 98888-7777

Para começar do jeito certo, clique em Baixar planilha modelo na janela de importação. O arquivo modelo-contatos.csv já vem com o cabeçalho e duas linhas de exemplo, uma de pessoa física e outra de pessoa jurídica.

Como o Orvya lê a planilha:

  • O separador pode ser vírgula ou ponto e vírgula; o Orvya descobre qual foi usado pela linha do cabeçalho. Planilhas salvas pelo Excel no formato CSV funcionam.
  • Os acentos são lidos em arquivos salvos em UTF-8 e também no formato padrão do Excel em português.
  • Os nomes das colunas não diferenciam maiúsculas, minúsculas nem acentos.
  • Em tipo, "PJ", "jurídica" ou "empresa" criam uma pessoa jurídica, assim como um documento com 14 dígitos. Nos demais casos, o contato é pessoa física.
  • Em cliente, "sim", "s", "x", "1", "true" ou "cliente" definem o perfil Cliente. Qualquer outro valor, ou a célula vazia, define Contato.
  • O e-mail entra com o tipo Comercial e o telefone, com o tipo Celular comercial. Você pode mudar os tipos depois, na edição do contato.
  • Nomes com mais de 200 caracteres são cortados. As maiúsculas dos nomes recebem o mesmo ajuste do cadastro manual.
  • Um texto entre aspas pode ter vírgulas e quebras de linha sem virar outra coluna ou outro contato.

Importar

  1. Na janela Importar planilha de contatos, arraste o arquivo .csv para a área tracejada ou clique em Enviar planilha para escolher no computador.
  2. Confira o nome do arquivo, que aparece acima da área. Para trocar, remova-o pelo ícone de lixeira e escolha outro.
  3. Clique em Importar. O botão só fica disponível depois que você escolhe o arquivo.
  4. Aguarde o aviso com o resultado. A janela passa a mostrar quantos contatos foram importados.

Cada importação aceita até 5.000 contatos e um arquivo de até 5 MB. Para listas maiores, divida a planilha em partes e importe uma de cada vez.

Corrigir as linhas recusadas

Uma linha com erro não impede as outras: o Orvya importa as linhas válidas e lista as recusadas, com o número da linha na planilha e o motivo.

  • Nome obrigatório: a célula do nome está vazia.
  • CPF/CNPJ inválido: o documento não tem 11 ou 14 dígitos, ou os dígitos verificadores não conferem.
  • E-mail inválido: o e-mail não tem um formato válido.

Para corrigir sem repetir o que já entrou:

  1. Na janela de resultado, corrija as linhas no campo Corrigir linhas rejeitadas (CSV). Ele traz o cabeçalho e só as linhas recusadas.
  2. Se preferir corrigir no seu programa de planilhas, clique em Baixar linhas rejeitadas, ajuste o arquivo contatos-rejeitados.csv e cole o conteúdo corrigido de volta no campo.
  3. Clique em Reimportar somente rejeitados. Os contatos já importados continuam salvos e não são enviados de novo.
  4. Quando terminar, clique em Concluir.

Se algo der errado

"contatos.xlsx: formato não permitido."

(o nome varia) O arquivo está no formato do Excel. No Excel, salve a planilha no formato CSV e escolha o novo arquivo.

A planilha inteira foi recusada

, sem nenhum contato importado. O aviso diz o motivo:

  • "Cabeçalho inválido. Use: nome,tipo,cliente,cpf_cnpj,email,telefone": a primeira linha não tem os nomes das colunas. Copie o cabeçalho da planilha modelo.
  • "A planilha está vazia.": não há nenhuma linha de contato abaixo do cabeçalho.
  • "Importe no máximo 5.000 contatos por vez.": divida a planilha em partes.
  • "Campo entre aspas não foi fechado (linha 12)." (o número varia): feche as aspas da linha indicada.
"O arquivo excede o tamanho máximo permitido."

O arquivo passa de 5 MB. Divida a planilha em partes menores.

"Nenhum contato foi importado. 3 linha(s) rejeitada(s)."

(o número varia) Todas as linhas têm erro. Veja os motivos listados na janela e corrija as linhas.

"10 contato(s) importado(s). 2 linha(s) não importada(s)."

(os números variam) Parte da planilha entrou. Corrija as linhas listadas e use Reimportar somente rejeitados.

Todos os contatos entraram como pessoa física.

A coluna tipo está ausente ou com outro nome. Use PF ou PJ nessa coluna, ou ajuste o tipo depois, na edição de cada contato.

Continue em Contatos

Ainda com dúvida?

Conte o que aconteceu e, se puder, o endereço da tela. A equipe responde por suporte@orvya.net.