Skip to main content
All CollectionsFeatures
Whereby Integration
Whereby Integration

With our new Whereby Integration, you can seamlessly analyze your Whereby recordings as soon as a meeting ends. Follow this guide to set up the integration quickly and correctly.

Andreas Grießer avatar
Written by Andreas Grießer
Updated this week

What You’ll Need

Before you begin, ensure you have the following:

  1. Access to your Whereby account.

  2. API Token and Webhook Secret (instructions provided below).

  3. Recordings enabled in your Whereby rooms.

Step-by-Step Setup Guide

1. Navigate to the Integration Settings in Kickscale

  1. Log in to your Kickscale account.

  2. Go to Settings > Workspace.

  3. Scroll to the new section Whereby Integration.

  4. Click on Connect Whereby.

This will open a dialog where you need to enter:

  • API Token

  • Webhook Secret

2. Retrieve Your API Token from Whereby

  1. Log in to your Whereby account.

  2. Navigate to Configure > API.

  3. Generate your API Token.

  4. Copy the token and paste it into the API Token field in the Kickscale dialog.

3. Set Up Your Webhook Secret

  1. In Whereby, scroll down to the Webhook Settings section.

  2. Add a new Endpoint URL.

    • You can find your personal Kickscale Endpoint URL displayed in the dialog on the Kickscale platform. Copy and paste it into Whereby.

  3. Select the Event:

    • When a cloud recording finishes (recording.finished).

    • This ensures Kickscale can analyze your meeting recordings automatically.

  4. After adding the Endpoint, retrieve the Webhook Secret from Whereby.

  5. Copy the Webhook Secret and paste it into the Kickscale dialog.

4. Finalize the Setup

  1. Ensure that Recordings are enabled for your Whereby rooms.

    • Kickscale can only analyze meetings if recordings are enabled.

  2. Save your API Token and Webhook Secret in Kickscale.

🎉 Once saved, your Whereby integration is active! Kickscale will now analyze your recordings as soon as they are finished.

Tips & Best Practices

  • Enable Recordings: Double-check that recordings are turned on for all your relevant Whereby rooms. Without recordings, no analysis can be performed.

  • Secure Your Tokens: Keep your API Token and Webhook Secret private to ensure security.

  • Monitor Events: Verify that the correct event (recording.finished) is selected in your Whereby settings.

Troubleshooting

  • Recordings Not Analyzing?

    • Make sure you selected the correct event: When a cloud recording finishes (recording.finished).

    • Confirm that recordings are enabled in your Whereby rooms.

  • API Token or Webhook Issues?

    • If the connection fails, double-check that the API Token and Webhook Secret are correctly copied into Kickscale.

    • Regenerate a new token in Whereby if necessary and update it in Kickscale.

If you need additional help setting up the Whereby Integration, don’t hesitate to contact us at support@kickscale.com. We’re here to assist!

Did this answer your question?