TL;DR: Để làm giàu dữ liệu inbound lead bằng AI agent, bạn chỉ cần gửi email và domain từ mỗi lượt đăng ký đến webhook để kích hoạt lượt chạy của agent. Agent sẽ làm giàu thông tin cá nhân qua People Data Labs, dữ liệu công ty qua Apollo, rà soát danh tính đối chiếu với danh sách trừng phạt, chấm điểm độ phù hợp theo ICP và tạo một nhiệm vụ cho từng lead. Đội ngũ của bạn sẽ xem xét mọi lead đạt chuẩn trước khi gửi phản hồi. Bạn trả phí theo từng lead bằng Firecrawl credit thay vì trả phí theo từng tài khoản người dùng (seat).
Mỗi lượt đăng ký mới thường chỉ mang lại hai thông tin hữu ích: địa chỉ email và tên miền công ty. Sau đó, ai đó sẽ phải đưa ra quyết định: Đây là khách hàng tiềm năng thực sự, một sinh viên, đối thủ cạnh tranh, hay một cái tên mà bạn không được phép hợp tác về mặt pháp lý?
Cách xử lý thông thường là mua gói tài khoản (seat) trên các công cụ làm giàu dữ liệu cho mọi nhân sự tham gia sàng lọc lead. Apollo tính phí theo seat và trang định giá của họ lưu ý rằng tất cả các seat trong một tài khoản đều dùng chung một gói dịch vụ. Điều này hoàn toàn hợp lý khi con người trực tiếp thực hiện việc tra cứu. Nhưng khi agent đảm nhiệm khâu tra cứu, người đọc kết quả thậm chí không cần đến một seat nào cả.
Hướng dẫn này sẽ xây dựng quy trình đó trên Sharkly, sử dụng Claude Code hoặc Codex làm môi trường thực thi (runtime) và Firecrawl Alexandria làm tầng dữ liệu (data layer). Mọi mức giá credit dưới đây đều là giá niêm yết của Firecrawl, được ghi nhận vào ngày 3 tháng 11 năm 2026. Chúng tôi không chạy thử với lead thực tế cho bài viết này, vì vậy hãy xem các tổng chi phí như ví dụ tham khảo và hãy kiểm tra lại giá trong playground trước khi kết nối thực tế.
Tại sao nên làm giàu dữ liệu inbound lead bằng AI agent
Làm giàu dữ liệu inbound lead là quá trình bổ sung chức danh, thông tin công ty và mức độ phù hợp của một liên hệ mới trước khi nhân viên phải dành thời gian xử lý. Agent có thể tự động tra cứu, áp dụng các quy tắc của bạn và soạn một bản tóm tắt ngắn gọn. Quyết định phản hồi ai vẫn hoàn toàn do con người nắm giữ.
Có ba điểm khác biệt lớn khi agent đảm nhận việc tra cứu:
- Chi phí tính theo lượng lead thực tế. Chỉ một API key của Firecrawl là đủ dùng cho mọi nhà cung cấp dữ liệu. Mỗi lượt tra cứu đều có giá niêm yết theo credit, và các lượt tra cứu không tìm thấy kết quả từ các nhà cung cấp dưới đây đều hoàn toàn miễn phí.
- Quy tắc được chuẩn hóa thành tệp tin. Tiêu chí ICP của bạn được lưu trong một tệp đã qua kiểm duyệt để agent đọc trong mỗi lượt chạy, chứ không còn phụ thuộc vào trí nhớ hay cảm tính của người đánh giá.
- Mọi lead đều được kiểm tra đồng nhất. Lượt đăng ký thứ 40 trong ngày cũng được rà soát danh sách trừng phạt kỹ lưỡng y như lượt đăng ký đầu tiên.
Tổng quan về quy trình làm giàu dữ liệu inbound lead
| Bước | Nhà cung cấp và tính năng | Giá niêm yết | Miễn phí khi |
|---|---|---|---|
| 1. Webhook kích hoạt lượt chạy | Sharkly Automation | 0 credit | Luôn luôn |
| 2. Làm giàu dữ liệu cá nhân | People Data Labs person/enrich |
60 credit | Độ khớp thấp hơn min_likelihood (404) |
| 3. Làm giàu dữ liệu công ty | Apollo companies/bulk-enrich |
30 credit cho mỗi công ty khớp dữ liệu | Domain không khớp |
| 4. Rà soát danh sách trừng phạt | OpenSanctions (opensanctions-org) |
Kiểm tra bằng find-tools |
Không bao giờ tự mặc định |
| 5. Chấm điểm và phân luồng | Tệp quy tắc của bạn | 0 credit | Luôn luôn |
Bước 1: Webhook kích hoạt quy trình làm giàu dữ liệu
Trong Sharkly, một Automation là một quy tắc thuộc quyền sở hữu của Space, dùng để giao các công việc lặp đi lặp lại cho một Agent hoặc Crew. Một trong những loại trigger (trình kích hoạt) của nó là webhook: một URL bí mật tiếp nhận yêu cầu POST từ dịch vụ khác. Hệ thống backend đăng ký của bạn sẽ gửi thông tin lead mới đến webhook này.
# From your signup handler. The URL is a secret; keep it in your app's env.
curl -X POST "$SHARKLY_LEAD_WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d '{"signup_id": "su_10482", "email": "[email protected]", "domain": "example-corp.com"}'
Sharkly chỉ hiển thị URL đầy đủ một lần duy nhất khi bạn tạo hoặc tạo lại trigger. Sau đó, thẻ trigger sẽ chỉ hiển thị trạng thái URL đang hoạt động. Bạn có thể thêm signing secret để bắt buộc các yêu cầu gửi đến phải vượt qua bước xác thực chữ ký.
Có một chi tiết mang tính quyết định trong thiết kế: một Automation sẽ kích hoạt một lượt chạy của agent chứ không trực tiếp tạo task. Do đó, chỉ dẫn (instruction) sẽ yêu cầu agent tự mình tạo task cho lead khi kết thúc quy trình. Thông tin chi tiết của lượt chạy sẽ lưu lại payload của trigger, giúp bạn theo dõi chính xác dữ liệu ban đầu nhận được của từng lead.
Bước 2: Làm giàu dữ liệu cá nhân từ email
API person/enrich của People Data Labs có giá niêm yết là 60 credit cho mỗi lượt gọi. Bạn chỉ cần cung cấp email làm đầu vào là đủ. Thiết lập giúp kiểm soát chi phí của bạn là min_likelihood, có thang điểm từ 1 đến 10 và mặc định là 2. Nếu tăng chỉ số này lên, các trường hợp khớp thông tin kém chính xác sẽ trả về mã lỗi 404 thay vì một bản ghi dữ liệu. Trang nhà cung cấp của Firecrawl đã nêu rất rõ ràng: “ở đây 404 thì miễn phí, còn bản ghi sai thì không.”
// enrich-lead.mjs: one call per signup, key injected as $FIRECRAWL_API_KEY
const call = (alexandria) =>
fetch("https://api.firecrawl.dev/v2/scrape", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.FIRECRAWL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ alexandria }),
}).then((r) => r.json());
const person = await call({
provider: "people-data-labs",
capability: "person/enrich",
options: { email: lead.email, min_likelihood: 6, titlecase: true },
});
const p = person.alexandria?.[0];
if (p?.error) brief.errors.push(p.error); // check every result before using it
Bản ghi trả về khoảng 150 trường dữ liệu, nhưng bản tóm tắt của bạn chỉ cần 5 trường trong số đó. Với các giá trị mẫu, phần dữ liệu mà agent giữ lại sẽ trông như thế này:
{
"full_name": "Jordan Example",
"job_title": "Director Of Platform Engineering",
"job_company_name": "Example Corp",
"linkedin_url": "linkedin.com/in/placeholder",
"likelihood": 8
}
Bạn cũng cần lưu ý đến hạn mức (quota). Thông qua Alexandria, People Data Labs cho phép mỗi tổ chức khách hàng thực hiện tối đa 50.000 lệnh gọi API mỗi năm trên các endpoint dành cho cá nhân và công ty. Các lượt thử lại (retry) vẫn tính vào hạn mức, và hạn mức sẽ được làm mới vào ngày 1 tháng 1 theo giờ UTC.
Bước 3: Làm giàu dữ liệu công ty từ tên miền (domain)
Dữ liệu công ty của Apollo bao gồm thông tin về vòng gọi vốn, quy mô nhân sự và các công nghệ đang sử dụng. Ví dụ của chính Firecrawl sử dụng tính năng companies/bulk-enrich, cho phép xử lý tối đa 10 domain trong mỗi lượt gọi. Bảng so sánh tháng 10 năm 2026 của Firecrawl niêm yết mức giá 30 credit cho mỗi công ty khớp thông tin, còn các domain không khớp sẽ không bị tính phí.
const company = await call({
provider: "apollo",
capability: "companies/bulk-enrich",
options: { "domains[]": [lead.domain] },
});
const org = company.alexandria?.[0]?.data?.organizations?.[0];
// org.name, org.estimated_num_employees, funding and technology fields
Trang Alexandria của Apollo có liệt kê một skill tích hợp sẵn tên là “CRM account data refresh”. Skill này sẽ làm giàu lại dữ liệu tài khoản theo domain và so sánh các giá trị mới với những gì CRM đang lưu trữ. Đó cũng chính là lệnh gọi API này, chỉ khác là áp dụng cho các tài khoản hiện có thay vì lượt đăng ký mới.
Bước 4: Rà soát lead đối chiếu với danh sách trừng phạt
Danh mục People trên Alexandria tích hợp OpenSanctions — một cơ sở dữ liệu về lệnh trừng phạt, nhân vật chính trị (PEP) và các đối tượng đáng chú ý — cùng với Danh sách Trừng phạt của Vương quốc Anh (UK Sanctions List). Quá trình khám phá (discovery) là miễn phí, vì vậy hãy để agent tự tìm tính năng rà soát và giá của nó trước khi thực hiện lệnh gọi trả phí đầu tiên:
firecrawl find-tools --options '{"providers": ["opensanctions-org"]}' --include-costs
Tính năng dataset của OpenSanctions hiển thị mức giá 5 credit mỗi lượt chạy. Đừng mặc định rằng tìm kiếm thực thể (entity search) cũng có mức giá tương đương; hãy đọc kỹ mức giá mà find-tools trả về. Bạn cũng nên kiểm tra kỹ giấy phép sử dụng. OpenSanctions phát hành dữ liệu theo giấy phép CC BY-NC 4.0 và bán các gói giấy phép riêng cho mục đích sàng lọc doanh nghiệp, vì vậy quy trình xử lý lead thương mại cần có giấy phép phù hợp.
Trường hợp trùng khớp không đồng nghĩa với việc agent sẽ tự động từ chối lead. Thay vào đó, task sẽ được chuyển tiếp cho con người kèm theo toàn bộ thông tin khớp dữ liệu đó.
Bước 5: Chấm điểm độ phù hợp theo ICP của bạn
Bước chấm điểm hoàn toàn không tốn phí vì agent chỉ đọc các trường dữ liệu mà bạn đã trả tiền trước đó. Hãy đưa các quy tắc vào một Sharkly Skill để mọi lượt chạy đều áp dụng chung một tệp quy tắc, đồng thời mọi thay đổi đối với tệp này đều được kiểm duyệt chặt chẽ.
# inbound-icp.md (owner: head of sales)
qualify_if: employees >= 50 AND title in [Director, VP, Head, CTO] AND sanctions_match == false
nurture_if: employees < 50 OR title not senior
disqualify_if: free_email_domain OR known_competitor_domain
on_sanctions_match: route to Sales review with the match, never auto-reply
brief_fields: [name, title, company, employees, funding, score, reason, credits_spent]
Phân luồng lead trên bảng quản lý
Phân luồng chính là điểm mạnh vượt trội của Sharkly. Trạng thái tác vụ có thể tùy chỉnh theo từng loại task, và mỗi trạng thái đều thuộc về một danh mục cố định. Đối với lead, chỉ cần ba trạng thái là đủ:
| Trạng thái | Danh mục | Người phụ trách | Bước tiếp theo |
|---|---|---|---|
| Sales review | Unstarted | Một nhân sự | Bản tóm tắt và thư nháp phản hồi nằm trong task, được duyệt trước khi gửi |
| Nurture | Backlog | Không có | Chờ chiến dịch tiếp theo |
| Disqualified | Canceled | Không có | Lưu lại kèm lý do loại trừ, không thực hiện thêm lượt chạy nào |
Agent sẽ tạo task ở bước cuối cùng của lượt chạy:
sharkly task create \
--title "Lead: Example Corp (Director Of Platform Engineering)" \
--body-file brief.md \
--status "Sales review" \
--assignee <member> --output json
Nhiệm vụ được giao sẽ xuất hiện trong Inbox của người phụ trách dưới dạng tín hiệu Primary (ưu tiên). Nếu agent soạn sẵn phản hồi đầu tiên, bản nháp đó sẽ nằm gọn trong nội dung task. Agent sẽ không bao giờ tự ý gửi đi. Chốt kiểm soát này áp dụng đúng mô hình mà chúng tôi từng chia sẻ trong bài viết về human-in-the-loop coding agents (agent lập trình có con người kiểm duyệt).
Chi tiết chi phí credit cho mỗi lead
Đối với một lead khớp thành công cả hai lượt làm giàu dữ liệu, chi phí niêm yết được tính tổng như sau:
| Lệnh gọi | Credit |
|---|---|
People Data Labs person/enrich |
60 |
Apollo companies/bulk-enrich (1 domain khớp) |
30 |
| Rà soát danh sách trừng phạt | Mức giá từ find-tools |
| Chấm điểm và phân luồng | 0 |
| Tổng cộng trước khi rà soát trừng phạt | 90 |
Theo bảng giá của Firecrawl, gói Hobby có giá 19 USD cho 5.000 credit/tháng, tương đương 0,0038 USD/credit. Như vậy, 90 credit sẽ tiêu tốn 0,342 USD cho mỗi lead. Gói Standard có giá 99 USD cho 100.000 credit, tương đương 0,00099 USD/credit, giúp chi phí cho cùng một lead chỉ còn 0,0891 USD. Hãy bỏ qua bước gọi API công ty đối với các tên miền email miễn phí như gmail.com, nếu không bạn sẽ mất oan 30 credit chỉ để biết số lượng nhân sự của Google.
Với 100 lead khớp dữ liệu mỗi tháng, bạn sẽ tiêu tốn 9.000 credit. Con số này vượt quá mức 5.000 credit của gói Hobby, vì vậy bạn sẽ cần mua thêm credit hoặc nâng cấp lên gói Standard. Hãy làm phép tính này dựa trên lưu lượng thực tế của bạn trước khi đưa ra quyết định chọn gói.
Cần lưu ý một điểm khi so sánh về mô hình tính phí theo seat: Apollo tính phí theo seat, nhưng Clay thì không — trang định giá của Clay hỗ trợ không giới hạn người dùng trên mỗi workspace ở tất cả các gói. Luận điểm ở đây không đơn thuần là "tính phí theo seat là không tốt". Điểm mấu chốt là khi agent đảm nhận việc tra cứu, chi phí sẽ bám sát số lượng lead phát sinh thay vì phụ thuộc vào số lượng người xem báo cáo.
Cách Sharkly liên kết toàn bộ quy trình
Claude Code hoặc Codex sẽ thực thi các lệnh gọi, còn Sharkly giúp toàn bộ quy trình vận hành một cách minh bạch và trực quan.
- Không để lộ API key trong task. Hãy cấu hình
FIRECRAWL_API_KEYtrong phần Biến Môi Trường (Environment Variables) của Agent. Sharkly hiển thị các thiết lập văn bản thô này cho người quản lý Agent, vì vậy hãy sử dụng một key được phân quyền riêng cho tác vụ này. - Agent không tốn phí seat. Trong Sharkly, một seat tương ứng với một người dùng thực tế. Các Agent, Crew, Computer và Runtime đều không chiếm bất kỳ seat nào.
- Mọi lượt chạy đều được lưu vết. Lịch sử chạy của Automation hiển thị đầy đủ payload của trigger, lượt chạy của agent và lý do thất bại nếu có.
Trước khi đưa webhook vào vận hành chính thức, hãy sử dụng tính năng Run now trên Automation với dữ liệu thử nghiệm (test payload). Sau đó, hãy kiểm tra kỹ một vài lượt chạy trước khi bổ sung tính năng tự động soạn phản hồi nháp. Hướng dẫn Automations sẽ giải thích chi tiết về từng loại trigger.
Bắt đầu chỉ với một webhook
Để bắt đầu làm giàu dữ liệu inbound lead bằng agent, hãy đi từng bước nhỏ: Một webhook, một agent, hai lệnh gọi làm giàu dữ liệu, một tệp quy tắc và một trạng thái kiểm duyệt. Hãy thử nghiệm trên 20 lượt đăng ký tiếp theo và đọc kỹ từng bản tóm tắt trước khi có người gửi phản hồi. Bạn có thể bắt đầu với Sharkly hoàn toàn miễn phí, và mức sử dụng mô hình sẽ tính theo gói Claude Code hoặc Codex đã gắn sẵn vào Runtime của bạn.
Câu hỏi thường gặp (FAQ)
Chi phí làm giàu dữ liệu một inbound lead bằng Firecrawl là bao nhiêu?
Theo mức giá niêm yết của Firecrawl, một lead khớp dữ liệu trên cả People Data Labs và Apollo sẽ tốn 90 credit trước khi rà soát danh sách trừng phạt. Con số này tương đương khoảng 0,34 USD ở gói Hobby và 0,09 USD ở gói Standard, thanh toán theo tháng.
Làm giàu dữ liệu thất bại có bị trừ credit không?
Không đối với hai nhà cung cấp này. Kết quả tra cứu trên People Data Labs có độ khớp dưới ngưỡng min_likelihood của bạn sẽ trả về mã lỗi 404 miễn phí, và tính năng làm giàu dữ liệu công ty hàng loạt của Apollo không tính phí cho các domain không khớp.
Agent có thể tự ý phản hồi lead không?
Bạn không nên để agent làm việc này. Agent chỉ tạo task kèm theo bản nháp, và nhân sự phụ trách sẽ trực tiếp gửi phản hồi sau khi đã kiểm duyệt.
OpenSanctions có miễn phí cho mục đích thương mại không?
Không. Dữ liệu của họ được phát hành theo giấy phép CC BY-NC 4.0, và việc rà soát phục vụ doanh nghiệp đòi hỏi phải mua giấy phép thương mại trả phí. Hãy kiểm tra kỹ điều này trước khi đưa vào quy trình bán hàng của bạn.
Tôi có cần mua gói tài khoản (seat) của Apollo cho quy trình này không?
Bạn không cần mua seat cho các lệnh gọi của agent, vì chúng được thực thi thông qua API key của Firecrawl. Firecrawl có thể yêu cầu quản trị viên tổ chức (org admin) chấp thuận các điều khoản dữ liệu của nhà cung cấp trước; mã lỗi tương ứng là THIRD_PARTY_DATA_TERMS_REQUIRED.
Phải làm sao nếu Firecrawl yêu cầu chấp thuận điều khoản ngay giữa lượt chạy?
Phản hồi trả về sẽ kèm theo đường dẫn requiresAction.url. Quản trị viên tổ chức có thể truy cập liên kết đó để chấp thuận điều khoản. Tài liệu của Firecrawl quy định rằng agent cần sự ủy quyền rõ ràng từ người dùng trước khi chấp thuận điều khoản, vì vậy agent nên để task ở trạng thái chờ con người xử lý.
