# Contatos: criar, listar, buscar e atualizar

Contatos representam pessoas atendidas pela IAra. Use `identifier` para vincular o contato ao ID do seu sistema externo.

## Criar contato

```bash
curl -X POST "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/contacts" \
  -H "api_access_token: $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria Cliente",
    "email": "maria@cliente.com",
    "phone_number": "+5554999999999",
    "identifier": "crm-12345",
    "custom_attributes": {"origem":"digi2b.com"}
  }'
```

## Listar e buscar

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

curl -X GET "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/contacts/search?q=maria@cliente.com" \
  -H "api_access_token: $API_TOKEN"
```

## Atualizar

```bash
curl -X PUT "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/contacts/123" \
  -H "api_access_token: $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Maria Cliente", "custom_attributes":{"plano":"premium"}}'
```

## Boas praticas

Busque antes de criar, normalize telefone com DDI e mantenha `identifier` estavel. Evite criar duplicidade quando o mesmo contato chega por canais diferentes.