# Campos customizados

> Os dados extras do cadastro dos membros (empresa, cargo, cidade, tipo de ingresso) - tipos, obrigatório, quem vê e quem edita, o pedido para completar o cadastro no acesso e a variável nas campanhas.

**Campos customizados** são os dados que a comunidade quer guardar de cada membro além de nome, e-mail e telefone: empresa, cargo, cidade, data de nascimento, tipo de ingresso. A equipe cria os campos uma vez; os valores aparecem na ficha de cada membro, no perfil da própria pessoa e nas campanhas de e-mail.

## Para que serve

| Comunidade | Campos |
|---|---|
| Associação | *Empresa*, *Cargo*, *Número de associado* |
| Evento | *Tipo de ingresso* (seleção), *Cidade* |
| Escola | *Turma*, *Data de matrícula* |
| Coworking | *Andar*, *Tem vaga de garagem* (sim/não) |

## Como funciona

### Os tipos

| Tipo | Para quê | Exemplo |
|---|---|---|
| **Texto** | Qualquer texto curto | Empresa |
| **Número** | Um número | Número de associado |
| **Data** | Uma data | Data de nascimento |
| **Seleção** | Uma opção de uma lista (pelo menos duas) | Tipo de ingresso: VIP, Presencial, Online |
| **Sim/não** | Uma resposta de sim ou não | Tem vaga de garagem |

O tipo **não muda** depois que algum membro tem valor preenchido: *"O tipo não muda depois que há valores preenchidos."*

### Obrigatório

Um campo **Obrigatório** precisa ser preenchido por todos. Quem estiver sem o valor (membro antigo, importado ou novo) vê, no **próximo acesso** à comunidade, a janela **Complete seu cadastro** (*"{nome da comunidade} pede estas informações para você seguir."*) e só segue depois de preencher e clicar em **Salvar e continuar**. Quem preferir pode **Sair**.

A [importação por planilha](/membros/importar-membros) nunca barra uma linha por campo obrigatório vazio; a pessoa completa no primeiro acesso.

### Quem vê e quem edita

| Quem | Vê | Edita os valores |
|---|:-:|:-:|
| Proprietário, administrador e moderador | De todos | De todos |
| Financeiro | De todos | Só os próprios |
| O próprio membro | Os seus | Os seus |
| Outro membro | — | — |

Criar, editar, reordenar e apagar **campos** é do proprietário e do administrador. O moderador e o financeiro veem a aba só para consulta: *"Você vê os campos, mas só owner e admin os criam, editam ou apagam."*

Os campos não aparecem no perfil público: outro membro não vê a empresa nem o cargo de ninguém.

> [!TIP]
> A própria tela lembra: *"Não peça dado sensível (saúde, religião, documentos) sem necessidade."*

### Onde os valores aparecem

- **Ficha do membro** (equipe): em **Administração › Membros**, ao editar a pessoa, a seção **Informações adicionais**, com **Salvar informações**. Para quem entrou por importação, ali também aparece *"Origem: importação por planilha em …"*.
- **Minha Conta** (o próprio membro): o cartão **Informações adicionais**, *"Campos que a comunidade pede no cadastro."*
- **Campanhas de e-mail:** cada campo vira uma variável (abaixo).

### Nas campanhas

Cada campo vira a variável `{{campo_<chave>}}`, em que a chave é o nome do campo sem acento, em minúsculas e com `_` no lugar do espaço: o campo *Empresa* vira `{{campo_empresa}}`, *Tipo de ingresso* vira `{{campo_tipo_de_ingresso}}`. Também vale `{{field_<chave>}}`. A chave nasce com o campo e não muda, mesmo que o nome mude depois.

No editor, **Inserir variável** mostra os campos no grupo **Campos da comunidade**, com o nome certo. O valor sai formatado para quem recebe: data no idioma da pessoa, sim/não traduzido, seleção pela opção. Para quem não tem o valor, use o texto de reserva: `{{campo_empresa|sua empresa}}`. Ver [Variáveis por destinatário](/notificacoes/campanhas-de-email#variaveis-por-destinatario).

### Apagar um campo

O campo some da aba, da ficha, do perfil e das variáveis de campanha. Os valores já preenchidos **continuam guardados**. Uma campanha que ainda use a variável de um campo apagado é recusada ao salvar ou enviar.

## Passo a passo

*Papel: proprietário ou administrador.*

1. **Administração › Membros**, aba **Campos customizados**, botão **Novo campo**.
2. **Nome do campo** (ex.: *Empresa*) e **Tipo**. Numa **Seleção**, escreva as **Opções** (**Adicionar opção** para mais uma).
3. Marque **Obrigatório** se todos precisam preencher.
4. **Salvar**. Use **Subir** e **Descer** para mudar a ordem em que os campos aparecem na ficha e no perfil.

Para preencher o valor de alguém: **Administração › Membros**, edite a pessoa e use **Informações adicionais**.

## Exemplos

**Associação pedindo a empresa.** O administrador cria *Empresa* (Texto, obrigatório). No próximo acesso, cada associado vê **Complete seu cadastro** e preenche. A campanha do congresso abre com *"{{nome}}, a {{campo_empresa|sua empresa}} já garantiu a vaga?"*.

**Evento importando o tipo de ingresso.** Na [importação](/membros/importar-membros), a coluna *Tipo de ingresso* vai para **+ Novo campo customizado**; a Memberfy sugere **Seleção**, porque os valores se repetem. Depois, a equipe vê na ficha de cada pessoa se ela é VIP, Presencial ou Online.

## Erros comuns e como resolver

| Mensagem | O que fazer |
|---|---|
| *Dê um nome ao campo.* | Preencha o **Nome do campo** |
| *Uma seleção precisa de pelo menos duas opções.* | Adicione outra opção |
| *Preencha {campo}.* | O campo é obrigatório e não pode ficar vazio |
| *Só leitura: owner, admin e moderador editam estes valores.* | O financeiro só vê os valores dos outros |
| O tipo não aparece para trocar | Já há valores preenchidos; crie um campo novo |

## Perguntas frequentes

**O membro vê os campos dos outros?**
Não. Cada membro vê só os seus; a equipe vê os de todos.

**Posso filtrar o público de uma campanha por um campo?**
Ainda não. Por enquanto, use [Tags](/membros/tags) ou [Grupos](/membros/grupos-e-organograma) para separar pessoas.

## Pelo assistente

`list_member_fields`, `create_member_field`, `update_member_field`, `reorder_member_fields`, `delete_member_field` (pede confirmação) e `update_member_field_values`. Ver [Ferramentas · Membros](/mcp/ferramentas-membros#campos-customizados).

## Na API

`GET` e `POST /api/member-fields`, `PATCH` e `DELETE /api/member-fields/{id}`, `PUT /api/member-fields/order` e `PUT /api/profiles/{profileId}/fields`. Os valores vêm em `fields` de `GET /api/profiles/{id}`, só para a equipe e o próprio membro. Ver [Member Fields](/api/referencia/member-fields) na Referência da API.

## Relacionados

- [Importar membros por planilha](/membros/importar-membros)
- [Gerenciar membros](/membros/gerenciar-membros)
- [Campanhas de e-mail](/notificacoes/campanhas-de-email)