Integração de plataformas externas ao Painel WeJot

Público: plataformas de pesquisa ou amostra que enviam seus próprios participantes para tarefas do Painel WeJot Atualizado em: 2026-10-30

1. Modelo de integração

A integração de uma plataforma externa é um fluxo diferente do link externo que um pesquisador cria por conta própria.

Item	Link externo do pesquisador	Integração de plataforma externa
Iniciador	O pesquisador cria em uma conversa do WeJot	A plataforma externa
Origem dos participantes	Painel WeJot	Participantes da própria plataforma
Identificação	Código de participante + envio manual na página da tarefa	`code` + `result` no callback de status

Fluxo de integração:

O WeJot fornece um link de entrada da tarefa com token de implantação.
A plataforma direciona o participante para esse link. A página do WeJot mostra o código único.
A plataforma salva esse código na pesquisa.
Ao final, a plataforma redireciona para uma URL de status do WeJot conforme o resultado.
O WeJot registra o estado final e exibe a página de resultado.

Se você é pesquisador e quer publicar uma pesquisa externa no Painel WeJot, leia Links de pesquisas externas para o Painel WeJot.

2. Antes de começar

A plataforma consegue salvar o código de cada participante e devolvê-lo sem alterações no redirecionamento final.
A plataforma consegue configurar URLs de redirecionamento diferentes para cada resultado.
As URLs de redirecionamento usam HTTPS.
Faça um teste completo com uma tarefa de teste do WeJot antes de ir para produção.
Não exponha o código em páginas públicas, logs ou locais acessíveis a outros participantes.

3. Como enviar o código de participante

O WeJot gera o código único quando o participante entra na tarefa. Ao abrir a pesquisa externa, o WeJot adiciona automaticamente responseCode=<código> à URL, junto com o parâmetro de rastreamento agentPID.

A plataforma deve ler e salvar responseCode na entrada e devolvê-lo sem alterações como code ao final. Se a plataforma não conseguir ler parâmetros de URL, adicione no início uma pergunta de texto de uma linha obrigatória como alternativa para o participante colar o código da página do WeJot.

responseCode e agentPID são adicionados pelo WeJot. A plataforma não deve removê-los nem sobrescrevê-los. code deve conter o valor de responseCode, não o response ID, answer ID ou user ID da plataforma.

Codifique o código em URL antes de adicioná-lo ao callback.

4. Quatro URLs de callback de status

Produção:


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

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

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

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

4.1 Parâmetros

Parâmetro	Obrigatório	Descrição
`code`	Sim	O `responseCode` adicionado pelo WeJot, ou seja, o código único do participante
`result`	Sim	`complete`, `overquota`, `screened` ou `quality`
`taskId`	Não	O `agentPID` adicionado pelo WeJot (ID da tarefa); devolva quando disponível

taskId é opcional. Quando presente, use o valor de agentPID para facilitar o diagnóstico pelo WeJot.

4.2 Resultados

`result`	Cenário na plataforma	Tratamento no WeJot
`complete`	O participante concluiu toda a pesquisa	Entra na alocação de cotas do WeJot; é contado como resposta válida e segue para o fluxo de recompensa quando elegível
`overquota`	A cota da plataforma está cheia	Registrado como encerramento por cota cheia; não conta como resposta válida e não gera recompensa
`screened`	O participante não passou na triagem	Registrado como triagem reprovada; não conta como resposta válida e não gera recompensa
`quality`	A plataforma rejeitou a resposta por qualidade	Registrado como qualidade rejeitada; não conta como resposta válida e não gera recompensa

complete ainda passa pela verificação de cotas do WeJot. Se a tarefa do WeJot já estiver cheia, o resultado é tratado como cota cheia.

5. Etapas de configuração

Contate o WeJot para habilitar a integração e obter uma tarefa de teste e o link de entrada.
Adicione a coleta do código de participante à sua pesquisa e garanta que todos os códigos sejam salvos.
Configure quatro URLs de redirecionamento para concluído, cota cheia, triagem reprovada e qualidade rejeitada.
Coloque o código no parâmetro code e codifique-o em URL.
Teste os quatro resultados com a tarefa de teste e confirme os estados correspondentes nos dados do WeJot.
Mude para a tarefa e o domínio de produção após a aprovação no teste.

6. Página de resultado e idempotência

Os quatro resultados retornam uma página para o participante. Concluído mostra o cartão de recompensa; os outros três mostram a página final correspondente.
Callbacks repetidos com o mesmo código são idempotentes e não duplicam contagens, cotas ou recompensas.
Se o participante já enviou a conclusão na página do WeJot, um callback posterior é tratado como já enviado e não altera o resultado novamente.
Código inválido ou ausente, ou result desconhecido, retorna uma página de aviso sem alterar a resposta.

7. Perguntas frequentes

O callback informa que o código é inválido

Verifique se code é o código exibido na página do WeJot, não o answer ID ou user ID da plataforma. O código precisa corresponder à tarefa e ao participante.

Posso omitir o taskId?

Sim. Os códigos são únicos globalmente e o WeJot localiza a tarefa pelo código. taskId serve apenas para diagnóstico.

Um callback repetido gera outra recompensa?

Não. Callbacks repetidos com o mesmo código são idempotentes.

A página de resultado não abre

Verifique primeiro code e result e depois confirme se a plataforma usa o domínio de callback do ambiente correto. Se continuar falhando, contate o suporte do WeJot.

8. Lista de verificação

A plataforma recebeu o link da tarefa de teste.
O participante vê o código na página do WeJot.
A pesquisa salva o código e o devolve como code.
As quatro URLs estão configuradas com complete, overquota, screened e quality.
Cada resultado foi testado e aparece corretamente nos dados do WeJot.
Um callback repetido foi testado sem duplicar respostas ou recompensas.
O domínio e a tarefa de produção estão configurados antes do lançamento.