Importar e atualizar contatos por CSV na 6am

Importe um CSV preparado para a empresa correta na 6am, confira cada alteração proposta e verifique os contatos salvos antes de continuar com a lista completa.

• Resultado: Novos contatos criados e atualizações intencionais aplicadas, com as linhas de origem conciliadas com o relatório da importação.
• Ferramentas: Dashboard da 6am e uma planilha privada de origem.
• Responsável: Administrador da empresa ou membro com permissão de gestão de contatos (tenancy: manage contacts).
• Antes de começar: Siga o SOP 082 — Preparar e importar contatos na 6am para limpar a fonte, formatar os identificadores e preparar os campos nativos e personalizados de contato. Este procedimento se concentra na execução e conferência da importação.

01. Confirme a empresa e as alterações pretendidas

1. Entre no dashboard da 6am, selecione a empresa que deve receber os contatos e abra Contatos → Importar contatos. Confira o nome da Empresa acima do formulário. Se Contatos não estiver disponível, peça ao administrador dessa empresa que confira seu acesso.
2. Preserve a fonte original. Em uma cópia privada de trabalho, classifique as linhas como Criar, Atualizar ou Reter, registre os totais esperados e exclua as linhas retidas do CSV. Confirme com o responsável a finalidade e a autorização para usar a lista. Importar não estabelece consentimento de marketing nem envia mensagens.
3. Para cada atualização pretendida, abra os detalhes do registro existente em Contatos. Registre o ID do contato 6am e os valores que serão alterados na cópia privada. Esse ID é um UUID da empresa selecionada; um ID do GHL não o substitui. Se e-mail e telefone forem mudar ao mesmo tempo, use o ID 6am existente para identificar a pessoa.
4. Prepare um pequeno piloto com os casos necessários à sua lista real: um contato novo, uma atualização intencional e uma atualização com campo vazio que deve preservar o valor salvo. Use contatos revisados destinados a essa empresa. Registre quais linhas fazem parte do piloto para excluí-las dos lotes seguintes.

Limites atuais: CSV em UTF-8, separado por vírgula ou ponto e vírgula, com até 2 MB e 500 linhas de contatos por arquivo. Exporte XLSX para CSV antes do envio. A tela de importação não oferece exportação de contatos ou desfazer automático. Contatos oferece Editar para correções individuais e Revisar duplicados para mesclagens confirmadas, conforme o SOP 081. Preserve a fonte e registre manualmente os valores afetados antes de atualizar; o relatório por linha não é uma cópia dos dados dos contatos.

02. Envie o CSV e escolha o modo

1. Em 1. Escolha seu CSV, selecione o arquivo revisado. Corrija erros de codificação, cabeçalho, separador ou limite de linhas antes de continuar.
2. Em 2. Relacione as colunas, confira cada associação sugerida. Confira os sete campos nativos: Nome, Sobrenome, E-mail, Telefone, Empresa, Notas e ID do contato 6am. Selecione Não importar para campos que não pretende alterar. Cada coluna de origem pode ser usada apenas uma vez.
3. Escolha Comportamento da importação de acordo com o resultado pretendido:

As correspondências usam e-mail normalizado, telefone internacional ou ID do contato 6am da empresa, com comparação exata. O nome sozinho não identifica o contato. Identificadores conflitantes são rejeitados. Um ID informado que não exista é rejeitado, sem criar um contato alternativo. Sem ID, um e-mail ou telefone sem correspondência pode criar um registro no modo criar e atualizar.

Campos vazios e não relacionados preservam os valores existentes automaticamente. Não há uma caixa “ignorar valores vazios” para configurar. Um campo preenchido substitui o valor salvo; Notas preenchidas substituem a nota anterior inteira. Importar uma célula vazia não limpa um campo. Use Editar em Contatos para essa operação; limpar um campo ali remove seu valor.

Prepare os campos personalizados de contato

Antes de exportar, abra Campos personalizados na mesma empresa e confirme que as definições necessárias estão ativas e pertencem a Contato, seguindo o SOP 004. A importação não cria definições nem opções. Campos de oportunidade não estão disponíveis nesta importação de contatos.

Baixe um modelo CSV atualizado: ele contém os sete cabeçalhos nativos e todos os campos ativos de contato como custom:chave. Preserve esses cabeçalhos estáveis para obter a associação automática; o nome exibido não é uma chave estável. Confira nome, chave, grupo, tipo e opções na tela de mapeamento. Uma coluna de origem com outro nome pode ser relacionada manualmente. Cada coluna pode ser usada apenas uma vez, considerando campos nativos e personalizados juntos. O arquivo aceita até 57 colunas (sete nativas e 50 personalizadas), mantendo os limites de 500 linhas e 2 MB.

Células vazias, campos não relacionados e a lista vazia [] preservam valores existentes. Uma seleção múltipla preenchida substitui a lista anterior. Para limpar intencionalmente um campo personalizado, use a ação Campos personalizados do contato e revise essa alteração separadamente. Valores arquivados são preservados. Campos personalizados nunca substituem e-mail, telefone internacional ou ID nativo na identificação. Várias linhas que apontam para o mesmo contato existente por identificadores diferentes também são rejeitadas; mantenha uma linha revisada por pessoa.

Faça o piloto e confira os valores personalizados

1. Em Campos personalizados de contato, confira cada associação e a instrução do tipo. Deixe como Não importar os campos que não pretende alterar.
2. Use um piloto pequeno e aprovado com um contato novo, um existente e cada tipo relacionado. Inclua vazio, zero e falso quando fizer sentido. Preserve privadamente os valores atuais antes de atualizar.
3. Leia cada alteração personalizada de antes → depois na prévia. Um valor personalizado inválido rejeita a linha inteira, inclusive os campos nativos. Corrija a fonte; não remova a associação apenas para contornar uma rejeição. O relatório identifica a chave estável custom:chave e o motivo sem conservar os valores enviados.
4. Confirme as linhas válidas, localize os contatos do piloto e reabra Campos personalizados. Compare com a fonte, incluindo preservação de vazio, zero, falso e substituição de listas de seleção múltipla preenchidas. Confira que campos não relacionados e arquivados permanecem intactos.
5. Se um valor do contato ou a definição de um campo relacionado mudar após a prévia, a confirmação será bloqueada. Gere e confira outra prévia. Um campo relacionado que foi arquivado precisa ser revisto antes de remapear; não o substitua silenciosamente por outro campo.

03. Confira todas as linhas antes de confirmar

1. Clique em Conferir importação. Enviar e gerar a prévia não salva contatos.
2. Em 3. Confira antes de importar, concilie Criar + Atualizar + Sem alteração + Rejeitada com o número de linhas não vazias de contatos do CSV. Sem alteração significa que os valores enviados já correspondem aos salvos; não é um erro.
3. Leia todas as páginas da prévia, incluindo valores anteriores e propostos nas atualizações. Cada página mostra 25 linhas. Compare identificadores, nomes, empresa e notas com a fonte. Em um lote apenas de atualizações, confira Criar = 0 e confirme que cada atualização corresponde ao registro correto.
4. Clique em Baixar relatório por linha. Ele contém números de linhas, resultados e motivos de rejeição, sem dados dos contatos. A linha 1 é o cabeçalho; uma nota entre aspas com quebras de linha continua pertencendo a um único registro CSV. Guarde o CSV exato junto ao relatório correspondente.
5. Se houver uma alteração errada, use Preparar outra prévia, corrija o CSV ou o mapeamento e confira novamente. Não confirme um lote parcialmente revisado: a confirmação processa todas as linhas válidas, inclusive as das outras páginas.

04. Confirme o piloto e confira os registros salvos

1. Confira novamente a empresa e os totais planejados. Clique em Confirmar linhas válidas e aceite o aviso somente quando todas as alterações válidas forem intencionais. As linhas rejeitadas são ignoradas.
2. Aguarde Importação concluída e abra Ver contatos. Localize cada contato do piloto por e-mail ou telefone e abra os detalhes. Compare os campos salvos com a fonte, confira o ID existente pretendido nas atualizações e confirme que campos vazios preservaram os valores anteriores.
3. Se o piloto estiver correto, retire suas linhas bem-sucedidas dos arquivos seguintes e processe os demais lotes revisados. Pare se algum valor salvo ou identidade divergir do plano. Não há desfazer automático; encaminhe o relatório e os valores preservados ao administrador da empresa antes de tentar uma correção.
4. Se houver dúvida sobre o resultado da confirmação, confira Suas importações recentes e os contatos salvos antes de criar outra importação. Reconfirmar a mesma prévia não duplica o lote; uma nova prévia é outra operação e precisa ser revisada contra os registros atuais.

05. Resolva exceções e concilie a lista

Baixe o relatório concluído de cada lote. Suas importações recentes mostra suas últimas 10 importações concluídas na empresa atual, com horários em UTC. Concilie todas as linhas de origem com criadas, atualizadas, sem alteração, rejeitadas e retidas separadamente; não conte rejeitadas ou retidas como importadas. Atribua responsável e próxima ação a cada pendência. Reenvie apenas o subconjunto corrigido depois de conferir suas correspondências atuais.

Critérios de conclusão

• A empresa de destino e as permissões do operador estão corretas.
• Cada criação ou atualização válida foi conferida antes da confirmação.
• Os detalhes salvos do piloto correspondem à fonte; valores vazios foram preservados.
• Cada lote tem arquivo de origem, relatório e totais conciliados na pasta privada do trabalho.
• Linhas pendentes têm motivo, responsável e próxima ação.

Esta é uma revisão editorial alinhada à interface atual da 6am. Uma prévia aprovada não verifica a titularidade nem a exatidão dos dados de origem; o piloto e a conferência dos registros salvos continuam fazendo parte de cada importação real.