Talentics Callback
Talentics uses callback to notify your application any time an event happens on your account or your organization account. Talentics Callback provides several callbacks you can use with one click setup.
Setup
Talentics Callback sends you several notifications for each event, so you need to prepare a single endpoint for each notification/event.
You can set your notification endpoint here.
Authorize Callback Sender
A token will be sent with every callback, use the token to validate that a callback came from our servers. You can validate a token via X-Callback-Token header.
The token is generated by our system once you activate your Developer Account, you can find the token here.
Delivery Attempts and Retries
Talentics Callback will make an attempt to deliver and will stop retrying until we have received a response from your server or there is still no response yet. The delivery attempts and retries are enabled by default for every account. The retry policy can be seen below.
| Retry Number | Interval (relativity to last retry) | Interval (relativity to original attempt) |
|---|---|---|
| 1 | 15m | 15m |
| 2 | 15m | 30m |
| 3 | 15m | 45m |
Talentics Callback will stop retrying when it reaches 3 attempts.
View Events and Manual Resend
Talentics Developer Console allows transaction details to be viewed along with its callback status. In this console, any request to resend callbacks for individual transactions can be done directly, and callbacks will be automatically resent. To view details of the request payload, you can click on the related transaction.
Callback List and Payload Examples
Moved Applicant Callback
Notification will be sent when the applicant moves to the next stage in a particular job.
POST
{
"applicant_id": 123,
"name": "John Doe",
"email": "[email protected]",
"moved_at": "2020-08-03T23:04:24.000000Z",
"job": {
"job_id": 12,
"title": "Account Executive",
"code": "CODE123",
},
"previous_stage": {
"stage_id": 30,
"name": "Application Screening"
},
"current_stage": {
"stage_id": 31,
"name": "Online Psychotest"
},
"next_stage": {
"stage_id": 32,
"name": "Interview"
}
}Example Request
curl -H "Content-Type: application/json" -H "x-callback-token:{callback_token}" -X POST -d '{"applicant_id":123,"name":"John Doe","email":"[email protected]","moved_at":"2020-08-03T23:04:24.000000Z","job":{"job_id":12,"title":"Account Executive","code":"CODE123"},"previous_stage":{"stage_id":30,"name":"Application Screening"},"current_stage":{"stage_id":31,"name":"Online Psychotest"},"next_stage":{"stage_id":32,"name":"Interview"}}'{callback_endpoint}
Hired Applicant Callback
Notification will be sent when an applicant is hired for a particular job. This notification event will give you complete data of your applicant.
POST
{
"id": 123,
"name": "John Doe",
"email": "[email protected]",
"hired_at": "2020-08-03T23:04:24.000000Z",
"profile" : {
"name": "John Doe",
"email": "[email protected]",
"phone_number": "0123456789",
"identity_number": "3123876153746251345",
"location": "Jakarta",
"gender": "Male",
"birthdate": "1991-01-01",
"educations": [
{
"level": "S1",
"institution": "Universitas Indonesia",
"major": "Computer Science",
"graduation_year": "2011",
"grade": "",
"gpa": "3.00"
}
],
"experiences": [
{
"company": "PT. Lorem Ipsum",
"position": "Manager",
"start_date": "2011",
"end_date": "2015"
}
],
"achievements": [
{
"organization": "WHO",
"title": "Volunteer",
"year": "2011"
}
],
"leaderships" [
{
"organization": "OSIS",
"position": "Ketua",
"start_date": "2008",
"end_date": "2009"
}
],
"skills" [
"skill 1", "skill 2", "skill 3"
]
},
"employment_application_form": [
{
"name": "birthplace",
"value": "Kota Jakarta Selatan"
},
{
"name": "religion",
"value": "Moslem"
},
{
"name": "identity_address",
"value": "Pela Mampang"
},
{
"name": "current_address",
"value": "Pela Mampang"
},
{
"name": "blood_type",
"value": "O"
},
{
"name": "marital_status",
"value": "Married"
},
{
"name": "date_of_married",
"value": "2018-12-02"
},
{
"name": "number_of_children",
"value": "1"
},
{
"name": "npwp_number",
"value": "111111111111111"
},
{
"name": "npwp_address",
"value": "Pela Mampang"
},
{
"name": "license_number",
"value": "111111"
},
{
"name": "reference_name",
"value": "Mary"
},
{
"name": "reference_address",
"value": "Pela Mampang"
},
{
"name": "reference_phone",
"value": "0811111111"
},
{
"name": "reference_email",
"value": "[email protected]"
},
{
"name": "reference_relation",
"value": "Wife"
},
{
"name": "bank_account_number",
"value": "1270101"
},
{
"name": "bank_name",
"value": "BANK BCA"
},
{
"name": "bank_account_name",
"value": "John Doe"
},
{
"name": "identity_card",
"value": "https://talentics.id/download/file_uploaded/identity_card/1625642548/2019-07.pdf"
},
{
"name": "npwp_card",
"value": "https://talentics.id/download/file_uploaded/npwp_card/1625642554/2019-08.pdf"
},
{
"name": "bank_book",
"value": "https://talentics.id/download/file_uploaded/bank_book/1625642557/2019-09.pdf"
},
{
"name": "other_document",
"value": "https://talentics.id/download/file_uploaded/other_document/1625642560/2019-10.pdf"
}
],
"job": {
"job_id": 12,
"title": "Account Executive",
"code": "CODE123",
},
"previous_stage": {
"stage_id": 40,
"name": "Interview"
},
"current_stage": {
"stage_id": 41,
"name": "Final"
}
}Example Request
curl -H "Content-Type: application/json" -H "x-callback-token:{callback_token}" -X POST -d '{"id":123,"name":"John Doe","email":"[email protected]","hired_at":"2020-08-03T23:04:24.000000Z","profile":{"name":"John Doe","email":"[email protected]","phone_number":"0123456789","identity_number":"3123876153746251345","location":"Jakarta","gender":"Male","birthdate":"1991-01-01","educations":[{"level":"S1","institution":"Universitas Indonesia","major":"Computer Science","graduation_year":"2011","grade":"","gpa":"3.00"}],"experiences":[{"company":"PT. Lorem Ipsum","position":"Manager","start_date":"2011","end_date":"2015"}],"achievements":[{"organization":"WHO","title":"Volunteer","year":"2011"}],"leaderships":[{"organization":"OSIS","position":"Ketua","start_date":"2008","end_date":"2009"}],"skills":["skill 1","skill 2","skill 3"]},"employment_application_form":[{"name":"birthplace","value":"Kota Jakarta Selatan"},{"name":"religion","value":"Moslem"},{"name":"identity_address","value":"Pela Mampang"},{"name":"current_address","value":"Pela Mampang"},{"name":"blood_type","value":"O"},{"name":"marital_status","value":"Married"},{"name":"date_of_married","value":"2018-12-02"},{"name":"number_of_children","value":"1"},{"name":"npwp_number","value":"111111111111111"},{"name":"npwp_address","value":"Pela Mampang"},{"name":"license_number","value":"111111"},{"name":"reference_name","value":"Mary"},{"name":"reference_address","value":"Pela Mampang"},{"name":"reference_phone","value":"0811111111"},{"name":"reference_email","value":"[email protected]"},{"name":"reference_relation","value":"Wife"},{"name":"bank_account_number","value":"1270101"},{"name":"bank_name","value":"BANK BCA"},{"name":"bank_account_name","value":"John Doe"},{"name":"identity_card","value":"https://talentics.id/download/file_uploaded/identity_card/1625642548/2019-07.pdf"},{"name":"npwp_card","value":"https://talentics.id/download/file_uploaded/npwp_card/1625642554/2019-08.pdf"},{"name":"bank_book","value":"https://talentics.id/download/file_uploaded/bank_book/1625642557/2019-09.pdf"},{"name":"other_document","value":"https://talentics.id/download/file_uploaded/other_document/1625642560/2019-10.pdf"}],"job":{"job_id":12,"title":"Account Executive","code":"CODE123"},"previous_stage":{"stage_id":40,"name":"Interview"},"current_stage":{"stage_id":41,"name":"Final"}}'{callback_endpoint}
Rejected Applicant Callback
Notification will be sent when an applicant is rejected/dropped in a particular job.
POST
{
"applicant_id": 123,
"name": "John Doe",
"email": "[email protected]",
"rejected_at": "2020-08-03T23:04:24.000000Z",
"reject_reason": "Lorem ipsum dolor sit amet",
"job": {
"job_id": 12,
"title": "Account Executive",
"code": "CODE123",
},
"rejection_stage": {
"stage_id": 31,
"name": "Online Psychotest"
}
}Example Request
curl -H "Content-Type: application/json" -H "x-callback-token:{callback_token}" -X POST -d '{"applicant_id":123,"name":"John Doe","email":"[email protected]","rejected_at":"2020-08-03T23:04:24.000000Z","reject_reason":"Lorem ipsum dolor sit amet","job":{"job_id":12,"title":"Account Executive","code":"CODE123"},"rejection_stage":{"stage_id":31,"name":"Online Psychotest"}}'{callback_endpoint}
Test Finished Callback
Notification will be sent when the applicant finishes the given test.
POST
{
"ticket_id": 30,
"applicant_id": 123,
"name": "John Doe",
"email": "[email protected]",
"sent_at": "2020-08-03T23:04:24.000000Z",
"started_at": "2020-08-03T23:04:24.000000Z",
"finished_at": "2020-08-03T23:04:24.000000Z",
"job": {
"job_id": 12,
"title": "Account Executive",
"code": "CODE123",
},
"stage": {
"stage_id": 31,
"name": "Online Psychotest"
},
"test": {
"test_id": 345,
"title": "Account Executive Selection Test",
"start_date": "2020-08-03T23:04:24.000000Z",
"end_date": "2020-08-03T23:04:24.000000Z"
}
}Example Request
curl -H "Content-Type: application/json" -H "x-callback-token:{callback_token}" -X POST -d '{"ticket_id":30,"applicant_id":123,"name":"John Doe","email":"[email protected]","sent_at":"2020-08-03T23:04:24.000000Z","started_at":"2020-08-03T23:04:24.000000Z","finished_at":"2020-08-03T23:04:24.000000Z","job":{"job_id":12,"title":"Account Executive","code":"CODE123"},"stage":{"stage_id":31,"name":"Online Psychotest"},"test":{"test_id":345,"title":"Account Executive Selection Test","start_date":"2020-08-03T23:04:24.000000Z","end_date":"2020-08-03T23:04:24.000000Z"}}'{callback_endpoint}
Test Report Generated Callback
Notification will be sent when we have finished generating the report and score for the given test of a certain applicant.
POST
{
"ticket_id": 30,
"applicant_id": 123,
"name": "John Doe",
"email": "[email protected]",
"sent_at": "2020-08-03T23:04:24.000000Z",
"started_at": "2020-08-03T23:04:24.000000Z",
"finished_at": "2020-08-03T23:04:24.000000Z",
"job": {
"job_id": 12,
"title": "Account Executive",
"code": "CODE123",
},
"stage": {
"stage_id": 31,
"name": "Online Psychotest"
},
"test": {
"test_id": 345,
"title": "Account Executive Selection Test",
"start_date": "2020-08-03T23:04:24.000000Z",
"end_date": "2020-08-03T23:04:24.000000Z"
},
"result": {
"report_url": "https://talentics.id/report/12345?token=2412fsafqwr2fsafas",
"assessments": [
{
"name": "Assessment 1",
"scores": [
{
"aspect": "Aspect 1",
"score": 79
},
{
"aspect": "Aspect 2",
"score": 80
}
]
}
]
}
}Example Request
curl -H "Content-Type: application/json" -H "x-callback-token:{callback_token}" -X POST -d '{"ticket_id":30,"applicant_id":123,"name":"John Doe","email":"[email protected]","sent_at":"2020-08-03T23:04:24.000000Z","started_at":"2020-08-03T23:04:24.000000Z","finished_at":"2020-08-03T23:04:24.000000Z","job":{"job_id":12,"title":"Account Executive","code":"CODE123"},"stage":{"stage_id":31,"name":"Online Psychotest"},"test":{"test_id":345,"title":"Account Executive Selection Test","start_date":"2020-08-03T23:04:24.000000Z","end_date":"2020-08-03T23:04:24.000000Z"},"result":{"report_url":"https://talentics.id/report/12345?token=2412fsafqwr2fsafas","assessments":[{"name":"Assessment 1","scores":[{"aspect":"Aspect 1","score":79},{"aspect":"Aspect 2","score":80}]}]}}'{callback_endpoint}
Employment Application Form Submitted Callback
Notification will be sent when an applicant submits Employment Application Form.
POST
{
"id": 30,
"applicant_id": 123,
"name": "John Doe",
"email": "[email protected]",
"application_time": "2020-08-03T23:04:24.000000Z",
"previous_stage": {
"id": 30,
"stage_id": 30,
"name": "Online Psychotest",
"updated_at": "2020-08-03T23:04:24.000000Z"
},
"current_stage": {
"id": 31,
"stage_id": 31,
"name": "Interview",
"updated_at": "2020-08-03T23:04:24.000000Z"
},
"next_stage": {
"id": 32,
"stage_id": 32,
"name": "Final",
"updated_at": "2020-08-03T23:04:24.000000Z"
},
"employment_application_form": [
{
"name": "birthplace",
"value": "Kota Jakarta Selatan"
},
{
"name": "religion",
"value": "Moslem"
},
{
"name": "identity_address",
"value": "Pela Mampang"
},
{
"name": "current_address",
"value": "Pela Mampang"
},
{
"name": "blood_type",
"value": "O"
},
{
"name": "marital_status",
"value": "Married"
},
{
"name": "date_of_married",
"value": "2018-12-02"
},
{
"name": "number_of_children",
"value": "1"
},
{
"name": "npwp_number",
"value": "111111111111111"
},
{
"name": "npwp_address",
"value": "Pela Mampang"
},
{
"name": "license_number",
"value": "111111"
},
{
"name": "reference_name",
"value": "Mary"
},
{
"name": "reference_address",
"value": "Pela Mampang"
},
{
"name": "reference_phone",
"value": "0811111111"
},
{
"name": "reference_email",
"value": "[email protected]"
},
{
"name": "reference_relation",
"value": "Wife"
},
{
"name": "bank_account_number",
"value": "1270101"
},
{
"name": "bank_name",
"value": "BANK BCA"
},
{
"name": "bank_account_name",
"value": "John Doe"
},
{
"name": "identity_card",
"value": "https://talentics.id/download/file_uploaded/identity_card/1625642548/2019-07.pdf"
},
{
"name": "npwp_card",
"value": "https://talentics.id/download/file_uploaded/npwp_card/1625642554/2019-08.pdf"
},
{
"name": "bank_book",
"value": "https://talentics.id/download/file_uploaded/bank_book/1625642557/2019-09.pdf"
},
{
"name": "other_document",
"value": "https://talentics.id/download/file_uploaded/other_document/1625642560/2019-10.pdf"
}
]
}Example Request
curl -H "Content-Type: application/json" -H "x-callback-token:{callback_token}" -X POST -d '{"id":30,"applicant_id":123,"name":"John Doe","email":"[email protected]","application_time":"2020-08-03T23:04:24.000000Z","previous_stage":{"id":30,"stage_id":30,"name":"Online Psychotest","updated_at":"2020-08-03T23:04:24.000000Z"},"current_stage":{"id":31,"stage_id":31,"name":"Interview","updated_at":"2020-08-03T23:04:24.000000Z"},"next_stage":{"id":32,"stage_id":32,"name":"Final","updated_at":"2020-08-03T23:04:24.000000Z"},"employment_application_form":[{"name":"birthplace","value":"Kota Jakarta Selatan"},{"name":"religion","value":"Moslem"},{"name":"identity_address","value":"Pela Mampang"},{"name":"current_address","value":"Pela Mampang"},{"name":"blood_type","value":"O"},{"name":"marital_status","value":"Married"},{"name":"date_of_married","value":"2018-12-02"},{"name":"number_of_children","value":"1"},{"name":"npwp_number","value":"111111111111111"},{"name":"npwp_address","value":"Pela Mampang"},{"name":"license_number","value":"111111"},{"name":"reference_name","value":"Mary"},{"name":"reference_address","value":"Pela Mampang"},{"name":"reference_phone","value":"0811111111"},{"name":"reference_email","value":"[email protected]"},{"name":"reference_relation","value":"Wife"},{"name":"bank_account_number","value":"1270101"},{"name":"bank_name","value":"BANK BCA"},{"name":"bank_account_name","value":"John Doe"},{"name":"identity_card","value":"https://talentics.id/download/file_uploaded/identity_card/1625642548/2019-07.pdf"},{"name":"npwp_card","value":"https://talentics.id/download/file_uploaded/npwp_card/1625642554/2019-08.pdf"},{"name":"bank_book","value":"https://talentics.id/download/file_uploaded/bank_book/1625642557/2019-09.pdf"},{"name":"other_document","value":"https://talentics.id/download/file_uploaded/other_document/1625642560/2019-10.pdf"}]}'{callback_endpoint}