العمل مع العملاء المحتملين

curl https://api.linkiasoft.com/api/v1/lead-stages \
  -H "x-api-key: $LINKIA_API_KEY" \
  -H "X-Tenant-Id: $LINKIA_TENANT_ID"

[
  { "key": "new",       "name": "New",       "position": 0, "is_default": true },
  { "key": "qualified", "name": "Qualified", "position": 1 },
  { "key": "won",       "name": "Closed Won", "position": 2, "is_won": true },
  { "key": "lost",      "name": "Closed Lost", "position": 3, "is_lost": true }
]

curl "https://api.linkiasoft.com/api/v1/leads?status=qualified&limit=20" \
  -H "x-api-key: $LINKIA_API_KEY" \
  -H "X-Tenant-Id: $LINKIA_TENANT_ID"

{
  "data": [
    {
      "id": "5e6f7a8b-9c0d-4e1f-2a3b-4c5d6e7f8a9b",
      "name": "Ahmed Hassan",
      "company_name": "Acme Trading",
      "phone": "201001234567",
      "status": "qualified",
      "value": 25000,
      "currency": "EGP",
      "assigned_to_user_id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20,
  "totalPages": 3,
  "hasMore": true
}

curl -X PATCH https://api.linkiasoft.com/api/v1/leads/$LEAD_ID \
  -H "x-api-key: $LINKIA_API_KEY" \
  -H "X-Tenant-Id: $LINKIA_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "status": "won" }'

{ "value": 25000, "currency": "EGP", "priority": "high", "expected_close_date": "2026-09-30" }

curl -X POST https://api.linkiasoft.com/api/activities/lead/$LEAD_ID \
  -H "x-api-key: $LINKIA_API_KEY" \
  -H "X-Tenant-Id: $LINKIA_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "activity_type": "call",
    "subject": "Discussed pricing",
    "activity_date": "2026-07-25T10:30:00Z",
    "duration_minutes": 15,
    "outcome": "follow_up_needed"
  }'

curl https://api.linkiasoft.com/api/contacts/customer/$CUSTOMER_ID \
  -H "x-api-key: $LINKIA_API_KEY" \
  -H "X-Tenant-Id: $LINKIA_TENANT_ID"