Làm giàu API bên thứ ba
Xây dựng trên yêu cầu HTTP cơ bản từ phần trước, ở đây chúng ta sẽ làm giàu mỗi lead với dữ liệu từ lên tới 2 dịch
vụ bên ngoài- hình ảnh công ty (e.g, Clearbit) và hình ảnh cá nhân (e.g, FullContact). Bạn sẽ học làm cách nào để:
1. Móc xích nhiều lời gọi API trong một dòng làm việc đơn.
2. Sáp nhập các payloads JSON khác nhau thành một record kết hợp.
3. Xử lí dữ liệu từng phần và bị mất êm ái.
B. Thêm lời gọi làm giàu thứ hai
1. Kéo một HTTP Request node thứ hai vào canvas và đặt tên nó là HTTP_Request_Person.
2. Kết nối HTTP_Request_Enrichment → HTTP_Request_Person
3. Cấu hình HTTP_Request_Person
+ HTTP Method: GET
+ URL:
https://api.fullcontact.com/v3/person.enrich?email={{ $json.email }}
+ Xác thực: chọn FullContact_API_Creds của bạn (OAuth hay API key).
+ Các tùy chọn:
– Hình thức trả lời: JSON
– Trả lời đầy đủ:❌ unchecked (chúng ta chỉ cần JSON body)
4. Test bằng cách thực thi node và đảm bảo bạn nhận các trường như fullName , location , linkedinProfiles .
C. Sáp nhập 2 trả lời làm giàu
1. Thêm một Merge Node tên Merge_Enrichment .
2. Kết nối cả hai yêu cầu:
HTTP_Request_Enrichment → Merge_Enrichment (Input 1)
HTTP_Request_Person → Merge_Enrichment (Input 2)
Merge Mode:
+ Kết hợp
+ Các tùy chọn:
– Đặc tính: json
– Keep Only Set: ✅ checked
Cái này sinh ra một vật đơn JSON của nó chứa cả dữ liệu công ty cá nhân dưới các keys riêng biệt.
D. Thường hóa & kết hợp các trường
1. Thêm một Function node tên Function_Combine .
2. Kết nối
Merge_Enrichment → Function_Combine
3. Function Code:
/**
* Consolidate enrichment data under one schema
*/
const data = items[0].json;
return [{json: {
// Original lead fields
leadId: data.leadId,
email: data.email,
fullName: data.fullName || data.name,
// Company info
companyName: data.name || ”,
companyDomain: data.domain || ”,
employeeCount: data.metrics?.employees || null,
// Person info
personName: data.fullName || ”,
personLocation: data.location || ”,
linkedIn: data.linkedinProfiles?.[0]?.url || ”,
// Merge any additional fields under `rawEnrichment`
rawEnrichment: { …data }}
}];
4. Thực thi và thẩm tra Output → JSON để khẳng định tất cả các trường được kết hợp đúng đắn.
E. Hạn chế & Tips
+ Hạn chế tốc độ qua nhiều APIs
– Nếu bạn vượt quá các rate limits, làm có thể thử lại mức node (xem các học phần trước) trên cả hai HTTP nodes.
+ Dữ liệu từng phần
– Sử dụng móc xích tùy chọn (?.) trong Function node của bạn để tránh các lỗi khi một dịch vụ không trả về dữ
liệu.
+ Song song & tuần tự
+ Cho hiệu suất, bạn có thể thực thi cả 2 HTTP requests song song bằng cách sử dụng 2 rẽ nhánh SplitInBatches –
một cho mỗi dịch vụ – và sau đó sáp nhập chúng quay lại.
Với làm giàu dịch vụ đôi tại chỗ, mỗi lead record bây giờ chứa dữ liệu công ty và cá nhân sâu – sẵn sàng cho
chập vào CRM của bạn trong phần sau.