جهات الاتصال

curl -X POST https://whats.azzamkh.sa/api/v1/contacts \
  -H "Authorization: Bearer $WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+9665XXXXXXXX",
    "name": "سارة الأحمد",
    "email": "sara@example.com",
    "locale": "ar",
    "opt_in_status": "opted_in",
    "tags": ["vip"],
    "attributes": { "customer_id": "A-10428" }
  }'

# 201 Created
# { "id": "cnt_...", "phone": "+9665XXXXXXXX", "source": "api", ... }

# The number already exists and is live:
# 409 { "error": { "code": "CONTACT_ALREADY_EXISTS",
#                  "details": { "contact_id": "cnt_..." } } }

# The file travels base64-encoded inside JSON. There is no multipart route.
CONTENT=$(base64 < contacts.csv | tr -d '\n')

curl -X POST https://whats.azzamkh.sa/api/v1/contacts/import \
  -H "Authorization: Bearer $WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"filename\": \"contacts.csv\",
    \"format\": \"csv\",
    \"content\": \"$CONTENT\",
    \"dry_run\": true,
    \"default_calling_code\": \"966\"
  }"

# 202 Accepted — the import runs in the background. Poll it:
curl https://whats.azzamkh.sa/api/v1/contacts/imports/imp_... \
  -H "Authorization: Bearer $WA_API_KEY"

# {
#   "id": "imp_...",
#   "status": "completed",
#   "dry_run": true,
#   "progress": { "total_rows": 1200, "processed_rows": 1200, "fraction": 1 },
#   "result": { "created": 1140, "updated": 48, "duplicates": 52, "invalid": 8 },
#   "errors": [
#     { "row": 74, "column": "phone", "reason": "invalid_phone", "value": "05x1234" }
#   ]
# }