Contatos de empresas
Contatos cadastrados por empresa.
Listar contatos da empresa
Lista os contatos da empresa com seus canais (e-mail, telefone, WhatsApp, outro). Requer a permissão `identity.companies.read`. O `company_id` é o UUID da empresa; empresa removida ou fora do escopo de quem chama retorna `404`. Listagem paginada no envelope `{items, page}` com `limit`/`cursor` (também aceita `sort`, `q` e `filter`).
Criar contato da empresa
Cria um contato (`person`, `department` ou `general`) com 1 a 10 canais; nome é obrigatório exceto para `general`. Marcar `is_primary` torna este o contato principal da empresa. Requer a permissão `identity.companies.create` ou `identity.companies.update`. Limite de 50 contatos por empresa; o `company_id` é o UUID da empresa; empresa removida ou fora do escopo de quem chama retorna `404`.
Consultar contato da empresa
Retorna o contato com seus canais. Requer a permissão `identity.companies.read`. `company_id` e `contact_id` são UUIDs; contato de outra empresa ou fora do escopo retorna `404`.
Atualizar contato da empresa
Altera os campos enviados; quando `channels` é enviado, substitui a lista inteira de canais (1 a 10). Desmarcar o único contato principal não tem efeito. Requer a permissão `identity.companies.update`. `company_id` e `contact_id` são UUIDs; contato inexistente retorna `404`.
Excluir contato da empresa
Exclui o contato e seus canais; responde `204`. Requer a permissão `identity.companies.delete`. `company_id` e `contact_id` são UUIDs; contato inexistente retorna `404`.