Skip to main content
Talview Standard Assessment Workflow Callback Api provides mechanism for sending assessment reports,scores,video playback url’s and etc.

​
Prerequisites

  1. Please follow Workflow Schedule OR Workflow Invite page inviting candidates to assessments on Talview.

​
Callback Integrations Steps

  1. Callback Url can be setup in our system.
  2. Once Callback Url endpoint is setup in our system, we will trigger data in below standard structure to \ system.
Request payload definition: Standard
AttributeMandatoryData TypeDescription
report_urlnoStringCandidate Assessment report url based on the standard skills setup in our system.
Its a signed url which has a expiration time.
playback_urlnoStringPlayback url of Assessment Async video or Interview recorded video
overall_scorenoNumberOverall score of candidate in async mcq section of assessment
candidate_reference_idnoStringCandidate’s ID in External System
workflow_reference_idnoStringTalview Workflow ID
workflow_step_reference_idnoStringWorkflowStep ID from external client system
workflow_idnoStringTalview Workflow ID
candidate_idnoNumberTalview Candidate ID
workflow_candidate_step_statusyesStringStep status of the candidate
workflow_step_idnoNumberTalview Workflow step id
Sample response payload:
  1. Success response: HTTP status code - 2xx
  2. Error response: HTTP status code - 4xx
Sample CURL request: 
curl --request POST \
  --url https://abc.com/callback/report \
  --data '{ 
   "report_url": "AWS signed url",
   "playback_url": "https://wt.talview.com/workflow/{{workflow_id}}/invite/{{workflow_candidate_step_id}}",
   "overall_score": 35,
   "candidate_reference_id": "CAN-291",
   "workflow_reference_id": "ASS-31",
   "workflow_step_reference_id": "ASS-1A-31" 
}'