Hướng dẫn cài đặt: Systeme Contact Webhook

Phiên bản: 1.3.0 (Hỗ trợ Multi-Tag & Order Bump) | Tác giả: Minh Quý

Plugin giúp nhận dữ liệu từ Webcake và tự động đẩy contact lên Systeme.io NGAY LẬP TỨC. Hỗ trợ cơ chế Transient Cache để giảm request, Dedupe chống trùng data, tự động cập nhật thông tin và gắn nhiều Tag cùng lúc.

1. Cài đặt Plugin

Tải thư mục systeme-contact-webhook lên thư mục /wp-content/plugins/ trên hosting của bạn.
Kích hoạt plugin trong khu vực Quản trị Plugin của WordPress.
Sau khi cài đặt, plugin tự động tạo thư mục log tại: /wp-content/uploads/systeme-contact/webhook_log.txt

2. Link Webhook nhận dữ liệu

Đây là đường dẫn bạn sẽ copy để dán vào Webcake:

https://minhquy.vn/wp-json/systeme-contact/v1/webhook

* Nhớ thay minhquy.vn bằng tên miền website WordPress của bạn nếu bạn upload plugin lên web wordpress của bạn.

3. Công cụ tạo JSON Payload tự động (Dành cho Webcake)

Điền các thông tin biến Webcake của bạn vào form dưới đây, hệ thống sẽ tự động sinh mã JSON chuẩn để bạn copy dán vào Webcake.

Form cấu hình Payload

Systeme API Key của bạn:

Trường Họ Tên (Webcake):

Trường Email (Webcake):

Trường Số Điện Thoại (Webcake):

Biến Tag Chính (Bắt buộc): Trường ẩn trên form Webcake lưu Tag mặc định của Landing Page.

Biến Tag Order Bump 1 (Tuỳ chọn):

Kết quả JSON:

{
  "full_name": "{{full_name}}",
  "email": "{{email}}",
  "phone_number": "{{phone_number}}",
  "systeme_api_key": "YOUR_API_KEY",
  "tags": [
    "{{tag_main}}",
    "{{tag_bump_1}}"
  ]
}

4. Hướng dẫn thiết lập trên Webcake

Trong trình thiết kế Webcake, click vào Form đăng ký.
Tạo một Trường ẩn và đặt tên là tag_main. Điền Value là ID Tag Systeme chính của bạn.
Tạo một Checkbox (nếu có bán Order Bump) và đặt tên là tag_bump_1. Điền Value là ID Tag Order Bump.
Bấm Cài đặt Form -> Lưu dữ liệu / API / Webhook.
Chọn gửi qua POST / Webhook.
Dán Link Webhook ở mục 2 và dán mã JSON vừa Copy ở mục 3 vào ô Payload. Xuất bản trang!

5. Bật/Tắt chế độ Debug (Ghi log)

Nếu bạn muốn xem log quá trình đẩy dữ liệu, hãy mở file plugin systeme-contact-webhook.php, tìm đến hàm debug_mode() và chỉnh thành:

private static function debug_mode() {
    return true; // Đổi thành false để tắt hoàn toàn ghi log
}

Phát triển bởi Minh Quý

Nếu cần hỗ trợ kỹ thuật hoặc mở rộng tính năng, vui lòng liên hệ qua website.