Đồng bộ liên hệ sang GetResponse

Nếu tổ chức gửi email marketing bằng GetResponse, hệ thống có thể tự đẩy người dùng sang danh sách GetResponse của bạn và cập nhật dữ liệu học tập của họ (đã ghi danh bao nhiêu khoá, đã mua gì, có chứng chỉ chưa). Đội marketing dùng các trường đó để lọc người nhận và dựng chuỗi email tự động trong GetResponse.

Mỗi tổ chức kết nối tới tài khoản GetResponse của riêng mình.

Ai dùng

Cấu hình kết nối cần quyền configure_getresponse — mặc định chỉ admin và super_admin có. Vai trò marketer mặc định không có quyền này.

Những gì được đồng bộ

Đồng bộ chỉ áp dụng cho người đã có tài khoản, khi họ phát sinh một trong các sự kiện:

Sự kiện trong hệ thống	Cập nhật
Đăng ký tài khoản	Thêm liên hệ vào danh sách mặc định
Ghi danh khoá học	Số khoá đã ghi danh, khoá gần nhất
Hoàn thành khoá học	Số khoá đã hoàn thành
Thanh toán thành công	Tổng tiền đã chi
Thanh toán bị treo (bỏ dở)	Cập nhật liên hệ
Kích hoạt / hết hạn gói thuê bao	Tên gói, trạng thái gói
Được cấp chứng chỉ	Có chứng chỉ, số chứng chỉ

Thông tin thuộc tính năng tổ chức đang tắt (thương mại điện tử, thuê bao, chứng chỉ) không được gửi.

Khác Mautic ở hai điểm

• Không đồng bộ khách tiềm năng chưa có tài khoản và không đồng bộ phản hồi biểu mẫu liên hệ. Nếu cần đưa khách tiềm năng vào chiến dịch email, xem Đồng bộ với Mautic.
• Không có mã theo dõi hành vi trên website.

Bước 1 — Chuẩn bị trong GetResponse

1. Lấy API Key tại Account → Integrations & API → API.
2. Chọn danh sách (campaign/list) sẽ nhận liên hệ mới và ghi lại ID của nó (xem trong cài đặt Lists).
3. Tạo các trường tuỳ chỉnh tại Contacts → Custom Fields → Create Field, tất cả đặt kiểu text:

Tên trường	Ý nghĩa
lms_user_id	Mã người dùng trong hệ thống
lms_lifecycle_stage	Giai đoạn: lead, student, customer, certified
lms_courses_enrolled	Số khoá đã ghi danh
lms_courses_completed	Số khoá đã hoàn thành
lms_last_course	Khoá ghi danh gần nhất
lms_last_activity	Lần học gần nhất
lms_total_spent	Tổng tiền đã chi
lms_subscription_plan	Gói thuê bao
lms_subscription_status	active, expired, none
lms_has_certificate	true/false
lms_certificate_count	Số chứng chỉ

4. Sau khi tạo, ghi lại ID của từng trường — bước sau cần đến.

Bước 2 — Điền khối cấu hình

1. Vào Cài đặt → Tích hợp → Tích hợp GetResponse.
2. Bật Bật đồng bộ GetResponse. Các ô còn lại chỉ hiện sau khi bật.
3. Điền API Key và Campaign (List) ID mặc định.
4. Webhook Secret: chỉ điền khi webhook của GetResponse gửi được header HTTP X-GR-Webhook-Secret mang đúng giá trị này (xem bước 3). Không gửi được header đó thì để trống.
5. Mở mục Ánh xạ trường dữ liệu. Danh sách đã có sẵn các alias ở cột Alias trường LMS; điền ID trường GetResponse tương ứng cho từng dòng. Để trống dòng nào thì trường đó không được gửi.
6. Lưu.

Bước 3 — Cấu hình webhook

GetResponse tạo liên hệ không đồng bộ: nó nhận yêu cầu ngay nhưng xử lý sau. Để hệ thống biết mã liên hệ GetResponse đã cấp (và lần sau cập nhật đúng liên hệ đó), bạn cần cho GetResponse gọi ngược lại:

1. Trong GetResponse vào Account → Integrations & API → Webhooks, tạo webhook mới.
2. URL: https://<tên-miền-của-bạn>/webhooks/getresponse.
3. Chọn sự kiện contact_added.
4. Nếu đã điền Webhook Secret, cấu hình webhook gửi kèm header X-GR-Webhook-Secret với đúng giá trị đó. Thiếu hoặc sai header thì hệ thống từ chối yêu cầu (lỗi 403).
5. Sau khi bật, tạo thử một sự kiện (ví dụ đăng ký một tài khoản thử) rồi kiểm tra liên hệ đó trong hệ thống đã nhận mã liên hệ GetResponse chưa.

Để trống Webhook Secret là nhận mọi yêu cầu

Khi ô này trống, đường webhook không kiểm tra gì và chấp nhận mọi yêu cầu gửi tới. Đó là đánh đổi nếu GetResponse không gửi được header tuỳ ý: tiện cấu hình hơn, nhưng ai biết địa chỉ webhook cũng gửi dữ liệu vào được.

Kiểm tra nhanh

Đăng ký một tài khoản thử trên website. Sau ít phút, liên hệ đó phải xuất hiện trong danh sách GetResponse đã chọn, kèm các trường lms_* đã ánh xạ.

Lưu ý

• Người dùng có từ trước khi bật chỉ xuất hiện trên GetResponse khi họ phát sinh một sự kiện mới (ghi danh, thanh toán…).
• Đồng ý tiếp thị: đồng bộ không lọc theo câu đồng ý nhận ưu đãi — mọi người dùng đăng ký tài khoản đều được thêm vào danh sách. Hãy bảo đảm chính sách đăng ký và điều khoản của tổ chức cho phép gửi email cho họ, và để người nhận tự huỷ đăng ký trong GetResponse.
• Tắt đồng bộ: tắt công tắc Bật đồng bộ GetResponse. Nếu tổ chức tắt hẳn tính năng GetResponse, đồng bộ cũng dừng nhưng khối cấu hình biến mất khỏi trang Cài đặt cho tới khi bật lại.