This article guides you through the step-by-step process of integrating WeCP interviews with SAP SuccessFactors (SF) using SAP Cloud Platform Integration (SAP CPI). By the end of this setup, users will be able to schedule interviews on SuccessFactors, conduct them on WeCP, and view reports directly in SuccessFactors.
Prerequisites
Access to SAP CPI:
Ensure you have an active SAP CPI account with the appropriate permissions to create integration flows.APIs Required:
WeCP APIs:
POST /api/interviews/schedule– to send interview details to WeCP.POST /api/interviews/link– to receive the interview link.POST /api/interviews/report– to send interview reports to SuccessFactors.
SuccessFactors OData API:
/odata/v2/InterviewSchedules– to fetch and update interview schedules./odata/v2/CandidateProfiles– to update candidate profiles with interview results.
Credentials:
API keys or OAuth credentials for both SuccessFactors and WeCP.
Email Template Configuration:
SuccessFactors should have email templates ready to notify candidates and interviewers with the WeCP interview link.
Integration Steps
Step 1: Configure WeCP as an Interview Platform in SuccessFactors
Go to Admin Center in SuccessFactors.
Navigate to Manage Recruiting Settings.
Add WeCP as an option under the dropdown for Interview Platforms.
Save changes and ensure "WeCP" is selectable during scheduling.
Step 2: Design SAP CPI Integration Flow
SAP CPI acts as middleware, orchestrating the exchange of data between SuccessFactors and WeCP. Follow these steps to create an integration flow.
A. Create a New Integration Package
Log in to your SAP CPI tenant.
Go to the Design tab and create a new integration package named, e.g., “WeCP-SuccessFactors Integration.”
B. Create Outbound Integration Flow
This flow sends scheduling data from SuccessFactors to WeCP.
Retrieve Schedule Data from SuccessFactors:
Use the OData Receiver Adapter to fetch scheduling details:
Endpoint:
/odata/v2/InterviewSchedulesFilter: Fetch only records where the interview platform is "WeCP."
Map the data fields (e.g., interviewer, candidate, time) to match WeCP's API schema.
Send Schedule Data to WeCP:
Use an HTTP Sender Adapter to call the WeCP scheduling API:
Endpoint:
POST /api/interviews/scheduleAuthentication: Configure API key or OAuth 2.0 credentials.
Test the Flow:
Simulate the flow by scheduling an interview in SuccessFactors and verify that WeCP receives the details.
C. Create Inbound Integration Flow
This flow handles data from WeCP (interview link and reports) and updates SuccessFactors.
Retrieve Interview Link from WeCP:
Use an HTTP Receiver Adapter to accept responses from WeCP after the schedule is created.
Map the interview link to SuccessFactors fields.
Update SuccessFactors with the Interview Link:
Use the OData Receiver Adapter to update the interview schedule:
Endpoint:
/odata/v2/InterviewSchedulesPayload: Include the received interview link in the update request.
Retrieve Interview Reports from WeCP:
Use an HTTP Receiver Adapter to accept completed interview reports:
Example payload from WeCP:
{
"interview_id": "12345",
"report_link": "https://wecp.io/reports/unique-report-id",
"report": {
"score": 85,
"feedback": "Candidate demonstrated excellent problem-solving skills.",
"recommendation": "Strongly recommend hiring."
}
}
Update Candidate Profile in SuccessFactors:
Use the OData Receiver Adapter to add the report data to the candidate profile:
Endpoint:
/odata/v2/CandidateProfiles
Test the Flow:
Simulate an interview completion on WeCP and verify that reports are updated in SuccessFactors.
Step 3: Automate Email Notifications in SuccessFactors
Navigate to Admin Center > Manage Email Templates.
Configure the email template for interview notifications:
Use placeholders for candidate name, interviewer name, and the WeCP interview link.
Ensure the email trigger is active for WeCP schedules.
Step 4: Monitor and Test the Integration
Test End-to-End Workflow:
Schedule an interview in SuccessFactors, verify WeCP receives the details, conduct the interview, and confirm that reports are sent back to SuccessFactors.
Monitor SAP CPI Logs:
Use Message Monitoring in SAP CPI to check the status of integration flows.
Set up alerts for failed transactions.
Enable Error Handling:
Configure retry logic for API calls in case of network issues or temporary API downtime.
FAQs
1. What happens if the WeCP API is down?
SAP CPI should be configured with retry logic. If the API remains unavailable, the integration flow will generate an error, which can be resolved manually once the API is back online.
2. How do I customize data mapping?
In SAP CPI, use the Content Modifier or Mapping Step to transform data from SuccessFactors to WeCP’s required format.
3. Can I integrate other platforms like Zoom or Microsoft Teams?
Yes, the same process can be adapted for other platforms by modifying the integration flows and APIs.