# Contatos: filtros, labels, merge e contact inboxes

A API de contatos tambem cobre filtros, etiquetas, mesclagem e relacao entre contato e caixa de entrada.

## Filtros de contato

Use `/contacts/filter` para consultas estruturadas quando a busca simples nao for suficiente. Exemplos: contatos por atributo, canal, data ou estado de cadastro.

## Etiquetas do contato

```bash
curl -X POST "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/contacts/123/labels" \
  -H "api_access_token: $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"labels":["cliente-premium", "api"]}'
```

A atualizacao de labels pode substituir a lista existente. Leia a resposta e preserve etiquetas que nao devem ser removidas.

## Contactable inboxes

Use `/contacts/:id/contactable_inboxes` para descobrir em quais caixas o contato pode ser acionado.

```bash
curl -X GET "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/contacts/123/contactable_inboxes" \
  -H "api_access_token: $API_TOKEN"
```

## Contact inbox

Use `/contacts/:id/contact_inboxes` para criar vinculo entre contato e inbox quando o fluxo exigir e o usuario tiver permissao.

## Merge

Use merge apenas quando tiver certeza de que dois contatos representam a mesma pessoa. Depois da mesclagem, o contato secundario e removido.

## Cuidados

Mesclagem e etiquetas afetam a operacao do atendimento. Registre quem fez a alteracao, IDs envolvidos e motivo.