Skip to main content

Documentation Index

Fetch the complete documentation index at: https://ajuda.attende.online/llms.txt

Use this file to discover all available pages before exploring further.

Se você já tem uma lista de clientes em outro sistema ou planilha, não precisa cadastrar um a um. O Attende aceita importação em lote via arquivo CSV. Em alguns minutos, toda a base está disponível para o time.
Importação de contatos é uma função exclusiva de administradores. Agentes não visualizam essa opção.

​
Como funciona o processo

A importação roda em segundo plano. Você faz o upload do arquivo, o Attende processa e — ao terminar — envia um e-mail de confirmação para todos os administradores da conta com o resumo: quantos contatos foram importados com sucesso e, se houver falhas, um arquivo CSV com os registros rejeitados e o motivo de cada um. Isso significa que você não precisa ficar de olho na tela. Inicie e aguarde o e-mail.

​
Preparando o arquivo CSV

O arquivo deve ser salvo em formato CSV com codificação UTF-8. Planilhas do Google Sheets e do Excel exportam nesse formato — veja na seção de dúvidas como fazer isso.

​
Colunas aceitas

ColunaObrigatóriaFormato / Observação
nameNão (recomendada)Nome completo ou apelido
emailNãoEndereço de e-mail válido, único por conta
phone_numberNãoFormato internacional E.164 — ex.: +5511999990000
company_nameNãoNome da empresa onde o contato trabalha
labelsNãoEtiquetas separadas por vírgula — ex.: lead,vip
middle_nameNãoNome do meio
last_nameNãoSobrenome
locationNãoCidade, estado ou endereço livre
country_codeNãoCódigo do país — ex.: BR
Nenhuma coluna é tecnicamente obrigatória, mas um contato sem name, email ou phone_number fica praticamente inutilizável. No mínimo, inclua o telefone ou o e-mail.

​
Regras de formato

▸ Telefone (phone_number): deve seguir o padrão internacional E.164 — sempre começando com + e o código do país. Para números brasileiros: +55 + DDD + número. Exemplo: +5511987654321. ▸ Etiquetas (labels): use as etiquetas que já existem na sua conta. Etiquetas não cadastradas são ignoradas durante o import. ▸ E-mail: registros com e-mail duplicado em relação a um contato que já existe na conta são ignorados silenciosamente — o contato existente não é alterado.

​
Exemplo de arquivo

name,email,phone_number,company_name,labels
Ana Lima,ana@empresa.com,+5511999990001,Empresa A,vip,lead
Carlos Souza,,+5511999990002,Empresa B,
Mariana Costa,mariana@outra.com,,,

​
Fazendo o upload

1

Abra a seção de Contatos

No menu lateral, clique em Contatos (ícone de pessoa).
2

Localize o botão de importação

No canto superior direito da tela de Contatos, clique no ícone de importar (seta para cima) ou no menu de opções.
3

Selecione o arquivo CSV

Na janela que abrir, escolha o arquivo CSV preparado. O upload começa imediatamente.
4

Aguarde o e-mail de confirmação

O processamento roda em segundo plano. Você — e os demais administradores da conta — receberão um e-mail quando concluir. Não precisa manter a aba aberta.

​
Lendo o e-mail de resultado

O e-mail de resultado traz três informações: ▸ Contatos importados com sucesso — número de registros que entraram na base. ▸ Registros com falha — número de linhas que não puderam ser importadas. ▸ Arquivo de erros — se houver falhas, um CSV para download. Ele contém as linhas rejeitadas com uma coluna extra chamada errors explicando o motivo de cada rejeição (e-mail inválido, telefone fora do formato, arquivo em branco etc.). Corrija os registros do arquivo de erros e faça um novo upload só com eles.

​
Sobre duplicados

O Attende detecta automaticamente contatos que já existem na conta — por e-mail ou telefone — e os ignora durante o import. O contato existente não é sobrescrito nem duplicado.
A importação não atualiza dados de contatos existentes. Se um cliente já cadastrado teve o nome ou empresa alterados, a mudança precisa ser feita manualmente na ficha dele.

​
Dúvidas comuns

Google Sheets: Arquivo → Fazer download → Valores separados por vírgula (.csv). O Google já exporta em UTF-8.Excel: Arquivo → Salvar como → Tipo: “CSV UTF-8 (delimitado por vírgula) (.csv)”. Atenção: escolha a versão UTF-8, não o CSV padrão, para evitar problemas com acentos e caracteres especiais.
Não há um limite rígido de linhas por arquivo. O processamento é feito em lotes de 1.000 registros internamente, o que garante estabilidade mesmo em bases maiores. Para bases muito grandes (acima de 50 mil linhas), considere dividir em múltiplos arquivos para facilitar a análise de erros.
Etiquetas que não foram cadastradas previamente são ignoradas. Antes de importar, crie as etiquetas necessárias em Configurações → Etiquetas para que sejam aplicadas corretamente aos contatos.
Não diretamente pelas colunas padrão. Os campos personalizados criados em Configurações → Atributos personalizados precisam ser preenchidos manualmente nas fichas dos contatos após a importação.
Verifique a caixa de spam e o e-mail do administrador da conta. Se após 30 minutos o e-mail não chegou, tente uma importação com um arquivo menor para validar o processo. Em caso de persistência, entre em contato com o suporte do Attende.
Com a base importada, a equipe já pode abrir conversas, aplicar etiquetas e acompanhar o histórico de cada cliente — tudo centralizado. Ponto.
Próximos artigos desta seção: ▸ Bloqueando contatos