Integrasi Platform Pihak Ketiga dengan Panel WeJot

Untuk: platform survei atau sampel yang mengirim respondennya sendiri ke tugas Panel WeJot Diperbarui: 2026-10-30

1. Model integrasi

Integrasi platform pihak ketiga adalah alur yang berbeda dari tautan survei eksternal yang dibuat sendiri oleh peneliti.

Item	Tautan eksternal peneliti	Integrasi platform pihak ketiga
Inisiator	Peneliti membuatnya di percakapan WeJot	Integrasi platform
Sumber responden	Panel WeJot	Responden milik platform
Pencocokan hasil	Kode responden + pengiriman manual di halaman tugas	`code` + `result` pada callback status

Alur integrasi:

WeJot memberikan tautan masuk tugas dengan token deploy.
Platform mengarahkan responden ke tautan tersebut. Halaman tugas WeJot menampilkan kode unik responden.
Platform menyimpan kode itu di surveinya.
Di akhir survei, platform mengalihkan ke URL status WeJot sesuai hasil.
WeJot mencatat status akhir dan menampilkan halaman hasil.

Jika Anda peneliti yang ingin menjalankan survei pihak ketiga di Panel WeJot, baca Tautan Survei Eksternal untuk Panel WeJot.

2. Sebelum memulai

Platform dapat menyimpan kode setiap responden dan mengembalikannya tanpa perubahan pada pengalihan akhir.
Platform dapat mengonfigurasi URL pengalihan berbeda untuk setiap hasil.
URL pengalihan menggunakan HTTPS.
Lakukan uji menyeluruh dengan tugas uji WeJot sebelum beralih ke produksi.
Jangan menampilkan kode responden di halaman publik, log, atau tempat yang dapat diakses responden lain.

3. Mengirim kode responden

WeJot membuat kode unik saat responden masuk ke tugas. Saat survei eksternal dibuka, WeJot otomatis menambahkan responseCode=<kode> ke URL, bersama parameter pelacakan agentPID.

Platform harus membaca dan menyimpan responseCode saat masuk, lalu mengembalikannya tanpa perubahan sebagai code di akhir. Jika platform tidak dapat membaca parameter URL, tambahkan pertanyaan teks satu baris wajib di awal sebagai cadangan agar responden menempel kode dari halaman tugas WeJot.

responseCode dan agentPID ditambahkan oleh WeJot. Platform tidak boleh menghapus atau menimpanya. code harus berisi nilai responseCode, bukan response ID, answer ID, atau user ID platform.

Encode kode dalam URL sebelum menambahkannya ke callback.

4. Empat URL callback status

Produksi:


Selesai:
https://wj.pro/api/sample/task/external/status?result=complete&code={responseCode}&taskId={agentPID}

Kuota penuh:
https://wj.pro/api/sample/task/external/status?result=overquota&code={responseCode}&taskId={agentPID}

Tersaring:
https://wj.pro/api/sample/task/external/status?result=screened&code={responseCode}&taskId={agentPID}

Kualitas ditolak:
https://wj.pro/api/sample/task/external/status?result=quality&code={responseCode}&taskId={agentPID}

4.1 Parameter

Parameter	Wajib	Deskripsi
`code`	Ya	`responseCode` yang ditambahkan WeJot, yaitu kode unik responden
`result`	Ya	`complete`, `overquota`, `screened`, atau `quality`
`taskId`	Tidak	`agentPID` yang ditambahkan WeJot (ID tugas); kembalikan jika tersedia

taskId opsional. Jika ada, gunakan nilai agentPID agar WeJot lebih mudah melakukan troubleshooting.

4.2 Hasil

`result`	Skenario platform	Penanganan WeJot
`complete`	Responden menyelesaikan seluruh survei	Masuk ke alokasi kuota WeJot; dihitung sebagai respons valid dan masuk alur hadiah jika memenuhi syarat
`overquota`	Kuota platform penuh	Dicatat sebagai status akhir kuota penuh; tidak dihitung sebagai respons valid dan tidak membuat hadiah
`screened`	Responden tidak lolos penyaringan	Dicatat sebagai tersaring; tidak dihitung sebagai respons valid dan tidak membuat hadiah
`quality`	Platform menolak respons karena kualitas	Dicatat sebagai kualitas ditolak; tidak dihitung sebagai respons valid dan tidak membuat hadiah

complete tetap melewati pemeriksaan kuota WeJot. Jika tugas WeJot sudah penuh, hasilnya diperlakukan sebagai kuota penuh.

5. Langkah konfigurasi

Hubungi WeJot untuk mengaktifkan integrasi platform pihak ketiga dan mendapatkan tugas uji serta tautan masuk tugas.
Tambahkan pengumpulan kode responden di survei Anda dan pastikan setiap kode tersimpan.
Konfigurasikan empat URL pengalihan untuk selesai, kuota penuh, tersaring, dan kualitas ditolak.
Masukkan kode responden ke parameter code dan encode dalam URL.
Uji keempat hasil dengan tugas uji dan pastikan status yang sesuai muncul di data respons WeJot.
Beralih ke tugas dan domain produksi setelah uji berhasil.

6. Halaman hasil dan idempotensi

Keempat hasil mengembalikan halaman hasil untuk responden. Hasil selesai menampilkan kartu hadiah; tiga lainnya menampilkan halaman akhir yang sesuai.
Callback berulang dengan kode responden yang sama bersifat idempoten dan tidak menggandakan jumlah respons, penggunaan kuota, atau hadiah.
Jika responden sudah mengirim penyelesaian di halaman tugas WeJot, callback terminal yang datang kemudian diperlakukan sebagai sudah dikirim dan tidak mengubah hasil lagi.
Kode tidak valid atau hilang, atau nilai result yang tidak dikenal, mengembalikan halaman peringatan tanpa mengubah status respons.

7. FAQ

Callback menyatakan kode responden tidak valid

Pastikan code adalah kode yang ditampilkan di halaman tugas WeJot, bukan answer ID atau user ID platform Anda. Kode harus cocok dengan tugas dan responden.

Apakah taskId boleh dihilangkan?

Ya. Kode responden unik secara global, dan WeJot menemukan tugas melalui kode. taskId hanya untuk troubleshooting.

Apakah callback berulang membuat hadiah ganda?

Tidak. Callback berulang dengan kode responden yang sama bersifat idempoten.

Halaman hasil tidak terbuka

Periksa code dan result terlebih dahulu, lalu pastikan platform menggunakan domain callback untuk lingkungan yang benar. Jika masih gagal, hubungi dukungan WeJot.

8. Daftar periksa integrasi

Platform sudah memiliki tautan tugas uji.
Responden dapat melihat kode di halaman tugas WeJot.
Survei menyimpan kode dan mengembalikannya sebagai code.
Keempat URL callback dikonfigurasi dengan complete, overquota, screened, dan quality.
Setiap hasil sudah diuji dan muncul dengan benar di data respons WeJot.
Callback berulang sudah diuji dan tidak menggandakan respons atau hadiah.
Domain dan tugas produksi sudah dikonfigurasi sebelum peluncuran.