Liên hệ — Chi tiết
Lấy đầy đủ thông tin một liên hệ theo ID, bao gồm công ty, cơ hội và hoạt động liên quan.
Endpoint GET /v1/contacts/{id} trả về toàn bộ hồ sơ một liên hệ, kèm các tài nguyên liên quan khi bạn dùng tham số expand.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/contacts/{id} | Chi tiết liên hệ theo ID |
Tham số đường dẫn & truy vấn
| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
id | path | Có | Định danh liên hệ, ví dụ con_8f2a1c9d |
expand | query | Không | Danh sách quan hệ nhúng kèm: company, deals, activities |
Kiểm thử tại chỗ
GET
https://crm-gateways.hitechcloud.vn/v1/contacts/{id}Kiểm thử tại chỗNhập ID liên hệ và Access Token rồi bấm Gửi thử. Token không được lưu lại.
Tham số đường dẫn
Query
cURL lấy chi tiết liên hệ
curl -X GET "https://crm-gateways.hitechcloud.vn/v1/contacts/con_8f2a1c9d?expand=company,deals" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json"Phản hồi (200 OK)
{
"status": "success",
"data": {
"id": "con_8f2a1c9d",
"first_name": "Nguyen",
"last_name": "Van A",
"email": "vana@example.com",
"phone": "0901234567",
"lifecycle_stage": "customer",
"lead_source": "website",
"tags": ["vip"],
"custom_fields": { "ma_so_thue": "0312345678" },
"company": {
"id": "co_4b7e2f10",
"name": "Cong ty TNHH ABC"
},
"deals": [
{ "id": "deal_a19c330e", "title": "Goi Cloud Server", "amount": 24000000 }
],
"created_at": "2026-09-01T08:00:00+07:00",
"updated_at": "2026-10-31T09:40:00+07:00"
}
}Nếu ID không tồn tại hoặc không thuộc tài khoản của bạn, API trả về lỗi
404 NOT_FOUND.Endpoint GET /v1/contacts/{id} trả về toàn bộ hồ sơ một liên hệ, kèm các tài nguyên liên quan khi bạn dùng tham số expand.
Endpoint
| Method | Endpoint | Mô tả |
|---|---|---|
GET | /v1/contacts/{id} | Chi tiết liên hệ theo ID |
Tham số đường dẫn & truy vấn
| Tham số | Vị trí | Bắt buộc | Mô tả |
|---|---|---|---|
id | path | Có | Định danh liên hệ, ví dụ con_8f2a1c9d |
expand | query | Không | Danh sách quan hệ nhúng kèm: company, deals, activities |
Kiểm thử tại chỗ
GET
https://crm-gateways.hitechcloud.vn/v1/contacts/{id}Kiểm thử tại chỗNhập ID liên hệ và Access Token rồi bấm Gửi thử. Token không được lưu lại.
Tham số đường dẫn
Query
Nếu ID không tồn tại hoặc không thuộc tài khoản của bạn, API trả về lỗi
404 NOT_FOUND.cURL lấy chi tiết liên hệ
curl -X GET "https://crm-gateways.hitechcloud.vn/v1/contacts/con_8f2a1c9d?expand=company,deals" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json"Phản hồi (200 OK)
{
"status": "success",
"data": {
"id": "con_8f2a1c9d",
"first_name": "Nguyen",
"last_name": "Van A",
"email": "vana@example.com",
"phone": "0901234567",
"lifecycle_stage": "customer",
"lead_source": "website",
"tags": ["vip"],
"custom_fields": { "ma_so_thue": "0312345678" },
"company": {
"id": "co_4b7e2f10",
"name": "Cong ty TNHH ABC"
},
"deals": [
{ "id": "deal_a19c330e", "title": "Goi Cloud Server", "amount": 24000000 }
],
"created_at": "2026-09-01T08:00:00+07:00",
"updated_at": "2026-10-31T09:40:00+07:00"
}
}