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 CSV” no topo de /assinantes, que abre /assinantes/importar. Exige a permissão assinantes:edit.
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. Dali você pode “Importar outro arquivo” ou “Ver assinantes”.
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 IXC/MK-Auth/SGP |
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.
A validação final é a do servidor. A pré-visualização usa as 5 primeiras linhas como amostra; ao importar, o arquivo inteiro é revalidado no servidor — é esse resultado que vale.
Alternativa: sincronizar pelo IXC
Se você usa IXC, não precisa de CSV: ao conectar a integração, a base chega sincronizada e o selo “Fonte: IXC” aparece no topo de /assinantes. Nesse cenário o IXC é a fonte da verdade — prefira ajustar os dados lá.
Veja também
- Visão 360 do contato — a lista onde os contatos importados aparecem
- Perfil do contato — cadastrar/editar um contato por vez
- IXC (ERP do provedor) — sincronização automática
- Primeiro acesso e onboarding — montando sua operação do zero