Contatos

Gerencia contatos e conversas: filtra a lista, edita nome, ativa/desativa IA, cria novas conversas e importa/exporta por planilha.

codeAtendimento
labelContatos
schooliniciante
generated
schedule2026-10-01
notes

Para que serve

Use Contatos para gerenciar os contatos da base.
Aplique filtros para localizar conversas mais rápido.
Use Importar e Exportar para trabalhar com planilhas.
Aproveite também para realizar alterações em massa, como adicionar TAGs ou atribuir departamentos a vários contatos de uma só vez.

notes

Resumo rápido

  • Aplique filtros em Canal, datas, Tag, Departamento, Atendente, Situação e IA.
  • Clique em Filtrar para atualizar a listagem e em Limpar para voltar ao padrão.
  • Use Importar para enviar uma planilha (.xls/.xlsx) e depois confira o Relatório de Importação.
  • Use Exportar para baixar os dados de acordo com os filtros selecionados.
  • Clique no ícone de lápis para editar o nome e confirme no check.
  • Use Novo contato/conversa para criar conversas por uma lista de números e um canal.

Resultado esperado: A listagem fica organizada e atualizada, com contatos/conversas criados, editados, importados ou exportados conforme a necessidade.

format_list_numbered

Como usar no dia a dia

1

Filtrar a listagem

Preencha um ou mais filtros (por exemplo Canal, Data inicial e Data final).
Clique em Filtrar.
Para recomeçar, clique em Limpar.

2

Abrir uma conversa

Clique no Nome do contato (link).
Ou clique no botão com ícone de balões de conversa em Ações.

3

Editar o nome do contato/conversa

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

4

Ativar ou desativar a IA da conversa

Clique no botão de IA (ícone com imagem) na coluna Ações.
Aguarde a confirmação de Alteração realizada com sucesso!

5

Excluir completamente um contato e sua conversa

Clique no ícone de lixeira em Ações.
Leia a mensagem de confirmação e confirme a exclusão.

6

Exportar contatos

Aplique os filtros desejados.
Clique em Exportar.
Aguarde Processando e salve o arquivo baixado.

7

Importar contatos por planilha

Clique em Importar.
Selecione uma planilha .xls ou .xlsx.
Aguarde o processamento e confira o Relatório de Importação.

8

Criar novo contato/conversa

Clique em Novo contato/conversa.
Cole ou digite os números e confirme.
Selecione o Canal e avance até o Relatório.

edit_note

Campos e filtros que aparecem

Canal

edit_noteseleção
Opcional

Descrição: Selecione um canal para mostrar apenas contatos/conversas desse canal.
Para ver tudo, deixe em - Todos -.

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

Exemplos: - - Todos -
- Selecionar um canal listado

Data inicial

edit_notedata
Opcional

Descrição: Defina a data inicial para filtrar o período.
Combine com Data final para um intervalo.

Regras/validações: Campo do tipo data.

Exemplos: - 2026-10-01
- 2026-09-15

Data final

edit_notedata
Opcional

Descrição: Defina a data final para filtrar o período.
Combine com Data inicial para um intervalo.

Regras/validações: Campo do tipo data.

Exemplos: - 2026-10-31
- 2026-09-30

Tag

edit_noteseleção
Opcional

Descrição: Use para filtrar contatos por tag.
Para ver contatos sem tag, selecione Sem tags.

Regras/validações: Opções incluem - Não informar -, Sem tags e tags disponíveis.

Exemplos: - Sem tags
- Selecionar uma tag pelo nome

Departamento

edit_noteseleção
Opcional

Descrição: Use para mostrar contatos de um departamento.
Para ver contatos sem departamento, selecione Sem departamento.

Regras/validações: Opções incluem - Não informar -, Sem departamento e departamentos listados (alguns podem aparecer como (inativo)).

Exemplos: - Sem departamento
- Selecionar um departamento da lista

Atendente

edit_noteseleção
Opcional

Descrição: Use para filtrar por atendente.
Para ver conversas sem atendente, selecione - Sem atendente -.

Regras/validações: Opções incluem - Não informar -, - Sem atendente - e atendentes disponíveis.

Exemplos: - - Sem atendente -
- Selecionar um atendente pelo nome

Situação

edit_noteseleção
Opcional

Descrição: Filtra por conversas em aberto ou finalizadas.
Deixe em - 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 na conversa.
Use quando for preciso encontrar apenas conversas com IA ativa, desativada ou em espera.

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
Opcional

Descrição: Use para incluir vários números na criação de contatos/conversas.
Cole uma lista inteira: separada por vírgula, quebra de linha ou espaço.
Confira o contador Total de números válidos.

Regras/validações: Para avançar, aparece o aviso: Adicione ao menos um número válido para continuar.

Exemplos: - 11987654321
- 21999990000

Canal

edit_noteseleção
Obrigatório

Descrição: Selecione o canal usado para criar as conversas.
O aviso informa: Este canal será vinculado a todas as conversas deste processamento.

Regras/validações: Marcado como Obrigatório.
Se não selecionar, aparece o aviso: Selecione um canal para continuar.
Opção inicial: Selecione um canal…

Exemplos: - Selecionar um canal ativo listado
- Manter em Selecione um canal… (não permite continuar)

Nome do contato/conversa (opcional)

edit_notetexto
Opcional

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

Regras/validações: Indicado como opcional.
Placeholder: Ex.: João Silva.

Exemplos: - João Silva
- Maria Souza

notes

Termos que aparecem

  • Canal: Conta/conexão usada para atender (ex.: aparece como o nome do canal na coluna Canal).
    Use para filtrar e também para criar novas conversas no canal certo.
  • Tag: Etiqueta usada para identificar e organizar contatos.
    Exemplo prático: filtrar por uma tag específica ou escolher Sem tags.
  • Departamento: Grupo de atendimento.
    Use para organizar e filtrar conversas por time.
  • Atendente: Pessoa responsável pela conversa.
    Use - Sem atendente - para encontrar conversas não atribuídas.
  • IA: Modo automático de resposta.
    Use o filtro IA Ativa / IA Desativada / Aguardando para localizar conversas por estado.
  • NPS: Pontuação mostrada na coluna NPS.
    Serve como indicador numérico associado ao contato/conversa.
notes

Regras e comportamentos importantes

  • Os filtros só são aplicados ao clicar em Filtrar.
  • Use Limpar para remover todos os filtros de uma vez.
  • A criação manual funciona em etapas: Números e canal → Nomes → Relatório.
  • Na criação manual, o Canal é Obrigatório e vale para todas as conversas do processamento.
  • Na criação manual, o nome é opcional (pode ficar em branco).
  • Em Importar, o arquivo aceito é .xls ou .xlsx.
  • Durante importação/exportação pode aparecer Processando enquanto o sistema trabalha.
bug_report

Problemas comuns e como resolver

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

Causa provável: Os filtros escolhidos não encontram nenhum resultado.

Como corrigir: Clique em Limpar.
Tente novamente usando menos filtros.
Se precisar, filtre por apenas um item (ex.: só Canal ou só Situação).

Como confirmar: A listagem volta a mostrar resultados (ou deixa de exibir a mensagem de nenhum contato).

errorAo criar contatos/conversas aparece: "Adicione ao menos um número válido para continuar."

Causa provável: Nenhum número foi adicionado na lista de números.

Como corrigir: Digite ou cole os números.
Use números com DDD e finalize com Enter.
Se colar uma lista, separe por vírgula, quebra de linha ou espaço.

Como confirmar: O contador Total de números válidos fica maior que zero e o avanço passa de Confirmar números.

errorAo criar contatos/conversas aparece: "Selecione um canal para continuar."

Causa provável: O campo Canal não foi selecionado.

Como corrigir: Abra a lista do campo Canal.
Selecione um canal (não deixe em Selecione um canal…).

Como confirmar: O fluxo avança para a etapa Nomes.

errorAo exportar aparece: "Nenhum contato encontrado para os filtros selecionados."

Causa provável: Não existe resultado para os filtros aplicados na exportação.

Como corrigir: Clique em Limpar e tente exportar sem filtros.
Ou ajuste os filtros para um período/canal mais amplo.

Como confirmar: O download do arquivo acontece após clicar em Exportar.

errorApós importar, aparece a lista com "Erros/Avisos" no relatório

Causa provável: Algumas linhas da planilha não foram aceitas ou precisam de ajuste.

Como corrigir: Abra o Relatório de Importação.
Clique em Erros para ver só o que falhou.
Corrija a planilha e faça a importação novamente.

Como confirmar: No relatório, a contagem de Erros diminui e mais itens aparecem como Novo ou Atualizado.

notes

Tour guiado (o que cada parte faz)

  • Filtros + botões Filtrar/Limpar: Use Canal, Data inicial, Data final, Tag, Departamento, Atendente, Situação e IA.
    Clique em Filtrar para aplicar.
    Clique em Limpar para apagar todos os filtros.
  • Ações principais (planilhas): Clique em Importar para enviar uma planilha (.xls/.xlsx).
    Clique em Exportar para baixar os dados.
    Clique em Planilha Exemplo para baixar um arquivo de exemplo.
  • Listagem de contatos: Confira colunas como Nome, Canal, Telefone, Instagram, Facebook, Tags, Data Última Msg, NPS.
    Em Ações, use:
    - botão de IA (ativa/desativa)
    - ícone de conversa (abrir)
    - ícone de lixeira (excluir)
  • Criar contatos/conversas (assistente em 3 etapas): Etapa 1: cole/adicione números e selecione Canal.
    Etapa 2: preencha Nome do contato/conversa (opcional).
    Etapa 3: confira o Relatório com status como Criada, Já existia, Ignorada e Erro.
  • Relatório de Importação: Use os cards para ver Nº Contatos, Novos, Atualizados, Ignorados e Erros.
    Filtre por Todos / Novos / Atualizados / Ignorados / Erros.
    Use Anterior e Próxima quando houver várias páginas.
    Clique em Fechar para sair.
notes

Receitas rápidas

  • Encontrar conversas resolvidas com IA desativada: 1. Em Situação, selecione Resolvidos.
    2. Em IA, selecione IA Desativada.
    3. Clique em Filtrar.

    Resultado: a listagem mostra apenas o que combina com esses dois filtros.
  • Criar várias conversas de uma vez (lista de números): 1. Clique em Novo contato/conversa.
    2. Cole os números (separados por vírgula, quebra de linha ou espaço).
    3. Selecione o Canal (obrigatório).
    4. Clique em Confirmar números.
    5. (Opcional) Preencha o nome em Nome do contato/conversa (opcional).
    6. Clique em Salvar e criar conversas.

    Resultado: no Relatório, aparece o que foi Criada e o que Já existia.
  • Importar e conferir o que deu erro: 1. Clique em Importar e selecione o arquivo .xls ou .xlsx.
    2. Aguarde o processamento.
    3. No Relatório de Importação, clique em Erros.
    4. Leia a coluna Erros/Avisos.

    Resultado: fica claro quais linhas precisam de ajuste antes de tentar importar de novo.
  • Baixar uma planilha pronta para preencher: 1. Clique em Planilha Exemplo.
    2. Abra o arquivo baixado.

    Resultado: um modelo ajuda a montar a planilha para importação.