# Video Interview Connector
A video interview is a recruiting tool that organizations use to allow hiring managers and recruiters to conduct video interviews with candidates online. Video interviews can be done in an asynchronous or synchronous manner:
- Asynchronous: on-demand interview where candidates record their responses to pre-recorded interview questions
- Synchronous: live interview over the internet
The Video Interview Connector provided by Cornerstone allows for both of these workflows.
# Deep Dive
# On-Demand Video Interview Workflow
- User selects one or more candidates on the Manage Candidates page.
- User selects an interview provider from the list of available providers, and an interview package from the list of available packages.
- (optional) If the provider supports video interview reviewers, user chooses reviewers to provide feedback on the interview when complete.
- The applicant receives an email from the provider notifying them that a video interview has been assigned, and completes the video interview on the provider's website.
- The candidate's video interview status is updated in Cornerstone.
- (optional) Reviewers are assigned to the interview from the Resume Carousel, and reviewers view the recorded interview on the provider's website and provide feedback.
- (optional) The feedback appears on the candidate's Resume Carousel.
# Live Video Interview Workflow
- User selects a candidate on the Manage Candidates page.
- User selects an interview provider from the list of available providers.
- User enters the interview's date, time, and interviewers.
- The applicant receives an email from the provider notifying them that a live video interview has scheduled, and the interview occurs at the scheduled time.
- The candidate's video interview status is updated in Cornerstone.
- (optional) Reviewers provide feedback on the provider's website.
- (optional) The feedback appears on the candidate's Resume Carousel.
# Callback API Key
When posting data to callback endpoints, you must include an API key in your request header. This API key can be found in the client's Cornerstone portal on the Edge Settings page (Admin > Tools > Edge > Integrations > Video Interview Connector).
Header: x-csod-edge-api-key:{API Key for your connector}
# Update Interview Status
When posting results back to Cornerstone, use the callback URL that was provided as part of the initiate video interview request (you will need to store this). This callback URL already contains the necessary tracking information, which means the payload only needs to consist of the updates you want to provide.
# Functional Requirements
You will need the following in order to successfully set up your video interview integration. A client administrator will need to enter these details upon installing the Video Interview Connector through the Edge Marketplace.
- Integration Name This is a name used to identify the integration implemented on the vendor/development partner's system. Your video interview provider or development partner should provide this value.
- Username This is the username provided by your vendor/development partner in order to authenticate the request Cornerstone to the vendor.
- Password This is the password for the username provided by your vendor/development partner in order to authenticate the request from Cornerstone to the vendor.
- Base Service URL This is the base URL endpoint for all the video interview vendor webhooks. This is provided by your video interview vendor.
- Reviewers This should be enabled if your video interview provider supports reviewers and you want to sync interview feedback from the vendor to Cornerstone.
# Technical Specifications
A video interview vendor should set up a new external service and implement against the contracts defined here:
- https://app.swaggerhub.com/apis/csodedge/video-interview_connector/#
- https://app.swaggerhub.com/apis/csodedge/video-interview_connector_callback/#
Note: The external service needs to support TLS 1.2 for its communication with Cornerstone.