Integración de plataformas externas con el panel de WeJot

Dirigido a: plataformas de encuestas o muestras que envían a sus propios participantes a tareas del panel de WeJot Actualizado: 2026-10-30

1. Modelo de integración

La integración de una plataforma externa es un flujo distinto del enlace externo que un investigador crea por su cuenta.

Flujo de integración:

1. WeJot entrega un enlace de entrada a la tarea con token de despliegue.
2. La plataforma envía al participante a ese enlace. La página de WeJot muestra su código único.
3. La plataforma guarda ese código en su encuesta.
4. Al finalizar, la plataforma redirige a una URL de estado de WeJot según el resultado.
5. WeJot registra el estado final y muestra la página de resultado.

Si eres investigador y quieres publicar una encuesta externa en el panel de WeJot, consulta Enlaces de encuestas externas para el panel de WeJot.

2. Antes de empezar

• La plataforma puede guardar el código de cada participante y devolverlo sin cambios en la redirección final.
• La plataforma puede configurar URLs de redirección distintas para cada resultado.
• Las URLs de redirección usan HTTPS.
• Realiza una prueba completa con una tarea de prueba de WeJot antes de pasar a producción.
• No expongas el código en páginas públicas, registros o lugares accesibles para otros participantes.

3. Cómo transmitir el código de participante

WeJot genera el código único cuando el participante entra en la tarea. Al abrir la encuesta externa, WeJot añade automáticamente responseCode=<código> a la URL, junto con el parámetro de seguimiento agentPID.

La plataforma debe leer y guardar responseCode al entrar y devolverlo sin cambios como code al finalizar. Si la plataforma no puede leer parámetros de URL, añade al inicio una pregunta de texto de una línea obligatoria como respaldo para que el participante pegue el código de la página de WeJot.

responseCode y agentPID los añade WeJot. La plataforma no debe eliminarlos ni sobrescribirlos. code debe ser el valor de responseCode, no el ID de respuesta, ID de cuestionario o ID de usuario de la plataforma.

Codifica el código en URL antes de añadirlo al callback.

4. Cuatro URLs de callback de estado

Producción:

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

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

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

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

4.1 Parámetros

taskId es opcional. Si lo incluyes, usa el valor de agentPID para facilitar el diagnóstico a WeJot.

4.2 Resultados

complete sigue pasando por la comprobación de cuotas de WeJot. Si la tarea de WeJot ya está llena, se trata como cuota llena.

5. Pasos de configuración

1. Contacta con WeJot para habilitar la integración y obtener una tarea de prueba y su enlace de entrada.
2. Añade la recogida del código de participante en tu encuesta y asegúrate de guardar todos los códigos.
3. Configura cuatro URLs de redirección para completado, cuota llena, filtrado y rechazo por calidad.
4. Incluye el código en el parámetro code y codifícalo en URL.
5. Prueba los cuatro resultados con la tarea de prueba y confirma que aparecen en los datos de WeJot.
6. Cambia a la tarea y el dominio de producción después de que la prueba pase.

6. Página de resultado e idempotencia

• Los cuatro resultados devuelven una página para el participante. Completado muestra la tarjeta de recompensa; los otros tres muestran la página final correspondiente.
• Los callbacks repetidos con el mismo código son idempotentes y no duplican recuentos, cuotas ni recompensas.
• Si el participante ya envió la finalización en la página de WeJot, un callback posterior se trata como ya enviado y no cambia el resultado de nuevo.
• Un código inválido o ausente, o un result desconocido, devuelve una página de aviso sin modificar la respuesta.

7. Preguntas frecuentes

El callback indica que el código no es válido

Comprueba que code sea el código mostrado en la página de WeJot, no el ID de respuesta ni el ID de usuario de tu plataforma. El código debe corresponder a la tarea y al participante.

¿Se puede omitir taskId?

Sí. Los códigos son únicos a nivel global y WeJot localiza la tarea con el código. taskId solo sirve para diagnóstico.

¿Un callback repetido genera otra recompensa?

No. Los callbacks repetidos con el mismo código son idempotentes.

¿Qué hago si la página de resultado no abre?

Revisa primero code y result y después confirma que la plataforma usa el dominio de callback del entorno correcto. Si sigue fallando, contacta con soporte de WeJot.

8. Lista de comprobación

• La plataforma tiene el enlace de la tarea de prueba.
• El participante ve el código en la página de WeJot.
• La encuesta guarda el código y lo devuelve como code.
• Las cuatro URLs están configuradas con complete, overquota, screened y quality.
• Cada resultado se probó y aparece correctamente en los datos de WeJot.
• Se probó un callback repetido sin duplicar respuestas ni recompensas.
• El dominio y la tarea de producción están configurados antes del lanzamiento.