Tích hợp nền tảng bên ngoài với Panel WeJot
Đối tượng: nền tảng khảo sát hoặc mẫu gửi người trả lời của mình đến nhiệm vụ của Panel WeJot Cập nhật: 2026-10-30
1. Mô hình tích hợp
Tích hợp nền tảng bên ngoài là một luồng khác với liên kết khảo sát bên ngoài do nhà nghiên cứu tự tạo.
| Mục | Liên kết ngoài của nhà nghiên cứu | Tích hợp nền tảng bên ngoài |
|---|---|---|
| Người khởi tạo | Nhà nghiên cứu tạo trong cuộc trò chuyện WeJot | Nền tảng bên ngoài |
| Nguồn người trả lời | Panel WeJot | Người trả lời của nền tảng |
| Nhận diện kết quả | Mã người trả lời + gửi thủ công trên trang nhiệm vụ | code + result trong callback trạng thái |
Luồng tích hợp:
- WeJot cung cấp liên kết vào nhiệm vụ kèm token triển khai.
- Nền tảng chuyển người trả lời đến liên kết đó. Trang nhiệm vụ WeJot hiển thị mã duy nhất của họ.
- Nền tảng lưu mã đó trong khảo sát.
- Khi kết thúc, nền tảng chuyển hướng đến URL trạng thái WeJot theo kết quả.
- WeJot ghi nhận trạng thái cuối và hiển thị trang kết quả.
Nếu bạn là nhà nghiên cứu muốn đưa khảo sát bên ngoài lên Panel WeJot, hãy đọc Liên kết khảo sát bên ngoài cho Panel WeJot.
2. Trước khi bắt đầu
- Nền tảng có thể lưu mã của từng người trả lời và trả lại nguyên vẹn trong chuyển hướng cuối.
- Nền tảng có thể cấu hình URL chuyển hướng khác nhau cho từng kết quả.
- URL chuyển hướng sử dụng HTTPS.
- Chạy thử toàn bộ luồng với nhiệm vụ thử nghiệm của WeJot trước khi chuyển sang môi trường chính thức.
- Không hiển thị mã người trả lời trên trang công khai, trong log hoặc nơi người trả lời khác có thể truy cập.
3. Truyền mã người trả lời
WeJot tạo mã duy nhất khi người trả lời vào nhiệm vụ. Khi mở khảo sát bên ngoài, WeJot tự động thêm responseCode=<mã> vào URL, cùng tham số theo dõi agentPID.
Nền tảng cần đọc và lưu responseCode khi vào, sau đó trả lại nguyên vẹn dưới dạng code khi kết thúc. Nếu nền tảng không đọc được tham số URL, hãy thêm câu hỏi văn bản một dòng bắt buộc ở đầu làm phương án dự phòng để người trả lời dán mã từ trang nhiệm vụ WeJot.
responseCodevàagentPIDdo WeJot thêm vào. Nền tảng không được xóa hoặc ghi đè chúng.codephải là giá trị củaresponseCode, không phải response ID, answer ID hoặc user ID của nền tảng.
Mã hóa URL trước khi thêm mã vào callback.
4. Bốn URL callback trạng thái
Môi trường chính thức:
Hoàn thành:
https://wj.pro/api/sample/task/external/status?result=complete&code={responseCode}&taskId={agentPID}
Hết hạn ngạch:
https://wj.pro/api/sample/task/external/status?result=overquota&code={responseCode}&taskId={agentPID}
Bị sàng lọc:
https://wj.pro/api/sample/task/external/status?result=screened&code={responseCode}&taskId={agentPID}
Chất lượng bị từ chối:
https://wj.pro/api/sample/task/external/status?result=quality&code={responseCode}&taskId={agentPID}4.1 Tham số
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
code | Có | responseCode do WeJot thêm vào, tức mã duy nhất của người trả lời |
result | Có | complete, overquota, screened hoặc quality |
taskId | Không | agentPID do WeJot thêm vào (ID nhiệm vụ); trả lại khi có |
taskId là tùy chọn. Nếu có, hãy dùng giá trị agentPID để WeJot dễ kiểm tra hơn.
4.2 Kết quả
result | Tình huống trên nền tảng | Xử lý tại WeJot |
|---|---|---|
complete | Người trả lời hoàn thành toàn bộ khảo sát | Vào phân bổ hạn ngạch của WeJot; được tính là phản hồi hợp lệ và vào luồng thưởng nếu đủ điều kiện |
overquota | Hạn ngạch của nền tảng đã đầy | Ghi nhận là kết thúc do hết hạn ngạch; không tính phản hồi hợp lệ và không tạo thưởng |
screened | Người trả lời không qua sàng lọc | Ghi nhận là bị sàng lọc; không tính phản hồi hợp lệ và không tạo thưởng |
quality | Nền tảng từ chối phản hồi vì chất lượng | Ghi nhận là chất lượng bị từ chối; không tính phản hồi hợp lệ và không tạo thưởng |
complete vẫn đi qua kiểm tra hạn ngạch của WeJot. Nếu nhiệm vụ WeJot đã đầy, kết quả được xử lý như hết hạn ngạch.
5. Các bước cấu hình
- Liên hệ WeJot để bật tích hợp nền tảng bên ngoài và nhận nhiệm vụ thử nghiệm cùng liên kết vào nhiệm vụ.
- Thêm phần thu thập mã người trả lời vào khảo sát và đảm bảo mọi mã đều được lưu.
- Cấu hình bốn URL chuyển hướng cho hoàn thành, hết hạn ngạch, bị sàng lọc và chất lượng bị từ chối.
- Đưa mã người trả lời vào tham số
codevà mã hóa URL. - Chạy thử cả bốn kết quả với nhiệm vụ thử nghiệm và xác nhận trạng thái tương ứng xuất hiện trong dữ liệu WeJot.
- Chuyển sang nhiệm vụ và tên miền chính thức sau khi kiểm tra đạt.
6. Trang kết quả và tính bất biến
- Cả bốn kết quả đều trả về trang kết quả cho người trả lời. Trạng thái hoàn thành hiển thị thẻ thưởng; ba trạng thái còn lại hiển thị trang kết thúc tương ứng.
- Callback lặp lại với cùng mã người trả lời là bất biến và không nhân đôi số lượng thu hồi, hạn ngạch hoặc thưởng.
- Nếu người trả lời đã gửi hoàn thành trên trang nhiệm vụ WeJot, callback kết thúc đến sau được xử lý như đã gửi và không thay đổi kết quả lần nữa.
- Mã không hợp lệ hoặc bị thiếu, hoặc giá trị
resultkhông nhận diện được, sẽ trả về trang thông báo mà không thay đổi trạng thái phản hồi.
7. Câu hỏi thường gặp
Callback báo mã người trả lời không hợp lệ
Kiểm tra code có phải mã hiển thị trên trang nhiệm vụ WeJot, không phải answer ID hoặc user ID của nền tảng. Mã phải khớp với nhiệm vụ và người trả lời.
Có thể bỏ taskId không?
Có. Mã người trả lời là duy nhất toàn cầu và WeJot tìm nhiệm vụ qua mã. taskId chỉ dùng để kiểm tra.
Callback lặp lại có tạo thưởng hai lần không?
Không. Callback lặp lại với cùng mã người trả lời là bất biến.
Trang kết quả không mở được
Kiểm tra code và result trước, sau đó xác nhận nền tảng dùng tên miền callback của đúng môi trường. Nếu vẫn lỗi, hãy liên hệ hỗ trợ WeJot.
8. Danh sách kiểm tra tích hợp
- Nền tảng đã nhận liên kết nhiệm vụ thử nghiệm.
- Người trả lời thấy mã trên trang nhiệm vụ WeJot.
- Khảo sát lưu mã và trả lại dưới dạng
code. - Bốn URL callback đã được cấu hình với
complete,overquota,screenedvàquality. - Từng kết quả đã được chạy thử và hiển thị đúng trong dữ liệu WeJot.
- Đã thử callback lặp lại và không nhân đôi thu hồi hoặc thưởng.
- Tên miền và nhiệm vụ chính thức đã được cấu hình trước khi ra mắt.