How to use Zapier to connect Alpharun to other apps

This guide will show you how to integrate Alpharun with other applications using Zapier's Webhooks functionality. This allows you to automatically send interview data from Alpharun to other apps whenever a candidate completes an interview call, or when an interview is advanced or rejected in the Alpharun dashboard.

• An Alpharun account

• A Zapier Professional account, so that you can use the Webhooks "Catch Hook" trigger

1. Create a New Zap in Zapier:

   • Log in to your Zapier account.

   • Click the "Create Zap" button.

   • You will be presented with the Zap editor, where you will add a Trigger to start your Zap.

2. Choose "Webhooks by Zapier" as the Trigger App:

   • In the Zap editor, search for "Webhooks by Zapier" in the trigger app search bar.

   • Select "Webhooks by Zapier" from the results.

3. Select "Catch Hook" as the Trigger Event:

   • Under "Trigger Event," choose "Catch Hook."

   • Click "Continue."

4. Copy the Webhook URL:

   • Zapier will generate a unique webhook URL for your Zap.

   • Click the "Copy" button to copy this URL to your clipboard. You will need this URL in the next step.

5. Configure Webhooks in Alpharun:

   • Log in to your Alpharun account and to go the Webhooks section in Settings

   • In the webhooks portal, click "Add Endpoint"

   • Paste the webhook URL you copied from Zapier into the "Endpoint URL" field

   • Add a description for this webhook, like "Notify Zapier when Candidates are Advanced" or "Notify Zapier when new interview calls are completed"

   • Toggle the events you want to be notified of ( interview.call.completed, interview.advanced, or interview.rejected)

   • Click "Create" to create your webhook.

6. Test the Trigger:

   • Return to your Zap in Zapier.

   • It's good practice to test your connection before adding an action. To do this, send some sample data to your webhook. You can do this by completing a test call in Alpharun or by advancing/rejecting an existing interview. The sample data will depend on the event_type that is triggered.

   • Click the "Test trigger" button in Zapier. Zapier will listen for incoming data from the webhook URL.

   • If the test is successful, Zapier will display the data it received from Alpharun. This confirms that the connection is working.

   • Click "Continue."

7. Add an Action to Your Zap:

   • Now that your trigger is set up, you can choose what happens with the data Alpharun sends.

   • Click the "+" icon below the trigger step to add an action.

   • Select the app you want to connect to (e.g., Google Sheets, Slack, your CRM).

   • Choose the action you want to perform in that app (e.g., "Add Row," "Send Channel Message," "Create Contact").

   • Follow the prompts to connect your account and configure the action. You can use the data from the Alpharun webhook to populate fields in your action step.

8. Map Alpharun Data to Your Action Fields:

   • When configuring your action step, you'll see options to insert data from the Alpharun webhook.

   • Click in a field and select the corresponding data point from the "Insert Data" menu. For example, you can map the candidate's email from Alpharun to the email field in your CRM.

   • Here's how you might map some common Alpharun data:

     • Candidate's Name: Use interview.contact.first_name and interview.contact.last_name.

     • Candidate's Email: Use interview.contact.email.

     • Interview Date: Use interview.completed_at.

     • Assessment Score: Use interview.insights.assessment_score.

     • Strengths/Weaknesses: Use interview.insights.strengths and interview.insights.weaknesses.

     • Recording URL: Use interview.calls.recording_url (note that an interview might have multiple calls; you may need to loop through this array in some cases).

     • Event Type: Use event_type. You might use this to customize the action depending on whether a call is completed, an interview is advanced, or rejected.

9. Turn On Your Zap:

   • If everything looks good, give your Zap a descriptive name.

   • Click the toggle in the top right to turn your Zap on.

• Push Candidate Data & Assessments to an ATS (e.g., Greenhouse, Lever)

  • Trigger: Catch Hook in Zapier (receives data when interview.call.completed, interview.advanced, or interview.rejected events occur in Alpharun).

  • Action:

    • Find or Create Candidate in your ATS. Use the interview.contact.email from Alpharun to search.

    • Add Candidate Stage Change (or similar action) to move the candidate in your ATS pipeline.

    • Create Note or Update Custom Fields in your ATS. Add details like interview.insights.assessment_score, interview.insights.strengths, interview.insights.weaknesses, and interview.calls.recording_url to the candidate's profile.

  2. Trigger Email to Hiring Candidate when a Candidate is Advanced

  • Trigger: Catch Hook in Zapier (specifically triggered by the interview.advanced event).

  • Filter: Add a "Filter" step in Zapier to continue only if event_type is interview.advanced.

  • Action: Send Email (using Zapier, Gmail, Outlook, or your email provider).

    • To: candidate's email

    • Subject: Next steps in your application process

    • Body: Congratulate the candidate on passing the interview and share next steps with them, like conducting a final interview (consider adding a scheduling link) or running a background check

• The interview.call.completed event will trigger every time a candidate completes a call. If a candidate completes their interview over multiple sessions, this event will fire multiple times for the same interview.

• The interview object in the webhook payload contains all data from all calls in the interview, even if the event_type is interview.call.completed.

By following these steps, you can effectively connect Alpharun to Zapier and automate your interview data workflow, saving you time and improving your team's efficiency. If you have any further questions, please contact support@alpharun.com.