Kết nối Webhook
Tài liệu hướng dẫn bạn Thiết lập WebHook đẩy dữ liệu qua system khách hàng đường API trên PangoCDP.
Các bước xây dựng luồng WebHook
Bước 1: Tạo connection trên PangoCDP.
Name
Đặt tên Connect Webhook
Tags
Dùng để lọc nhãn
Authenticated Type
Loại xác thực Webhook
Có 4 loại: - By a Token Value - By an API Access Token - By OAuth2 - None
Để có các Token, API...thì sẽ được cung cấp bởi các đối tác từ phía Partner, khách hàng...
1/ By a Token Value: Kết nối bằng Token (khách sẽ cung cấp – API Tĩnh, điều này là KH cung cấp 1 API để nhập).
2/ By an API Access Token: Kết nối bằng API (khách sẽ cung cấp – API động, sau khi nhập các thông tin KH cung cấp thì mình sẽ có thể chọn API nào để connect thì theo yêu cầu của khách).
3/ By OAuth2: Kết nối theo Google Authentication (khách sẽ cung cấp – chỗ này khi connect sẽ cần thêm các bước xác thực từ Google).
4/ None: Không nên dùng loại xác thực này
Bước 2: Kiểm tra lại thông tin sau khi connect.
1
Webhook Status
Ẩn/hiện trạng thái Webhook (Enabled).
2
Header Parameters
Parameter được add thêm vào đầu endpoint (Default).
3
API Trigger
Đồng ý cho system bên khách call API bên PangoCDP lấy data về bên khách (Yes/No).
4
API Trigger ReqID
Key ID trigger (Default).
5
Track Log Detail
Tracking Log trigger (Yes).
Bước 3: Tạo event Webhook.
Tương tự như User_Event, đây là nơi tạo event_Name dùng để start 1 cái flow DMA tự động push data qua phía khách hàng bằng API.
Vào Module Console
Chọn Connection / Webhook Event / "+Add"
Event Name
Tên event dùng để start flow.
Object Model
Model dùng để Push data. Có 3 loại kiểu template Model (Body Model) khác nhau: customize, Version 1, Version 2.
Filters
Thiết lập thêm bộ Filter trước khi tạo Event
Tags
gắn Tags phân loại giúp dễ tìm kiếm
Status
Bật / Tắt kích hoạt cho chức năng
Customize: Tự tạo các CustomField cho các cột dữ liệu được push, thay đổi cấu trúc dữ liệu cho phù hợp.
Version 1: Cấu trúc theo template cố định, không thể thay đổi.
Version 2: Cấu trúc template cố định phù hợp cho Model Profile Info, không thay đổi (chỉ xuất hiện ở Model System, không hiển thị ở Model Custom).
Bước 4: Thiết lập các thông tin Event Webhook.
Entries Key
Dùng để tạo dữ liệu dạng List.
Batch
Số lượng records được push qua webhook.
Container
Gồm List hoặc Objects.
[Model Field]
Các trường dữ liệu được Push sang phía khách hàng.
Transforms
Dùng thêm các code tương ứng để chuyển đổi dữ liệu.
Preview
Dùng để xem trước dạng dữ liệu được push sang khách qua Webhook.
List: sẽ gồm nhiều Objects.
Object: Chỉ từng Object riêng biệt.
Cột bên trái: Model Data Custom trên PangoCDP
Cột bên phải: Dữ liệu data phía hệ thống bên khách hàng tạo để Push / Get data với PangoCDP
Ngoài ra, mình còn có thể thiết lập thêm các điều kiện cho Event_Webhook trước push dữ liệu như sau:
Thêm các điều kiện phù hợp với nhu cầu của dữ liệu.
Sau khi đã set-up thì sẽ chọn sync để push.
Bước 5: Tracking Logs sau khi Push dữ liệu.
Để kiểm tra dữ liệu đã Push hoàn tất hay lỗi thì làm như sau:
Last updated
Was this helpful?