¶ Como importar contatos no Q-Desk?
A importação de contatos permite cadastrar ou atualizar vários contatos de uma só vez por meio de um arquivo CSV.
⚠️Importante!
A importação está disponível para todos os usuários com acesso à tela “Contatos”. O arquivo deve estar no formato CSV, separado por vírgula ou por ponto e vírgula.
¶ Preparar o arquivo
1. Na tela de importação, clique em “Baixar um exemplo de csv.” e salve o arquivo.
2. Expanda “Instruções dos campos” e confira o formato de cada campo.
Serão apresentadas orientações sobre como preencher corretamente cada campo da planilha, garantindo que o sistema consiga realizar a leitura e a importação dos contatos adequadamente.
3. Preencha uma linha para cada contato, mantendo os nomes das colunas do arquivo de exemplo.
4. Salve o arquivo no formato CSV.
¶ Informações aceitas no arquivo
- name: Nome completo do contato.
- email: Endereço de e-mail válido.
- phone_number: Telefone com DDI e DDD, preenchido apenas com números. O sinal “+” no início é opcional. Exemplo: 5551999999999.
- identifier: Identificador externo único do contato.
- company_registration_number: CNPJ ou CPF de uma empresa já cadastrada no Q-Desk.
- city: Cidade do contato.
⚠️Importante!
Preencha ao menos uma das informações “email”, “phone_number” ou “identifier” em cada linha. Nas instruções dos campos, essas colunas aparecem como “Obrigatório (um deles)”.
Colunas diferentes das listadas acima são salvas como atributos personalizados do contato.
Para mais informações, acesse o material → Como criar Atributos Personalizados?
¶ Contatos já cadastrados
Quando o identificador, o e-mail ou o telefone da linha corresponde a um contato existente, o cadastro desse contato é atualizado com os dados do arquivo. Nenhum novo contato é criado.
¶ Vínculo com empresas
Quando o CNPJ ou CPF informado corresponde a uma empresa cadastrada, o contato é vinculado a essa empresa e o total de contatos da empresa é atualizado. A comparação desconsidera pontos, barras e traços.
A importação de contatos não cadastra empresas. Cadastre ou importe as empresas antes de importar os contatos.
¶ Importar o arquivo
1. Acesse Q-Desk > Contatos > Todos os Contatos. Clique no menu “⋮” e selecione “Importar contatos”.
2. Clique em “Escolher arquivo” e selecione o arquivo CSV. Clique em “Importar”.
O processamento é realizado em segundo plano. Ao final, os usuários com perfil “Administrador” da conta recebem um e-mail com o resultado da importação.
¶ Consultar o resultado da importação
O e-mail de conclusão informa a quantidade de contatos importados, a quantidade de registros com falha e o motivo das falhas no formato “Linha N: motivo”. O número da linha corresponde à linha da planilha, considerando o cabeçalho como linha 1.
O e-mail exibe até 20 falhas. A lista completa está disponível no arquivo de registros com falha, que pode ser baixado pelo link do e-mail.
¶ Principais motivos de falha:
- “Linha sem e-mail, telefone ou identificador”: Preencha ao menos uma dessas informações.
- “Telefone inválido (…); preencha apenas com números, incluindo DDI e DDD”: Corrija o telefone informado.
Quando o arquivo não pode ser lido, nenhum contato é importado e o e-mail informa o erro encontrado.
¶ Corrigir registros com falha
1. Baixe o arquivo de registros com falha pelo e-mail de conclusão.
2. Verifique o motivo informado para cada linha.
3. Corrija os dados no arquivo.
4. Importe o arquivo corrigido.