Saltar para o conteúdo principal
Neste artigo, vamos guiá-lo no carregamento de um ficheiro de contactos para a CloudTalk.
Nível de utilizador:
  • Admin
⚠️ A importação de contactos através de ficheiros CSV pode demorar algum tempo. Para obter os melhores resultados, recomendamos que conte com tempo de processamento adicional durante as horas de maior tráfego.Se o tempo for crítico para a sua importação, considere métodos alternativos, como utilizar uma integração de CRM ou a API da CloudTalk para sincronização em tempo real.📘 Saiba mais: Como importo contactos para a CloudTalk?

​
Preparação dos dados

É suportado um máximo de 8MB (normalmente ~ 80 mil contactos). Ficheiros maiores não serão carregados.
Ao importar contactos a partir de um ficheiro, é atualmente necessário o formato .csv . Existem vários tipos de software que lhe permitem guardar os seus dados em CSV. No caso mais comum, a utilização do Excel, pode aceder a Ficheiro > Guardar como. No campo Nome do ficheiro, selecione o formato CSV . É muito importante configurar o seu ficheiro CSV de acordo com o nosso modelo de ficheiro CSV. Para aceder a este modelo, na sua conta do CloudTalk Dashboard, navegue até Contactos > Importação em Massa e depois clique em Descarregar modelo no canto inferior esquerdo. Note que pode eliminar com segurança quaisquer colunas não utilizadas do modelo.Se só precisar de importar dados básicos como name, phone ou email, pode remover todas as outras colunas sem qualquer problema.

​
Requisitos do ficheiro CSV

É altamente recomendável descarregar e seguir o modelo. Acima de tudo, não se esqueça de:
  • Escrever todos os nomes das colunas em minúsculas (os atributos personalizados podem ser diferentes)
  • Evitar tipos de letra especiais ou texto estilizado (por exemplo, tipos de letra cursivos, caligráficos ou decorativos) nos nomes dos contactos ou noutros campos. Estes podem impedir que o seu ficheiro seja carregado corretamente.
  • Utilizar apenas caracteres ASCII padrão no nome e no conteúdo do ficheiro. As importações de CSV podem falhar se forem utilizados caracteres especiais ou não ASCII (por exemplo, ö, ü, ç).
  • Preencher os valores de name e phone ou email para todos os contactos.
O não cumprimento destas indicações pode originar linhas com falha ou importações incompletas.
Alguns problemas (como cabeçalhos incorretos ou uma estrutura de ficheiro errada) podem impedir por completo o início da importação.
Importante: código de país padrão
O país predefinido nas suas Definições da conta determina qual o indicativo internacional (+) que será aplicado automaticamente aos números de telefone carregados que ainda não o incluam.Antes de importar o ficheiro, verifique novamente se o país selecionado em Definições > Geral > Código de país padrão corresponde ao país dos números de telefone do seu CSV.Se o país predefinido for diferente, os seus números podem ser importados com o prefixo internacional errado.

​
Exemplo de colunas na sua folha de cálculo

​
Coluna do país (formatos suportados)

Se o seu ficheiro CSV incluir uma coluna country, a CloudTalk aceita vários formatos de país para facilitar as importações. Pode utilizar:
  • Códigos de país de duas letras, por exemplo: US, GB, DE
  • Códigos de país de três letras, por exemplo: USA, FRA, DEU
  • Nomes completos dos países em inglês, por exemplo: United States, Germany, France
  • Variantes comuns e inequívocas, por exemplo: United States of America, Great Britain, Trinidad & Tobago
A CloudTalk normaliza automaticamente as diferenças de formatação mais comuns, incluindo:
  • valores em maiúsculas e minúsculas
  • espaços adicionais antes, depois ou dentro do valor
  • a utilização de & em vez de and (e vice-versa)
Se o valor do país não puder ser reconhecido, a linha falha com uma mensagem de erro clara a indicar que o valor do país é inválido.

​
Atributos personalizados

Para garantir que os campos de contacto adicionais do seu ficheiro CSV são apresentados corretamente nos contactos, terá de os adicionar como atributos personalizados nas definições do seu dashboard.
  1. No dashboard, navegue até Definições > Geral.
  2. No separador Definições gerais, desça até à secção Contactos.
  3. É aqui que pode adicionar os nomes dos seus campos personalizados, selecionando + Adicionar Atributo Personalizado. Certifique-se de que os nomes que introduz aqui correspondem aos nomes do seu CSV, tanto na ortografia como nas maiúsculas e minúsculas.

​
Importar contactos a partir de um ficheiro

Quando o ficheiro CSV estiver concluído e guardado no formato correto, está pronto a ser importado.
  1. Aceda a Contactos e clique em Importação em Massa.
  2. Carregue o ficheiro CSV.
  3. Adicione tags aos seus contactos: crie uma tag como forma de identificação dos contactos que está a importar. Esta tag é importante para as campanhas do Dialer e pode ser utilizada para filtrar contactos.
  4. Selecione Confirmar para iniciar a importação.
Depois de carregar o ficheiro, a importação aparece em Contactos > Arquivos importados, onde pode acompanhar o respetivo progresso e analisar os resultados.

​
Arquivos importados

A CloudTalk mantém um histórico claro de todas as importações de CSV, para que possa acompanhar facilmente o que aconteceu, detetar problemas e corrigi-los sem contactar o Suporte.
Quando abre uma tarefa de importação, a CloudTalk apresenta um detalhe completo, incluindo:
  • Número total de linhas do ficheiro
  • Número de contactos importados com sucesso
  • Número de contactos que falharam (caso existam)
  • Um estado linha a linha com mensagens de resultado claras. Cada linha com falha inclui um motivo específico que explica por que razão o contacto não pôde ser importado.

​
O que acontece se uma importação falhar

​
Erros globais de importação

Se a importação falhar antes de processar as linhas, verá uma mensagem de erro global a explicar o motivo, por exemplo:
  • Não foi possível carregar o ficheiro
  • Indisponibilidade temporária do serviço (normalmente resolve-se sozinha ao fim de pouco tempo. Se o problema persistir ou ocorrer várias vezes no espaço de algumas horas, o Suporte da CloudTalk pode ajudar a investigar)
  • O tamanho do ficheiro excede 8 MB

​
Importações parciais

A CloudTalk já não rejeita o ficheiro inteiro por causa de um contacto inválido.
  • Os contactos válidos são importados com sucesso
  • Os contactos inválidos são marcados como Falhou
  • Uma importação com este resultado é apresentada com um estado «Concluído» a laranja, indicando que a importação terminou, mas que algumas linhas falharam.
  • Se demasiadas linhas falharem (o limite é de 1000 registos com falha), a importação pode ser interrompida para evitar dados incorretos.
Pode descarregar o relatório de erros, corrigir apenas as linhas com falha e voltar a carregá-las.

​
Como corrigir as linhas com falha

  1. Abra Contactos > Arquivos importados
  2. Clique em Ver detalhes na importação que falhou
  3. Analise o motivo da falha de cada contacto
  4. Descarregue o relatório de erros (se estiver disponível)
  5. Corrija apenas as linhas com falha no seu CSV
  6. Volte a carregar o ficheiro corrigido

​
Lista de erros das linhas com falha e como resolvê-los

​
Comprimento máximo de caracteres

Se um valor exceder o comprimento máximo, reduza o número de caracteres e volte a carregar o ficheiro. Todos os outros campos são opcionais. Se um campo opcional ficar vazio, não será importado qualquer valor para esse campo.
Se continuar a ter problemas depois de corrigir as linhas com falha ou se quiser ajuda com outros sintomas específicos da importação, consulte estes guias de resolução de problemas:
  • Importação de CSV bloqueada – explica por que motivo uma importação pode permanecer Em processamento durante muito tempo, quando isso é normal e quando deve agir.
  • O carregamento do ficheiro CSV falha – percorre os problemas comuns de formatação e de estrutura (como codificação, cabeçalhos em falta ou delimitadores errados) e explica como resolvê-los.
Precisa de ajuda ou tem alguma questão? Basta contactar-nos através do nosso portal de suporte — estamos aqui para si.