Importar contatos por CSV
O assistente de importação carrega uma planilha de contatos para o cadastro da organização e, opcionalmente, para uma lista de e-mail. Ele abre pelo botão Importar CSV, em Contatos — um controle que aparece somente para administradores.
São quatro etapas, e você só avança quando a etapa atual está completa. A qualquer momento dá para voltar com Voltar, sem perder o que já foi preenchido.
Etapa 1 — Enviar o arquivo e mapear as colunas
Section titled “Etapa 1 — Enviar o arquivo e mapear as colunas”Escolha o arquivo em Arquivo CSV. Assim que ele carrega, o assistente lê o cabeçalho e monta três seletores, um para cada coluna que ele sabe usar:
- Coluna de e-mail
- Coluna de telefone
- Coluna de nome
Cada um aceita “Sem coluna de …” quando o arquivo não tem aquele dado. Mapeie ao menos uma das duas colunas de identificação: e-mail ou telefone — sem nenhuma das duas o botão Continuar fica desabilitado, porque não haveria como saber de quem é a linha.
O nome é sempre opcional: ele enriquece o cadastro, mas não identifica ninguém.
Etapa 2 — Destino e consentimento
Section titled “Etapa 2 — Destino e consentimento”Lista de destino (opcional) escolhe para onde os contatos vão além do cadastro. Administradores podem criar uma lista sem sair do assistente, pelo botão de criação ao lado do seletor.
Ao escolher uma lista, o campo Origem do consentimento passa a ser obrigatório. As opções são:
| Origem | Quando usar |
|---|---|
| Cadastro próprio (site, formulário ou app) | A pessoa se inscreveu em algo seu |
| Evento presencial ou webinar | O contato veio de uma inscrição ou lista de presença |
| Migração de outra plataforma | A base estava em outro serviço de e-mail ou CRM |
| Lista comprada | O arquivo foi adquirido de terceiros |
| Não sei a origem | Não há registro de como o contato entrou |
| Outro | Descreva a origem no campo que aparece |
Lista comprada e Não sei a origem exibem o aviso “Esta origem pode exigir revisão de conformidade.” O assistente não bloqueia a importação: ele registra a origem junto do lote, para que a decisão fique documentada e auditável depois.
Etapa 3 — Revisar
Section titled “Etapa 3 — Revisar”A tela de revisão resume o que vai acontecer: o nome do arquivo, o tamanho da amostra lida, a lista de destino escolhida (ou o aviso de que não há uma) e a origem do consentimento. Confira e confirme em Importar.
Durante a importação, uma linha de progresso mostra quantas linhas já foram processadas do total do arquivo. Arquivos grandes sobem em blocos, e a espera passa de segundos a minutos — o contador é o que separa “ainda trabalhando” de “travou”.
Etapa 4 — Relatório
Section titled “Etapa 4 — Relatório”O relatório fecha o assistente com duas contagens — aceitos e rejeitados — e, abaixo, uma linha por recusa, dizendo o número da linha no arquivo, o contato e o motivo.
Os motivos de recusa
Section titled “Os motivos de recusa”| Motivo | O que aconteceu |
|---|---|
| A linha não tem e-mail | A coluna de e-mail foi mapeada, mas a célula está vazia |
| A linha não tem e-mail nem telefone | Nenhuma identificação utilizável na linha |
| O e-mail não é um endereço válido | A sintaxe do endereço está errada |
| Este e-mail aparece mais de uma vez no arquivo | Duplicata dentro do próprio CSV; a primeira ocorrência entrou |
| O domínio deste e-mail não recebe mensagens | O domínio não publica servidor de e-mail |
| Este endereço está na lista de supressão da organização | Houve devolução permanente ou marcação de spam |
| Esta pessoa se descadastrou da lista | Só volta pelo centro de preferências, nunca por importação |
| O telefone já pertence a outro contato | O número da planilha é de outra pessoa no cadastro |
| Este contato já tem outro telefone cadastrado | A pessoa foi encontrada pelo e-mail e tem número diferente |
| O telefone informado pertence a um contato que já tem outro e-mail | A pessoa foi encontrada pelo telefone e tem outro endereço |
Os três últimos são conflitos de identidade, e o assistente recusa a linha de propósito. Trocar o telefone de alguém é mudar para onde as mensagens dela vão; decidir se duas fichas são a mesma pessoa é trabalho de gente, não de importação. Resolva pela ficha do contato, em Contatos, e reimporte depois se ainda fizer sentido.
Os motivos de descadastro e de supressão também valem para quem teve os dados excluídos do SquadOS: a proteção contra novos envios é mantida depois da exclusão, e importar a pessoa de novo não a remove.
Depois da importação
Section titled “Depois da importação”Contatos que entraram em uma lista disparam o gatilho “Contato adicionado à lista”, então automações ligadas a essa lista começam a rodar. Se você vai importar uma base grande em uma lista que já tem automação ativa, confira antes o que está armado em Automações.
Para colocar contatos na lista a partir de um sistema externo — formulário, checkout, CRM — em vez de por arquivo, use os endpoints de Listas de Contatos.