Estrutura de um contato
Todo contato na Timely tem os seguintes dados de base:| Campo | Descrição |
|---|---|
nome_cliente | Nome completo do contato |
customer_phone | Telefone (identificador principal no WhatsApp) |
customer_email | |
customer_company | Empresa do contato |
position | Cargo |
gender | Gênero (opcional) |
birth_date | Data de nascimento |
state / city | Localização geográfica |
profile_picture_url | Foto de perfil (sincronizada do canal quando disponível) |
Contatos são criados automaticamente quando um número de telefone ou e-mail novo interage com qualquer agente do workspace. O edge function
upsert-contact garante que dados duplicados nunca criem contatos duplicados — ele faz merge inteligente por telefone ou e-mail.Navegando pelos contatos
- Lista
- Busca
- Filtros
A visão padrão exibe todos os contatos em tabela paginada, com colunas configuráveis. Clique em qualquer linha para abrir o perfil completo.
Perfil do contato
Ao clicar em um contato, você vê o painel de perfil dividido em:Dados pessoais
Todos os campos nativos e customizados, editáveis em linha. Mudanças são salvas automaticamente.
Canais vinculados
Badges dos canais pelos quais o contato já se comunicou: WhatsApp, Instagram, Widget. Cada badge mostra o identificador do canal.
Timeline de atividades
Histórico cronológico de conversas, interações com agentes, mudanças de status de lead, tags aplicadas e campos alterados.
Conversas recentes
As últimas threads do contato com link direto para abrir na Inbox. Inclui o agente que atendeu e o status de cada conversa.
Editando um contato
Edite os campos
Clique em qualquer campo para editar. Os campos são inputs em linha — sem necessidade de entrar em modo de edição separado.
Campos customizados
Para adicionar campos personalizados ao perfil:Clique em '+ Novo Campo'
Defina o nome, o tipo de dado (
text, number, date, boolean, select) e se é obrigatório.Configure o campo
Para tipo
select, adicione as opções disponíveis. Para number, defina os limites mínimo e máximo se necessário.Campos customizados também são acessíveis por agentes de IA via ferramentas de leitura e escrita de contato. Isso permite que o agente colete informações estruturadas durante a conversa e as salve automaticamente no perfil.
Importando e exportando
- Importar: suba um CSV com cabeçalhos mapeáveis para os campos do sistema. O
upsertpor telefone ou e-mail evita duplicatas. - Exportar: exporte a lista filtrada atual para CSV ou JSON via o botão no canto superior da tabela. A exportação inclui campos customizados e dados de canais.