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

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": "[email protected]",
    "phone_number": "+5554999999999",
    "identifier": "crm-12345",
    "custom_attributes": {"origem":"digi2b.com"}
  }'

Listar e buscar

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/[email protected]" \
  -H "api_access_token: $API_TOKEN"

Atualizar

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.