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.

Trường thông tin	Mô tả
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.

No.	Trường dữ liệu	Mô tả
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"

Trường dữ liệu	Mô tả
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.

Trường thông tin
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: