[Extensão] Como importar contatos em massa na Blip com a extensão Gerenciador de Contatos

1. Introdução

2. Prepare o arquivo CSV

3. Importe os contatos

4. Revise os contatos importados

5. Contatos repetidos

6. Boas práticas

7. Suporte

Descrição breve: Cadastre grandes bases de contatos na Blip a partir de um arquivo CSV. A extensão Gerenciador de Contatos lê a planilha, mapeia as colunas e cria ou atualiza os contatos do bot de uma só vez.

Introdução

Cadastrar contatos um a um consome tempo quando a base é grande. Com a importação em massa do Gerenciador de Contatos, você envia um arquivo CSV e cria ou atualiza vários contatos de uma vez, com a base centralizada na Blip. Por exemplo, ao migrar 5.000 clientes de outra ferramenta, você exporta a planilha, confere a prévia e importa todos os contatos para o bot em uma única operação.

A extensão reconhece automaticamente colunas como nome, telefone e e-mail e usa esses dados para criar ou atualizar cada contato no bot onde está instalada. Contatos com o mesmo telefone ou e-mail entram no mesmo registro, então reimportar uma base atualiza os contatos existentes em vez de duplicá-los. Para adicionar um ou poucos contatos, use Criar contato em vez da importação.

Antes de começar

A importação acontece no bot em que o Gerenciador de Contatos está aberto, e os contatos entram por um canal. Verifique estes pré-requisitos antes de começar:

• A extensão Gerenciador de Contatos precisa estar instalada no bot cujos contatos você quer gerenciar. Ative o Gerenciador de Contatos na Blip Store se ainda não fez isso.

• O bot precisa ter o WhatsApp conectado ou o canal de e-mail ativo. Sem nenhum dos dois, a extensão avisa que não encontrou um canal compatível e a importação não fica disponível.

• Seu usuário precisa de permissão para criar e editar os contatos do bot.

• Os contatos precisam estar em um arquivo no formato CSV.

• A coluna de telefone (para WhatsApp) ou de e-mail (para e-mail) precisa estar preenchida. É esse dado que identifica cada contato, e a extensão ignora os registros que não o tiverem.

Faça uma primeira importação de teste com poucos contatos antes de enviar a base inteira.

Prepare o arquivo CSV

Salve o arquivo em CSV, com a primeira linha contendo os nomes das colunas. A extensão aceita vírgula, ponto e vírgula, tabulação ou barra vertical como separador e detecta qual você usou automaticamente.

A extensão reconhece algumas colunas pelo nome do cabeçalho, aceitando variações em português, inglês e espanhol: nome (nome, name, nombre), sobrenome (sobrenome, last name, apellido), telefone (telefone, phone, celular, whatsapp, teléfono) e e-mail (email, e-mail). As colunas de cidade, documento e quaisquer campos adicionais não são reconhecidas sozinhas: você as associa manualmente na etapa de personalização. A extensão junta nome e sobrenome em um único nome de contato.

Exemplo de arquivo:

nome,sobrenome,telefone,email,cidade,documento
João,Silva,5514999999999,joao@email.com,Botucatu,12345678900
Maria,Santos,5514988888888,maria@email.com,Bauru,98765432100

Telefone

Informe o número com DDD e, de preferência, o código do país (formato internacional, como 5514999999999). Se você não informar o código do país, a extensão interpreta o número como brasileiro. A extensão remove espaços, parênteses, traços, pontos e o sinal de mais antes de validar, e ignora números inválidos. Quando uma célula traz mais de um telefone separado por vírgula, ponto e vírgula ou barra, a extensão considera apenas o primeiro.

E-mail

Confira se os endereços estão completos e sem espaços antes ou depois do valor. Em uma importação por e-mail, é o endereço que identifica o contato.

Documento e codificação

O campo Documento aceita CPF, CNPJ ou outro identificador da sua operação. Formate a coluna como texto na planilha para o programa não alterar o valor, por exemplo removendo um zero à esquerda. Salve o arquivo em UTF-8 para preservar acentos, cedilhas e caracteres especiais nos nomes e nas cidades.

Importe os contatos

A importação tem duas etapas: Upload e Personalização.

1. Acesse a Blip, abra o bot cujos contatos você quer importar e abra a extensão Gerenciador de Contatos. A extensão lista os contatos já cadastrados e as ações disponíveis.

2. Na tela do Gerenciador de Contatos, clique em Importar contatos. A extensão abre a janela de importação na etapa Upload.

3. Em Escolha o canal de onde seus contatos virão, selecione WhatsApp ou Email. Os contatos entram como contatos do canal escolhido, identificados pelo telefone (WhatsApp) ou pelo e-mail (Email). Se o bot tiver só um canal compatível, ele já vem selecionado. Arraste o arquivo CSV para a área de upload ou clique nela para escolher o arquivo no computador e clique em Fazer upload. A extensão lê o arquivo e mostra uma Prévia com Nome, Telefone e E-mail dos primeiros contatos (até 100). Confira os dados e clique em Avançar.

4. Na etapa Personalização, em Colunas do arquivo de entrada, selecione as colunas que quer associar manualmente. Para cada uma, use o campo Propriedade para escolher o campo da Blip (Telefone, Nome, Email, Cidade ou Documento), ou ative Extra e dê um nome para gravar o valor como um campo personalizado do contato. As colunas de nome, telefone e e-mail já reconhecidas são importadas mesmo sem mapeamento. Use esta etapa para importar cidade, documento e campos personalizados, ou para corrigir uma coluna associada ao campo errado.

5. Clique em Importar. A extensão processa os contatos em lotes e mostra o progresso ("Importando X de Y contatos..."). Ao terminar, você vê o total de contatos importados. Se algum registro não puder entrar, por exemplo sem telefone válido em uma importação por WhatsApp ou sem e-mail em uma importação por e-mail, a extensão informa o total de falhas.

Não feche a página enquanto a importação estiver em andamento. Bases grandes podem levar alguns minutos.

Revise os contatos importados

Use o campo Buscar contatos para localizar alguns registros da planilha por nome, telefone, e-mail ou documento. Abra um contato e confira se os dados ficaram nos campos certos. Faça essa conferência antes de usar a base em mensagens ativas, campanhas, automações ou integrações.

Contatos repetidos

Cada contato é identificado pelo telefone (no WhatsApp) ou pelo e-mail (no e-mail). Quando você importa um contato com o mesmo identificador de um que já existe, a extensão atualiza o contato existente em vez de criar um duplicado. Mesmo assim, padronize telefone, e-mail e documento na planilha para os registros casarem como você espera e para manter pesquisas, segmentações e campanhas consistentes.

Boas práticas

• Faça um teste com uma amostra pequena antes de importar a base inteira.

• Guarde uma cópia do arquivo original.

• Salve o CSV em UTF-8 e remova linhas vazias e espaços sobrando.

• Padronize telefones e documentos.

• Mantenha só as informações necessárias e autorizadas, seguindo as políticas de privacidade e tratamento de dados da sua operação.

• Importar contatos não dispara mensagens. O envio de mensagens ativas depende das regras do canal e das autorizações dos contatos.

Suporte

Em caso de dúvida ou problema com a extensão, fale com a gente pelo e-mail support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃