Unit 2/3 · ~14 phút · +300 điểm
Tích hợp: API, webhook và công cụ nối
Mục tiêu học tập
Sau khi hoàn thành bài này, bạn có thể:
- Giải thích sự khác nhau giữa gọi API và nhận webhook bằng ví dụ marketing
- Mô tả cách công cụ nối như n8n, Zapier, Make xây một luồng trigger và action
- Thiết lập một luồng tích hợp an toàn: bảo vệ khóa API, xử lý lỗi và tránh tạo trùng dữ liệu
Bài trước đã giúp bạn chọn công cụ theo giai đoạn. Nhưng một CRM tốt, một công cụ email tốt và một website tốt vẫn có thể là ba hòn đảo nếu không nối với nhau. Bài này giải thích ba khái niệm mà người dẫn dắt team marketing nên hiểu đủ để nói chuyện với đội kỹ thuật: API, webhook và công cụ nối. Bạn không cần biết lập trình, nhưng cần biết hỏi đúng câu.
API: hỏi khi cần
API (Application Programming Interface) là “cửa giao dịch” mà một phần mềm mở ra cho phần mềm khác. Qua API, hệ thống A có thể đọc, tạo, sửa dữ liệu trong hệ thống B theo các quy tắc B đặt ra. Ví dụ: “tạo một lead với tên, email, nguồn này”, “lấy danh sách liên hệ cập nhật hôm nay”.
Đặc điểm: API hoạt động khi bên gọi chủ động hỏi. Muốn biết có gì mới, bạn phải gọi. Một số khái niệm đi kèm:
- Xác thực: bên gọi chứng minh mình được phép, thường bằng khóa API (API key) hoặc OAuth (người dùng đăng nhập và cấp quyền cho ứng dụng).
- Giới hạn tần suất (rate limit): mỗi phút hay mỗi ngày chỉ được gọi bao nhiêu lần.
- Endpoint: địa chỉ cụ thể cho từng loại thao tác, ví dụ một địa chỉ để tạo lead, một địa chỉ để lấy danh sách deal.
Webhook: báo khi có chuyện
Webhook đi theo chiều ngược lại. Bạn đăng ký với hệ thống A một địa chỉ URL. Mỗi khi có sự kiện (form mới, deal chuyển giai đoạn, khách bấm link), A tự động gửi dữ liệu sự kiện đó tới URL của bạn.
| Gọi API định kỳ (polling) | Webhook | |
|---|---|---|
| Ai chủ động? | Bên nhận phải hỏi liên tục | Bên có sự kiện tự gửi |
| Độ trễ | Phụ thuộc chu kỳ hỏi (5 phút, 1 giờ…) | Gần như ngay lập tức |
| Tốn tài nguyên | Nhiều lần hỏi không có gì mới | Chỉ gửi khi có sự kiện |
| Ví dụ marketing | Mỗi giờ lấy danh sách người hủy đăng ký email | Form website gửi lead ngay khi khách bấm “Gửi” |
Thực tế, một luồng tích hợp thường dùng cả hai: nhận webhook từ nguồn, rồi gọi API của đích.
Công cụ nối: n8n, Zapier, Make
Viết code tích hợp cho từng cặp hệ thống rất tốn công. Công cụ nối (còn gọi là iPaaS hay công cụ tự động hóa quy trình) cho phép bạn kéo thả luồng mà không cần lập trình nhiều. Chúng cùng một tư duy:
- Trigger: điều kích hoạt luồng, ví dụ nhận webhook, có dòng mới trong Google Sheets, theo lịch mỗi sáng.
- Action: việc cần làm, ví dụ tạo lead trong CRM, gửi tin nhắn cho sales, ghi log.
- Điều kiện và biến đổi: lọc, rẽ nhánh, chuẩn hóa số điện thoại, ghép họ tên.
Zapier
Dễ bắt đầu, rất nhiều ứng dụng kết nối sẵn, tính phí theo số tác vụ
Make
Giao diện sơ đồ trực quan, mạnh khi luồng có nhiều nhánh
n8n
Có thể tự cài trên máy chủ riêng, linh hoạt, cần người có chút kỹ thuật
Cách tính phí và tính năng của các công cụ này thay đổi thường xuyên, hãy kiểm tra trang giá hiện tại trước khi chọn. Với dữ liệu khách hàng nhạy cảm, khả năng tự cài trên máy chủ của mình là điểm cộng cần cân nhắc.
Ví dụ: form website về CRM, báo sales qua tin nhắn
Chị Thảo, marketing ops của Công ty Logistics Sao Việt, dựng luồng sau (tên bước có thể khác tùy công cụ):
- Trigger: nhận webhook từ form “Yêu cầu báo giá”, gồm họ tên, công ty, email, số điện thoại và các trường ẩn
utm_source,utm_medium,utm_campaign. - Chuẩn hóa: đưa số điện thoại về một định dạng, viết thường email.
- Tìm trong CRM: gọi API tìm liên hệ theo email hoặc số điện thoại.
- Rẽ nhánh: có rồi thì cập nhật và thêm hoạt động “gửi form báo giá”; chưa có thì tạo lead mới, ghi nguồn từ UTM.
- Thông báo: gửi tin cho sales phụ trách khu vực kèm link tới lead trong CRM.
- Khi lỗi: gửi email cho chị Thảo kèm dữ liệu gốc để xử lý tay.
Ba nguyên tắc an toàn
Giữ kín khóa API
Khóa API giống chìa khóa kho dữ liệu. Không đặt nó trong mã JavaScript trên website, không dán vào nhóm chat. Lưu trong phần quản lý thông tin xác thực của công cụ nối, cấp quyền tối thiểu cần thiết, và thu hồi khi người phụ trách nghỉ việc.
Tìm rồi mới tạo
Mạng chập chờn, công cụ tự chạy lại, khách bấm gửi hai lần: đều sinh lead trùng. Luôn tìm theo khóa định danh (email, số điện thoại) trước khi tạo. Cách làm này gọi là upsert.
Có kế hoạch cho lỗi
Mọi tích hợp đều có lúc hỏng: đối tác đổi API, khóa hết hạn, vượt giới hạn tần suất. Đặt cảnh báo khi luồng lỗi và kiểm tra nhật ký chạy mỗi tuần.
Thử ngay
Liệt kê mọi luồng dữ liệu đang chạy giữa các công cụ của bạn: nguồn, đích, công cụ nối, ai phụ trách, lần cuối kiểm tra. Nhiều đội phát hiện có luồng đã chết từ lâu mà không ai biết.
Cùng ôn lại
- API: bên gọi chủ động hỏi hoặc ghi dữ liệu; webhook: bên có sự kiện tự gửi ngay.
- n8n, Zapier, Make xây luồng theo trigger, điều kiện và action, không cần lập trình nhiều.
- Giữ khóa API ở phía máy chủ hoặc công cụ nối, không bao giờ ở trình duyệt.
- Tìm rồi mới tạo để tránh trùng, và luôn có cảnh báo khi luồng lỗi.
Khi đã có vài luồng tích hợp, bạn cần một bức tranh tổng thể để cả đội cùng hiểu dữ liệu chảy ra sao. Bài tiếp theo hướng dẫn vẽ sơ đồ luồng dữ liệu.
Kiểm tra kiến thức
Bạn đang học với tư cách khách: quiz vẫn chấm nhưng điểm không được lưu. Đăng nhập hoặc tạo tài khoản để tích điểm và nhận huy hiệu.
Anh Phúc muốn mỗi khi có người gửi form trên website, CRM tạo lead ngay lập tức. Website hỗ trợ gửi webhook. Cách nào hợp lý nhất?
Một luồng Zapier bị lỗi mạng rồi tự chạy lại, kết quả CRM có hai lead giống hệt nhau. Cách phòng tránh tốt nhất là gì?
Đơn vị làm website đề xuất đặt khóa API của CRM vào mã JavaScript trên trang để form gọi thẳng API. Bạn nên phản hồi thế nào?