Em CRM › Contatos ficam as pessoas que conversaram com os canais do cliente escolhido no topo do painel, das mais recentes para as mais antigas. Um contato entra sozinho quando manda mensagem para o seu WhatsApp ou um direct para o seu Instagram, ou quando você importa uma planilha. Nesta tela você encontra o contato, marca com tags, preenche os campos personalizados e registra o consentimento.
No topo da tela, os botões Lista e Funil de contatos trocam entre a lista (este artigo) e o quadro por etapa. O quadro está em Funil de contatos.
Antes de começar
- Escolha o cliente no seletor do topo. Se ele ainda não tem canal conectado, a tela mostra Nenhum contato ainda.
- A lista, a busca, as tags, os campos personalizados, o consentimento e a importação funcionam em todos os planos.
A lista
Cada linha é um contato. As colunas são:
- Contato: a foto, o nome e, embaixo, o telefone. No contato do Instagram, embaixo do nome aparece o @. Um pequeno selo no canto da foto mostra o canal: WhatsApp ou Instagram. Sem foto, aparecem as iniciais do nome.
- Etapa: a etapa do contato no funil, ou um traço quando ele ainda não tem etapa.
- Tags: até três tags; as demais aparecem como "+2", "+3". Passe o mouse para ver todas.
- Uma coluna para cada campo personalizado que você criou.
- Visto por último e Criado em.
- Editar: o lápis que abre o cartão do contato.
Acima da tabela aparece quantos contatos o cliente tem. A lista mostra 50 por página; quando há mais, embaixo aparecem a página atual e os botões Anterior e Próxima.
O botão Atualizar recarrega a lista, por exemplo depois que uma conversa nova chegou.
Filtrar por canal
Acima da tabela, os botões Todos, WhatsApp e Instagram separam os contatos por canal, cada um com o total de contatos. O filtro vale junto com a busca e com o filtro de etapa. Para voltar a ver todos, clique em Todos.
Buscar um contato
Digite na caixa Buscar por telefone, @, nome, tag ou campo. A busca procura em todos os contatos do cliente, não só na página aberta: no nome, no @, no telefone, nas tags e nos valores dos campos personalizados. O total acima da tabela passa a contar só os contatos encontrados. Para voltar à lista completa, apague o texto da busca.
Quando você chega do funil de contatos pelos links Ver na lista ou Ver todos na lista, a lista vem filtrada pela etapa e mostra o filtro acima da tabela, como Etapa: Sem etapa. Clique nele para tirar o filtro.
O nome do contato
O nome que aparece é o Nome do contato que você deu a ele, no cartão do contato ou na planilha importada. Esse nome é seu: o WhatsApp não o troca.
Enquanto o contato não tem um nome dado por você, aparece o que vem do WhatsApp: o nome de usuário com @, quando ele tem um, ou o nome do perfil, que o próprio WhatsApp informa e o BotoZap atualiza a cada mensagem. Sem nenhum dos dois, aparece o telefone.
O mesmo nome aparece na lista, no funil de contatos e na busca de contato das oportunidades e demandas.
Contatos do Instagram
Quem manda um direct para a conta do Instagram do cliente entra na lista sozinho, assim como quem recebe o direct de uma regra de Comentários → DM. O contato do Instagram:
- Não tem telefone. No lugar dele aparece o @ do perfil, e é pelo @ que você busca.
- Traz o nome, o @ e a foto do perfil do Instagram. O BotoZap busca esses dados na primeira mensagem e os renova, no máximo uma vez por dia, enquanto a pessoa continua conversando. Sem nome dado por você, aparece o nome do perfil e, na falta dele, o @.
- É separado do contato do WhatsApp. Cada canal tem os seus contatos: a mesma pessoa falando pelos dois canais aparece duas vezes, uma em cada um.
- Funciona no CRM como qualquer contato: etapa, tags, campos personalizados, nota, oportunidades e demandas.
O que não vale para ele: transmissões, réguas e templates, que são só do WhatsApp, e a importação de planilha, que trabalha com telefone. No Instagram, você responde até 24 horas depois da última mensagem do contato. Veja Conectar e atender pelo Instagram.
Editar um contato
Clique no lápis no fim da linha. O cartão do contato tem o nome, o consentimento, as tags, os campos personalizados, a nota e, no fim, a exclusão do contato. O consentimento e as tags são gravados na hora; o nome, os campos e a nota, quando você clica em Salvar.
Nome do contato
Escreva em Nome do contato o nome que você quer ver no BotoZap, por exemplo "Ana (Loja Centro)", e clique em Salvar. A dica embaixo do campo segue o canal do contato, como "Aparece no lugar do nome do perfil do Instagram, que continua guardado." Para voltar a mostrar o nome do perfil, apague o Nome do contato e salve.
É esse nome que preenche {{nome}} e {{primeiro_nome}} nas respostas rápidas.
Tags
As tags são etiquetas livres para agrupar contatos: "vip", "atacado", "indicação".
- Em Nova tag, digite a tag. Enquanto você digita, aparecem sugestões com as tags já usadas em outros contatos, para manter a mesma grafia.
- Clique em Adicionar.
- Para tirar uma tag, clique no x ao lado dela.
Cada tag é gravada na hora, sem precisar salvar. Um contato tem até 20 tags, de até 40 caracteres cada. Tags que só mudam nas maiúsculas contam como a mesma: "VIP" e "vip" não viram duas.
As mesmas tags são usadas pelas réguas, pelos follow-ups da IA e pelo agente, quando ele tem permissão para marcar contatos.
Campos personalizados
Os campos que você criou aparecem um embaixo do outro, cada um com o controle do seu tipo:
- Texto: uma caixa livre, com até 256 caracteres.
- Número: aceita só números. Use vírgula ou ponto para decimais, como 3,5.
- Sim/Não: uma lista com Sim, Não e Não preenchido.
- Data: abre um calendário.
Preencha e clique em Salvar. Deixar um campo vazio (ou em Não preenchido) apaga o valor daquele campo neste contato. Se um valor não combina com o tipo, o cartão diz qual campo corrigir, por exemplo "Pontos" precisa ser um número (ex.: 42 ou 3,5).
Para criar, renomear ou excluir campos, veja Etapas e campos personalizados.
Nota
A Nota é uma anotação livre sobre o contato, de até 4.000 caracteres, visível só para a sua equipe. Escreva e clique em Salvar. É a mesma nota do cartão no funil de contatos, e funciona também para quem ainda não tem etapa.
Editar a nota faz parte dos planos pagos e do período de teste, como o funil. Nos outros planos, uma nota que já exista aparece só para leitura.
Consentimento
O bloco Consentimento registra se o contato aceitou receber mensagens de Marketing (promoções, novidades) e de Utilidade (avisos sobre pedidos, agendamentos, cobranças) neste canal. Logo abaixo do título, o bloco diz de qual canal é o registro: Canal WhatsApp ou Canal Instagram.
Cada finalidade mostra uma de três situações:
- Não informado: ainda não há nenhum registro.
- Autorizou: o contato aceitou.
- Recusou: o contato não quer receber, ou pediu para sair.
Clique em Autorizou ou em Recusou para registrar. A mudança é gravada na hora, com a data e o seu usuário, e entra no histórico. Não informado aparece só enquanto não existe registro: depois do primeiro, a escolha é entre Autorizou e Recusou.
Uma recusa só é desfeita pelo próprio contato. Com Recusou marcado, o botão Autorizou fica desligado e o bloco mostra Este contato recusou. Só ele pode voltar a autorizar: tocando no botão do pedido de consentimento na conversa ou mandando uma Palavra de volta que o Cliente cadastrou. O mesmo vale para a planilha, para a integração e para o MCP: nenhum deles troca Recusou por Autorizou.
O contato tem dois caminhos de volta:
- Palavra de volta: ele manda uma mensagem só com uma palavra que você cadastrou no cliente, pelo WhatsApp ou por direct no Instagram. O registro passa a Autorizou com a origem Palavra de volta, e ele recebe uma confirmação. Se o cliente tem uma Palavra de volta, a confirmação de saída já avisa que é só responder com ela; se não tem, a confirmação orienta a falar com a empresa por ali.
- Botão na conversa: no WhatsApp, com a conversa aberta, envie a ele o pedido de consentimento pelo composer. Quando ele tocar no botão, o registro passa a Autorizou com a origem Botão na conversa.
A recusa vale para todos os números do mesmo cliente. Se a mesma pessoa é contato de mais de um número de WhatsApp do cliente (pelo telefone, com ou sem o nono dígito), recusar por um deles marca Recusou em todos, e ela também não recebe marketing de um número desse cliente que ainda não falou com ela. Quando ela manda uma Palavra de volta ou toca no botão do pedido de consentimento em qualquer um desses números, volta a Autorizou em todos. Se a sua conta atende mais de um cliente, a recusa feita a um cliente não vale para os outros: são empresas diferentes.
Embaixo de cada finalidade aparecem a origem do último registro e a data e a hora, no horário de Brasília. A origem é uma destas: Manual (registrado no painel), Importação (veio de uma planilha), Integração (veio de um sistema ligado ao BotoZap), Palavra de saída (o contato mandou uma Palavra de saída do cliente), Palavra de volta (o contato mandou uma Palavra de volta do cliente), Botão na conversa, Botão de saída do template (o contato tocou no botão que você marcou como de saída num template) Recusa informada pela Meta (a Meta avisou que a pessoa parou de receber marketing da sua empresa) ou Declaração do dono no follow-up (um follow-up de Marketing em que quem publicou declarou o aceite dos contatos mandou mensagem a quem não tinha registro; o registro cita o fluxo, a versão, quem declarou e quando).
Se o BotoZap não conseguir ler o consentimento, o bloco mostra Não foi possível ler o consentimento. Nada foi alterado. e o botão Tentar de novo. Enquanto a leitura não der certo, nada pode ser gravado.
O que o consentimento muda:
- Com Marketing recusado, o BotoZap não envia templates de marketing para o contato por nenhum número daquele cliente, nem numa transmissão nem pela conversa. Templates de utilidade continuam saindo.
- Sem nenhum registro de marketing, o envio não é bloqueado.
- Quando o contato manda só uma Palavra de saída do cliente, pelo WhatsApp ou por direct no Instagram, o BotoZap registra a recusa de marketing sozinho, em todos os números daquele cliente, e responde com uma confirmação. Não existe lista padrão: as palavras são as que você cadastra em Configurações › Clientes, no cliente, em Palavras de saída.
- Quando o contato toca no botão que você marcou como de saída num template, o BotoZap registra a recusa da finalidade do template (marketing ou avisos). Veja Botão de saída.
- Quando a Meta informa que a pessoa parou de receber marketing da sua empresa (erro 131050 num envio de marketing), o BotoZap registra a recusa de marketing do contato, só para aquele cliente.
- Quem tinha recusado e manda só uma Palavra de volta do cliente volta a Autorizou em todos os números daquele cliente e recebe uma confirmação. Quem não tinha recusado não muda. As palavras ficam em Configurações › Clientes, em Palavras de volta.
Importar contatos de uma planilha
O botão Importar aparece quando o cliente tem um número de WhatsApp conectado. A importação traz contatos do WhatsApp, identificados pelo telefone: não dá para importar contatos do Instagram, que entram sozinhos quando mandam um direct.
Antes de importar
- Salve a planilha como CSV. A primeira linha precisa ser o cabeçalho, com o nome de cada coluna.
- O telefone vai com o código do país e o DDD, só números: 5511999998888. Números brasileiros sem o 55 são recusados.
- Até 2.000 linhas por vez e arquivo de até 512 KB. Para mais que isso, divida em arquivos menores.
- Para trazer o consentimento, use colunas chamadas consentimento_marketing e consentimento_utility, com sim ou nao em cada linha. O sim não vale para quem recusou: esse contato continua como Recusou.
- Colunas de campos do tipo Data aceitam 25/09/2026 ou 2026-09-25. Campos do tipo Número aceitam números como 42 ou 3,5, e campos Sim/Não aceitam sim ou não.
Passo a passo
- Em CRM › Contatos, clique em Importar.
- Escolha o arquivo.
- Se o cliente tem mais de um número, escolha o Número de destino: os contatos ficam ligados a ele.
- Confira o Mapeamento das colunas. Para cada coluna do arquivo, o BotoZap sugere o que ela é, mostrando um exemplo da primeira linha:
- Telefone: obrigatória, exatamente uma coluna.
- Nome do contato: vira o nome do contato no BotoZap.
- Campo: e o nome de um campo que já existe.
- Criar campo: cria um campo personalizado novo com o nome da coluna.
- Consentimento marketing e Consentimento utilidade.
- Ignorar: a coluna não é importada.
- Leia o resumo embaixo do mapeamento: quantas linhas serão importadas, quantas têm problema e quais campos serão criados.
- Clique em Importar.
O que acontece depois
O resultado mostra quantos contatos novos foram criados, quantos já existiam e foram atualizados, e quantas linhas foram ignoradas, cada uma com a linha e o motivo (por exemplo, telefone fora do formato ou telefone repetido no arquivo). Clique em Importar outro para mandar mais um arquivo ou em Concluir para fechar.
- Contato que já existia é atualizado, não duplicado. Os campos da planilha entram sem apagar os que ele já tinha. O nome da planilha passa a ser o Nome do contato; uma célula de nome vazia mantém o nome que ele já tinha. O nome do perfil do WhatsApp continua guardado.
- O nono dígito não cria duplicata. Um número brasileiro com e sem o 9 é reconhecido como o mesmo contato.
- Importar não coloca o contato numa etapa nem envia mensagem para ele.
- Linha com valor que não combina com o tipo do campo é ignorada, com o motivo no resultado, por exemplo "Pontos" precisa ser um número (ex.: 42 ou 3,5). As outras linhas entram normalmente.
- Quem recusou continua recusado. Se a planilha traz sim para um contato que tinha recusado, a recusa fica. O resultado avisa quantos contatos ficaram assim: N contato(s) tinham recusado mensagens e continuam como Recusou.
- É tudo ou nada. Os contatos, os campos novos e o consentimento da planilha são gravados juntos. Se algo falhar no meio, a tela avisa que nada foi gravado, e você pode importar o mesmo arquivo de novo.
Excluir um contato
Use a exclusão quando o contato pedir para ter os dados apagados (pedido de titular, na LGPD) ou quando ele foi criado por engano.
- Abra o cartão do contato (o lápis no fim da linha, ou Editar contato no menu do cartão no funil).
- No fim do cartão, clique em Excluir contato.
- Confira a lista do que será apagado: o contato, com nome, tags, campos e nota; as conversas, com todas as mensagens e mídias; as oportunidades e as demandas, com o histórico; os agendamentos; e os registros de consentimento. Cada item mostra quantos são.
- Digite o nome ou o telefone do contato na caixa de confirmação. No contato do Instagram, use o nome ou o @.
- Clique em Excluir contato.
As imagens, os vídeos, os áudios e os documentos dessas mensagens saem do armazenamento logo depois, em poucos minutos. Um arquivo que ainda é usado por outra mensagem de outro contato (por exemplo, a mesma imagem enviada por uma transmissão) continua guardado para ela.
Atenção: a exclusão é definitiva e não pode ser desfeita. Se o contato voltar a mandar mensagem, ele entra de novo como um contato novo, sem o histórico anterior.
Se o contato tinha recusado mensagens, a recusa não sai junto. O BotoZap guarda só o mínimo para cumpri-la: um código do telefone que não permite ler o número, a finalidade, a origem e a data. Se ele voltar a ser contato de qualquer número do mesmo cliente (mandando mensagem, por planilha ou pela integração), já entra como Recusou, e um template de marketing para esse telefone é recusado mesmo antes de ele virar contato de novo. O mesmo vale quando a Meta pede a exclusão dos dados de uma conta do Instagram: os contatos dela são apagados, e quem tinha recusado volta como Recusou se a conta for conectada de novo.
Para apagar só uma conversa e manter o contato, veja Excluir uma conversa. Excluir contatos e conversas é uma ação de quem administra a conta.
Problemas comuns
O botão Importar não aparece. O cliente escolhido não tem número de WhatsApp conectado. Confira o cliente no seletor do topo. Um cliente só com Instagram não tem importação.
Não acho um contato do Instagram. Busque pelo @ ou pelo nome, e confira se o filtro de canal não está em WhatsApp. O contato do Instagram só existe depois que a pessoa manda um direct (ou recebe o direct de uma regra de comentário).
Linhas ignoradas com "Telefone inválido" ou "Inclua o código do país". O telefone precisa do código do país e do DDD, só números. Corrija a planilha e importe de novo: os contatos que já entraram são atualizados, não duplicados.
"Escolha exatamente uma coluna de Telefone." Nenhuma coluna, ou mais de uma, está marcada como Telefone no mapeamento. Deixe só uma.
"Limite de 20 campos por conta." A importação criaria campos demais. Troque algumas colunas para Ignorar ou para um Campo: que já existe.
O contato não aparece na busca. Confira se o cliente certo está escolhido no topo: cada cliente tem os seus contatos.
"Não foi possível carregar os contatos agora." Clique em Tentar de novo, no próprio aviso.
Aparece "Só Administrador pode excluir contatos." no cartão. Excluir contatos de vez é do Administrador da conta. Veja Membros e papéis.
"Não foi possível importar os contatos. Nada foi gravado; tente de novo." Houve uma falha no meio da importação e nada entrou. Importe o mesmo arquivo de novo.
Perfil e seguidores do Instagram
Nos detalhes do contato aparecem Segue @conta, Seguidores, Verificado, se a conta segue a pessoa e a Última checagem. “Ainda não conferido” é diferente de “Não”. O número é a quantidade de seguidores da pessoa. Esses dados são de consulta e não podem ser editados. No Funil, o selo Segue aparece quando a última checagem confirmou que a pessoa segue a conta.
A checagem só é possível depois que a pessoa envia um direct ou toca em botão, quebra-gelo ou item do menu. Só comentar não permite consultar o perfil. Na hora de decidir a condição, o BotoZap consulta de novo; se o Instagram não responder, usa a última informação salva. Sem informação, considera que a pessoa não segue e registra esse motivo no disparo.
