contact-types

Catálogo de códigos de tipo de contato de pessoa (por exemplo, telefone, e-mail, WhatsApp) com nomes localizados, usado para classificar entradas de contato nos registros de pessoa.

Caminho de origem: libraries/crm/src/contact-type

Arquivo do módulo: contact-type.module.ts

Introdução

O submódulo Contact Types gerencia o pequeno catálogo de referência para o qual as entradas de contato de cada pessoa apontam via contact_type_id. Cada entrada associa um código estável (por exemplo, "mobile", "email") a um nome de exibição traduzido por locale, de modo que o painel de admin possa renderizar um rótulo amigável no idioma do usuário enquanto a lógica da aplicação e o mapeamento de importação de CSV correspondem ao código estável, e não à tradução. Essa separação significa que o nome de exibição de um tipo de contato pode ser retraduzido ou renomeado a qualquer momento sem quebrar as referências nos registros de contato de pessoas existentes.

Ao contrário de Relation Types, os tipos de contato são um catálogo totalmente mutável — administradores podem criar, atualizar e excluir entradas através dos endpoints CRUD padrão deste submódulo, tornando simples adicionar um novo canal (por exemplo, "Telegram" ou "Signal") à medida que as necessidades de comunicação da organização evoluem.

Endpoints HTTP

5 endpoints

Lista paginada de tipos de contato de pessoa.

Query: page, pageSize, search

Obtém um único tipo de contato por ID.

Params: id (int)

Cria um novo tipo de contato.

Body

Field	Type	Required	Notes
code	string	yes	—
locale	Record<string, { name: string }>	yes	e.g. { "en": { "name": "..." } }

Atualiza um tipo de contato (mesmos campos da criação, todos opcionais).

Params: id (int)

Exclui um ou mais tipos de contato.

Body

Field	Type	Required	Notes
ids	number[]	yes	IDs to delete

Ferramentas MCP

Ferramentas nomeadas que podem ser chamadas por modelos de IA através do Model Context Protocol (MCP).

crm.contact-types.list
Lista tipos de contato de pessoa (por exemplo, mobile, email, WhatsApp) com paginação
crm.contact-types.get
Retorna um único tipo de contato por ID
crm.contact-types.create
Cria um novo tipo de contato com nome multi-locale
crm.contact-types.update
Atualiza um tipo de contato existente por ID
crm.contact-types.delete
Exclui um ou mais tipos de contato pelos seus IDs