Importação em massa (CSV)
Para começar com a base cheia, você sobe um arquivo CSV num assistente de 3 passos: upload → pré-visualização → resultado. As colunas são mapeadas automaticamente e cada linha é validada antes de entrar.
Onde fica
Botão “Importar” no topo da lista de Contatos, que abre o assistente de importação. Exige a permissão Assinantes → Editar.
O assistente, passo a passo
- Upload. Arraste o arquivo
.csvpara a área indicada (ou clique para selecionar). Só arquivos.csvsão aceitos. Se não tiver um pronto, clique em “Baixar modelo CSV”: o sistema gera ummodelo-assinantes.csvcom o cabeçalho e duas linhas de exemplo. - Pré-visualização. A tela mostra o arquivo e quantas linhas encontrou, o mapeamento de colunas detectado, um resumo de Válidos (verde) × Com erros (vermelho) e uma amostra das 5 primeiras linhas com a coluna Validação. Confira tudo antes de confirmar.
- Resultado. Clique em “Importar {N} assinantes” e a tela final mostra “{importados} de {total} assinantes importados”. Se houve erros, eles vêm listados linha a linha; se houve linhas puladas por telefone duplicado, a tela mostra quantas e lista as primeiras 20, com o telefone e o motivo. Dali você pode “Importar outro arquivo” ou “Ver contatos”.
Colunas do arquivo
Cabeçalho na primeira linha. As colunas reconhecidas (o mapeamento não diferencia maiúsculas de minúsculas):
| Coluna | Obrigatória | Também aceita | Observações |
|---|---|---|---|
nome | Sim | name | Nome do contato |
telefone | Sim | phone | Número de contato |
plano | Não | plan | Nome do plano |
endereco | Não | endereço, address | Endereço |
status | Não | connection_status | online, offline ou degraded |
id_externo | Não | external_id, externalid | ID no ERP do provedor (IXC, Hubsoft, MK-Auth, SGP etc.) |
O mapeamento aparece na pré-visualização como etiquetas {coluna do CSV} → {campo}. Colunas que o sistema não reconhece são simplesmente ignoradas; nada é importado às cegas.
Validação de cada linha
Uma linha é marcada como inválida, e não é importada, quando:
- “Nome é obrigatório”: o campo veio em branco
- “Telefone é obrigatório”: o campo veio em branco
- “Status inválido: X”: o status não é
online,offlinenemdegraded
Linhas inválidas não bloqueiam as demais: as válidas entram normalmente e você recebe a lista dos erros no fim. Corrija e reimporte só as que falharam, se quiser.
Telefone duplicado é pulado, não é erro
Além da validação acima, o servidor compara cada telefone (já normalizado, então grafias diferentes do mesmo número são reconhecidas) contra os contatos que a sua organização já tem e contra as próprias linhas do arquivo. Quando bate:
- “Telefone já cadastrado nesta organização”: já existe um contato com esse número.
- “Telefone repetido dentro do próprio arquivo”: duas linhas do CSV têm o mesmo número; só a primeira é considerada.
A linha pulada não conta como erro nem impede o restante do arquivo: ela some da contagem de “importados” e aparece separada no resultado, como linha ignorada por duplicidade.
A validação final (erros e duplicidade) é a do servidor. A pré-visualização usa as 5 primeiras linhas como amostra e só confere nome/telefone/status; ela não sabe antecipar duplicidade. Uma linha que aparece como “Válida” na pré-visualização ainda pode ser pulada no resultado se o telefone já existir.
Alternativa: sincronizar pelo ERP
Se você usa um ERP integrado (IXC, SGP ou outro suportado), não precisa de CSV: ao conectar a integração, a base chega sincronizada e o topo de Contatos diz de qual ERP vêm os dados e quando foi a última sincronização. Nesse cenário o ERP é a fonte da verdade: prefira ajustar os dados lá.
Veja também
- Contatos: a lista onde os contatos importados aparecem
- Ficha do contato: cadastrar e editar um contato por vez
- IXC (ERP do provedor): sincronização automática
- Primeiro acesso e onboarding: montando sua operação do zero