Contatos

Armazene e gerencie as pessoas identificadas que conversam com seu agente. Os contatos são criados automaticamente pela verificação de identidade ou adicionados manualmente e por importação de CSV.

Reserved integration fields remain read-only: instagram_username, stripe_customer_id, and source.

Um Contato é uma pessoa identificada que conversou com seu agente — em oposição a um visitante anônimo. Cada Contato é identificado por um ID externo imutável que vem do seu próprio sistema, de modo que a mesma pessoa permanece um único Contato entre sessões e dispositivos.

Encontre seus contatos na aba Contatos do seu agente.

O que um Contato Armazena

Campo	Descrição
External ID	O id imutável do seu sistema (o `sub` do JWT). Único por agente.
Email	O endereço de e-mail do contato.
Name	O nome de exibição do contato.
Phone	O número de telefone do contato.
Custom attributes	Quaisquer dados extras que você anexar (plano, empresa, ids do Stripe, …).
Last seen	Atualizado automaticamente cada vez que o contato conversa.

Os dados do contato são armazenados para você visualizar e segmentar. Por privacidade, eles nunca são injetados nas respostas do agente — veja Verificação de Identidade → Privacidade.

Como os Contatos São Criados

Automaticamente, a partir da verificação de identidade (recomendado)

Quando você habilita a verificação de identidade, seu backend assina um JWT para cada usuário logado. Na primeira vez que um usuário verificado conversa, o Agentkit cria um Contato a partir das claims do token e vincula a conversa a ele. Conversas posteriores atualizam o mesmo Contato e atualizam o Visto por último. Nenhuma chamada de API separada é necessária.

Manualmente

Clique em Adicionar contato, depois digite um ID externo (obrigatório) além de nome, e-mail e telefone opcionais. O External ID deve ser único para o agente.

Por importação de CSV

Use Importar para criar ou atualizar contatos em massa a partir de uma planilha — veja abaixo.

Importando Contatos via CSV

Clique em Importar e envie um arquivo .csv. A primeira linha deve ser uma linha de cabeçalho. Colunas suportadas:

Coluna	Obrigatório	Observações
`external_id`	Sim	Id único por contato. Linhas sem ele são ignoradas.
`name`	Não	Até 255 caracteres.
`email`	Não	Até 320 caracteres.
`phone`	Não	Até 50 caracteres.

external_id,name,email,phone
import-001,Alice Imported,[email protected],+1 555 000 0001
import-002,Bob Imported,[email protected],+1 555 000 0002

Use o link Baixar modelo na caixa de diálogo de importação para obter um arquivo inicial.

Limites e comportamento:

Tamanho máximo do arquivo de 5 MB; até 10.000 linhas por importação.
Se um external_id já existir, a linha atualiza aquele contato em vez de criar uma duplicata.
Após a importação, você verá quantos contatos foram processados e quantos foram ignorados.

Encontrando Contatos

A tabela de Contacts oferece suporte a:

Busca em External ID, e-mail, nome e telefone.
Paginação para listas grandes de contatos.
Um botão de alternância de Colunas para mostrar ou ocultar colunas.