Contatos e Identidade

O bot pode reconhecer pessoas em canais diferentes: WhatsApp, Telegram, Discord e outros. Isso é importante para memória, permissões, missões e contexto.

Contato não é só telefone

Uma pessoa pode ter várias identidades:

número de WhatsApp
LID do WhatsApp
Telegram ID
Discord ID
outros identificadores de canal

O bot junta essas identidades em um contato só quando consegue confirmar que são a mesma pessoa.

WhatsApp, número e LID

No WhatsApp, uma pessoa pode aparecer de dois jeitos:

pelo número comum
por um identificador chamado LID

Em grupos, é comum aparecer LID. Por isso, ao cadastrar ou reconhecer contato, o sistema tenta resolver automaticamente número ↔ LID quando o WhatsApp/Baileys tem esse mapeamento em cache.

Na prática: a mesma pessoa deve ser reconhecida no privado e no grupo, mesmo quando o WhatsApp mostra identificadores diferentes.

O que fica no banco e o que fica em Markdown

O cadastro técnico do contato fica enxuto no banco: nome, papel, status, identidades, permissões e ponteiro para perfil.

Dados mais narrativos ficam em arquivo Markdown, como:

preferências
biografia
aniversário
localização
empresa
observações duráveis
contexto de relacionamento

Esse perfil costuma ficar em memory/pessoas/..., ligado ao contato por um caminho de perfil.

Nota para administradores

No banco, o cadastro é separado em duas partes:

bot_contacts — registro enxuto do contato: nome, papel, status, notas curtas, permissões e profile_path
bot_contact_identities — identidades por canal: WhatsApp, WhatsApp LID, Telegram, Discord etc.

Dados narrativos e biográficos — preferências, aniversário, localização, empresa, tags e contexto — devem ficar no Markdown de perfil, normalmente em memory/pessoas/..., apontado pelo profile_path.

Permissões e papéis

Alguns contatos podem ter papéis diferentes:

dono
administrador
operador
contato comum
desconhecido

Isso controla o que cada pessoa pode pedir. Falar “eu sou admin” no chat não basta; o bot confia na identidade e nas permissões registradas.

Boas práticas

Se mudou de número, diga claramente
Se o bot confundiu duas pessoas, avise
Se entrou alguém novo no grupo, o bot pode perguntar o nome antes de guardar contexto
Dados sensíveis devem ser tratados com cuidado; ter acesso técnico não significa permissão para expor