Recall.ai ALPHA

Recall.ai allows you to add customizable conferencing bots to video conferencing calls.

Our partnership means it’s easy to add a Recall.ai bot to events created with the Cronofy API. We automatically keep Recall.ai in sync with any changes to the event like reschedules. Meaning you don’t have to build anything to ensure that the bot will join at the right time.

Setting up your Recall.ai integration #

You will need to generate a Recall.ai API key and add it to Cronofy:

Provision a Recall.ai API key #

  1. Log in to your Recall.ai dashboard for the appropriate region
  2. From the menu, choose your API Keys page
  3. Select “Generate API key”
  4. Give your key a meaningful name such as “Cronofy Integration”
  5. Save your new key

Add the key to your Recall.ai Integration in Cronofy #

  1. Sign in to your Cronofy Dashboard
  2. From the menu, choose your Organization Settings page
  3. Select “Manage Integrations” and choose to “Set Up New Integration”
  4. Select “Recall.ai”
  5. Choose the matching region and paste in the key from your Recall.ai dashboard
  6. Save the configuration
  7. Choose which applications you want to use Recall.ai with

Adding Recall.ai to your calendar events #

Recall.ai is added to a calendar event through the extensions attribute when creating or updating the event.

The profile_id to use is shown as the Cronofy Extension Profile ID on your Recall.ai integration configuration page:

This is then used as the profile_id in the extension object when creating an event.

{
  "event_id": "qTtZdczOccgaPncGJaCiLg",
  "summary": "Recall test",
  "start": "2024-12-07T16:00:00Z",
  "end": "2024-12-07T17:00:00Z",
  "tzid": "Europe/Berlin",
  "conferencing": {
    "profile_id": "default"
  },
  "extensions": [
    {
      "provider": "recall",
      "profile_id": "int_YOUR-ID-FROM-THE-DASHBOARD-HERE_0000000000"
    }
  ]
}

Also on the configuration page you can set default options for the bot name and the recording mode.

Recall.ai metadata #

One the bot is provisioned Cronofy will add metadata to the event to allow you to reference the associated bot via the Recall.ai API.

event.metadata.recall - will contain Recall.ai specific values.

{
  ...,
  "metadata": {
    "recall": {
      "bot_id": "02263898-51b1-43ff-8649-2ac71251ea83"
    }
  }
}

Cancelling an already scheduled bot #

In situations where you want cancel a scheduled bot, for example when someone decides they don’t want the session recorded you can update the calendar event by setting the Recall.ai extension profile_id to none.

{
  ...,
  "extensions": [
    {
      "provider": "recall",
      "profile_id": "none"
    }
  ]
}

This will then cancel the bot with Recall.ai.