Importação
Para começar rápido, você pode subir sua base de clientes em CSV ou conectar IXC para sincronizar automaticamente.
Opção 1 — Importar CSV
Formato esperado
CSV UTF-8 com cabeçalho na primeira linha. Colunas mínimas:
nome,telefone,email,plano,cpf_cnpj,endereco,tags
"João Silva","+5511999999999","joao@example.com","Conecta 500","123.456.789-00","Rua X 123","vip,fidelidade-12m"
"Maria Souza","+5511888888888","maria@example.com","Conecta 200","",""Colunas suportadas
| Coluna | Obrigatória | Notas |
|---|---|---|
nome | Sim | Nome completo |
telefone | Sim | Formato internacional +55... |
email | Opcional | |
plano | Opcional | Nome exato do plano cadastrado |
cpf_cnpj | Opcional | Sem máscara funciona |
endereco | Opcional | Texto livre |
cidade | Opcional | |
bairro | Opcional | |
cep | Opcional | |
tags | Opcional | CSV interno (ex.: "vip,fidelidade") |
notas | Opcional | Texto livre |
data_contratacao | Opcional | YYYY-MM-DD |
Como importar
Vá em
/assinantes→ Botão Importar CSV.Selecione arquivo (até 10 MB).
Pré-visualize as primeiras 10 linhas — confirme o mapeamento.
Clique em Importar. Processo em background. Status: criados / pulados / erros.
Comportamento com duplicatas
O ConectAI pula silenciosamente os assinantes com telefone já existente — não conta como erro nem cria duplicado.
Para detectar duplicatas: exporte sua base atual antes do import e compare.
Erros comuns
| Erro | Causa | Como resolver |
|---|---|---|
| ”Telefone inválido” | Formato errado | Use +5511... (com + e DDI) |
| “Plano não encontrado” | Nome ≠ cadastrado | Cadastre o plano antes ou use vazio |
| ”CPF inválido” | Caracteres não numéricos extras | Limpe a coluna |
| ”Encoding errado” | CSV em ANSI/Windows-1252 | Salve como UTF-8 |
Opção 2 — Sincronizar com IXC
Se você já usa IXC, conectar o IXC sincroniza tudo automaticamente — não precisa CSV.
Após conectar:
- Sync inicial: pode levar minutos pra horas dependendo do tamanho
- Sync incremental: a cada N minutos (configurado no setup)
- Conflitos: dados do IXC sobrescrevem os do ConectAI (IXC é a fonte da verdade)
Opção 3 — Importar via API
Para integrações próprias:
POST /api/subscribers
Content-Type: application/json
Authorization: Bearer {your-api-key}
{
"name": "João Silva",
"phone": "+5511999999999",
...
}(API keys ainda não estão self-service — fale com seu AM.)
Boas práticas
Sempre faça import inicial em ambiente de teste ou em pequenas batches
Backup antes — exporte sua base atual antes de mudanças grandes
Valide formato com 10 linhas antes de subir 50 mil
Telefone único — duplica = pulada
Use IXC sync se possível — menos manutenção
Não importe dados sensíveis sem necessidade
Não suba CSV não validado
Não importe + tente IXC sync ao mesmo tempo (conflitos)