Skip to main content

​
Contatos

A seção Contatos exibe todos os números que já interagiram com sua instância WhatsApp. É possível buscar, filtrar, organizar com tags, importar e exportar a base.

​
Informações por Contato

​
Busca e Filtros

​
Ações por Contato

​
Ações em Massa

Selecione múltiplos contatos usando as checkboxes para:
  • Aplicar tag em todos os selecionados
  • Remover tag de todos os selecionados
  • Exportar os contatos selecionados (CSV)
  • Excluir todos os selecionados

​
Importar Contatos

1

Preparar o arquivo CSV ou XLSX

Colunas recomendadas: telefone (obrigatório), nome, email, empresa, cargo, observações, tags, metadados.O telefone deve estar em formato internacional: 5511999999999.
2

Acessar importação

Em /u/chat/contacts, clique em Importar. Faça upload do arquivo.
3

Mapear colunas

O sistema detecta as colunas automaticamente. Confirme ou ajuste o mapeamento — inclusive as duas colunas opcionais:
  • Etiquetas (tags): nomes separados por vírgula. Cria tags coloridas e vincula ao contato. Ex.: vip, lead-quente.
  • Metadados (customLabels): pares chave=valor separados por ;. Gravados em contacts.custom_labels (mesmo campo aceito na API pública).
Exemplo de conteúdo da coluna de metadados:
Vira o objeto:
4

Revisar e confirmar

Veja um preview dos dados antes de confirmar. Limite de 1000 contatos por importação.
Telefones já existentes na base são atualizados — não duplicados. Metadados são mesclados com os já existentes (chaves não enviadas são preservadas).

​
Criar / editar contato manualmente

Ao criar ou editar um contato em /u/chat/contacts, o campo Metadados (customLabels) permite adicionar pares chave + valor livres:
1

Abrir a modal

Clique em Novo contato (ou no ícone de editar sobre um contato existente).
2

Adicionar pares

Na seção Metadados (customLabels), clique em + Adicionar par e informe uma chave e um valor por linha. Ex.: contratante = 1346452978.
3

Salvar

Os pares são gravados em contacts.custom_labels (JSONB) — a mesma estrutura usada na API pública e no payload do webhook contact_created / contact_updated.
Contatos antigos que ainda usam o formato de lista aparecem com um aviso “Formato antigo detectado” — basta preencher os valores e salvar para migrar automaticamente.

​
Exportar Contatos

Clique em Exportar para baixar a lista de contatos em formato CSV. O arquivo inclui nome, telefone, e-mail, tags, data da última interação, status e origem. Para exportar um subconjunto, aplique os filtros desejados antes de exportar.

​
Tags (Etiquetas)

Tags são rótulos coloridos para organizar e segmentar contatos. Casos de uso comuns:
  • lead-quente — prospects com alta probabilidade de conversão
  • cliente — clientes ativos
  • vip — atendimento humano exclusivo
  • pagamento-pendente — fatura em atraso
Tags podem ser aplicadas manualmente ou automaticamente via Ações do Agente de IA.
Use tags para filtrar conversas no painel de atendimento. O filtro por etiqueta é combinável com filtros de status.

​
Origem dos Contatos