Pessoas

📄️Listar pessoas

**Escopo:** `pessoas:ler`.

📄️Criar pessoa

Sempre cria: a API nunca procura duplicatas (a unificação é manual, na tela).

📄️Obter pessoa (com contatos WhatsApp, tags e campos)

**Escopo:** `pessoas:ler`.

📄️Atualizar dados da pessoa

**Escopo:** `pessoas:escrever`.

📄️Substituir as tags da pessoa

**Escopo:** `pessoas:escrever`.

📄️Gravar campos personalizados da pessoa

**Escopo:** `pessoas:escrever`.

📄️Marcar opt-out (LGPD)

Só liga o opt-out e cancela follow-ups e fluxos. Desfazer é da própria pessoa ou da tela do núcleo.

📄️Buscar aniversariantes

**Escopo:** `pessoas:ler`.

📄️Prévia de aniversariantes

**Escopo:** `pessoas:ler`.

📄️Listar tags de pessoa

**Escopo:** `pessoas:ler`.

📄️Listar campos personalizados

entidade=pessoa exige pessoas:ler; entidade=oportunidade exige crm:ler.