Contatos

Permite gerenciar contatos da base, importar e exportar por planilhas e fazer alterações como editar nome, ativar/desativar IA e excluir contato com a conversa.

codeAtendimento
labelContatos
schooliniciante
generated
schedule2026-07-09
notes

Contatos (gerenciar, importar e exportar)

Use para gerenciar contatos e conversas.
Aplique filtros (Canal, datas, Tag, Departamento, Atendente, Situação e IA).
Importe e exporte por planilhas.
Edite o nome do contato/conversa, ative/desative IA e exclua o contato com a conversa.
Também dá para criar Novo contato/conversa por uma lista de números.

notes

Resumo rápido

  • Use Filtrar para encontrar contatos por Canal, datas, Tag, Departamento, Atendente, Situação e IA.
  • Clique no nome para abrir a conversa.
  • Clique no lápis para editar o nome e use X (cancelar) ou (salvar).
  • Use o botão com ícone de chat automático para alternar IA Ativa/IA Desativada.
  • Use Importar (arquivo .xls/.xlsx), confira o Relatório de Importação e filtre por Novos/Atualizados/Ignorados/Erros.
  • Use Exportar para baixar a planilha com os dados.

Resultado esperado: Contatos e conversas ficam organizados, com possibilidade de criar, atualizar, exportar, importar e controlar IA por contato.

edit_note

Campos e filtros visíveis

Canal

edit_noteseleção
Opcional

Descrição: Selecione para mostrar apenas contatos daquele canal.
Use - Todos - para não limitar por canal.

Regras/validações: Opções incluem - Todos - e uma lista de canais disponíveis.

Exemplos: - - Todos -
- Selecionar um canal da lista

Data inicial

edit_notedata
Opcional

Descrição: Defina uma data de início para filtrar os contatos.

Regras/validações: Campo de data (seleção pelo calendário).

Exemplos: - 01/01/2026
- 15/03/2026

Data final

edit_notedata
Opcional

Descrição: Defina uma data de fim para filtrar os contatos.

Regras/validações: Campo de data (seleção pelo calendário).

Exemplos: - 31/01/2026
- 20/04/2026

Tag

edit_noteseleção
Opcional

Descrição: Use para filtrar por uma TAG.
Use - Não informar - para não filtrar por tag.
Use Sem tags para ver só contatos sem nenhuma tag.

Regras/validações: Opções incluem - Não informar -, Sem tags e uma lista de tags.

Exemplos: - Sem tags
- Selecionar uma tag da lista

Departamento

edit_noteseleção
Opcional

Descrição: Use para filtrar por Departamento.
Use Sem departamento para ver contatos sem departamento.

Regras/validações: Opções incluem - Não informar -, Sem departamento e uma lista de departamentos.

Exemplos: - Sem departamento
- Selecionar um departamento da lista

Atendente

edit_noteseleção
Opcional

Descrição: Use para filtrar por Atendente.
Use - Sem atendente - para ver contatos sem atendente.

Regras/validações: Opções incluem - Não informar -, - Sem atendente - e uma lista de atendentes.

Exemplos: - - Sem atendente -
- Selecionar um atendente da lista

Situação

edit_noteseleção
Opcional

Descrição: Mostra contatos por situação de conversa.
Use - Todas - para não limitar.

Regras/validações: Opções: - Todas -, Abertos, Resolvidos.

Exemplos: - Abertos
- Resolvidos

IA

edit_noteseleção
Opcional

Descrição: Filtra pelo estado da IA.
Use para achar conversas com IA Ativa, IA Desativada ou Aguardando.

Regras/validações: Opções: - Não informar -, IA Ativa, IA Desativada, Aguardando.

Exemplos: - IA Ativa
- Aguardando

Adicione os números com DDD e pressione Enter

edit_notetexto (lista de números)
Obrigatório

Descrição: Use ao criar Novo contato/conversa.
Cole uma lista de números e confirme.
Dá para colar números separados por vírgula, quebra de linha ou espaço.

Regras/validações: Se não tiver número válido, aparece: "Adicione ao menos um número válido para continuar."
Mostra "Total de números válidos".

Exemplos: - 11999998888
- 21988887777, 11911112222

Nome do contato/conversa (opcional)

edit_notetexto
Opcional

Descrição: Preencha para dar um nome para cada número.
Se ficar vazio, a conversa é criada apenas com o número.

Regras/validações: Indicado como opcional (texto: "Nomes (opcional)" e "O nome é opcional.").

Exemplos: - Ex.: João Silva
- Ex.: Maria Souza

format_list_numbered

Como usar no dia a dia

1

Filtrar a lista

Preencha os filtros que fizerem sentido: Canal, Data inicial, Data final, Tag, Departamento, Atendente, Situação e IA.
Clique em Filtrar.

2

Limpar filtros

Clique em Limpar para voltar para a lista sem filtros.
Se não aparecer nada, pode ser só filtro demais.

3

Abrir uma conversa

Clique no Nome do contato para abrir a conversa.
O link abre a conversa pelo botão/atalho de conversa.

4

Editar o nome do contato/conversa

Clique no ícone de lápis ao lado do nome.
Digite o novo nome.
Clique em para salvar ou em X para cancelar.

5

Ativar ou desativar IA na conversa

Clique no botão com o ícone de chat automático.
O estado muda entre ativo e inativo.
Quando a troca dá certo, aparece: "Alteração realizada com sucesso!"

6

Criar "Novo contato/conversa" por lista de números

Clique em Novo contato/conversa.
Na etapa 1. Números, cole a lista e confirme em Confirmar números.
Na etapa 2. Nomes (opcional), preencha nomes (se quiser) e clique em Salvar e criar conversas.
Na etapa 3. Relatório, confira o resumo e clique em Fechar.

7

Importar contatos por planilha

Clique em Importar e selecione um arquivo .xls ou .xlsx.
Aguarde Processando.
Depois, confira o Relatório de Importação e use os filtros: Todos, Novos, Atualizados, Ignorados, Erros.

8

Exportar e baixar uma planilha

Clique em Exportar.
Aguarde Processando e baixe o arquivo.
Para ver um modelo, clique em Planilha Exemplo.

notes

Regras e comportamentos que aparecem no uso

  • Os filtros funcionam com os botões Filtrar e Limpar.
  • No cadastro em massa, a lista aceita números separados por vírgula, quebra de linha ou espaço.
  • Na criação em massa, o nome é opcional: sem nome, a conversa é criada só com o número.
  • Na importação, o arquivo aceito é .xls ou .xlsx.
  • Durante importação/exportação/criação, alguns botões mostram Processando ou Salvando.
  • O relatório mostra status como Novo, Atualizado, Ignorado e Erro.
  • Quando não há itens no relatório, aparece "Nada para exibir".
bug_report

Problemas comuns e como resolver

errorMensagem: "Nenhum contato encontrado com os filtros selecionados."

Causa provável: Filtros muito restritos (ex.: Tag/Departamento/IA junto com datas).

Como corrigir: Clique em Limpar.
Aplique apenas 1 ou 2 filtros e clique em Filtrar de novo.

Como confirmar: A lista volta a mostrar contatos, ou a mensagem deixa de aparecer.

errorMensagem ao criar contatos: "Adicione ao menos um número válido para continuar."

Causa provável: Nenhum número foi inserido na lista, ou os números não foram reconhecidos como válidos.

Como corrigir: Cole os números no campo "Adicione os números com DDD e pressione Enter".
Use separação por vírgula, quebra de linha ou espaço.
Confira o Total de números válidos e tente Confirmar números novamente.

Como confirmar: O contador Total de números válidos fica maior que zero e a etapa avança para 2. Nomes (opcional).

errorMensagem: "Nenhum contato disponível para salvar."

Causa provável: A etapa de nomes foi aberta sem itens na lista.

Como corrigir: Clique em Voltar.
Adicione números na etapa 1. Números e confirme novamente.

Como confirmar: A tabela da etapa 2. Nomes (opcional) mostra os números na coluna Número.

errorMensagem: "Nenhum número válido encontrado para salvar."

Causa provável: Os itens inseridos não foram aceitos como números válidos.

Como corrigir: Volte para a etapa 1. Números.
Remova entradas estranhas e cole novamente números com DDD.
Confirme que existe Total de números válidos antes de salvar.

Como confirmar: Ao clicar em Salvar e criar conversas, o sistema gera o Relatório da criação de conversas.

errorMensagem: "Erro ao alterar o modo de resposta da IA"

Causa provável: Falha na troca do estado da IA naquele momento.

Como corrigir: Tente clicar novamente no botão de chat automático.
Se persistir, atualize a lista e tente de novo.

Como confirmar: Aparece "Alteração realizada com sucesso!" e o botão fica no estado esperado (ativo/inativo).

notes

O que muda quando usar

Alterações no sistema: Editar o nome muda o Nome mostrado na lista.
Alternar IA muda o estado de Modo IA (ex.: IA Ativa / IA Desativada).
Excluir remove completamente o contato e sua respectiva conversa (texto de confirmação: "Tem certeza que deseja excluir completamente o contato ... e sua respectiva conversa?").
Importar e criar em massa podem gerar resultados diferentes por item: Novo/Criada, Atualizado/Já existia, Ignorado/Ignorada ou Erro.
Exportar baixa uma planilha com os dados (ex.: contatos.xlsx).

Nenhum item informado.

Logs: Para conferir o resultado, use os relatórios: Relatório de Importação e Relatório da criação de conversas, com contadores de Novos/Criados, Atualizados/Já existiam, Ignorados e Erros.

notes

Tour rápido pelos elementos principais

  • Filtros e ações: Preencha filtros como Canal, Data inicial/final, Tag, Departamento, Atendente, Situação e IA.
    Use Filtrar e Limpar.
    Use Importar, Exportar e Planilha Exemplo.
  • Lista de contatos: As colunas mostram Nome, Canal, Telefone, Instagram, Facebook, Tags, Data Última Msg e NPS.
    Quando não existe informação, aparece -.
  • Ações por contato: Clique no lápis para editar o nome.
    Use o botão de chat automático para alternar IA.
    Use o botão de comentários para ir para a conversa.
    Use o botão de lixeira para excluir.
  • Criar contatos/conversas (wizard): O fluxo tem 1. Números, 2. Nomes (opcional) e 3. Relatório.
    Botões do rodapé mudam conforme a etapa: Confirmar números, Salvar e criar conversas, Voltar e Fechar.
  • Relatório de Importação: Mostra cartões de resumo: Nº Contatos, Novos, Atualizados, Ignorados e Erros.
    Filtre por Todos/Novos/Atualizados/Ignorados/Erros.
    Use Anterior/Próxima para navegar quando houver várias páginas.