Skip to main content

Step 1: Get an API key from Ringover

To create a Ringover data source in Plecto, you first need to generate an API key in your Ringover profile. Follow the steps below or follow Ringover's help guide to retrieve your key.

  1. Open Ringover in a new browser tab.

  2. Go to the Developer page and click Create an API key.

  3. On the right, you should see your API key in the sidebar. Copy the key.

  4. Find the Rights column in the same sidebar. Ensure that all metrics have read access so that Plecto gets your data.

  5. You can move on to Step 2, but don't close the Ringover browser tab – you'll need it in Step 3.

Step 2: Create Ringover data sources in Plecto

  1. In Plecto, go to Data sourcesNew data source > Ringover.

  2. (Optional) Rename your credentials.

  3. Insert the API key you generated in your Ringover account and click Next.

  4. Select the data you want to import.

  5. Configure your data source settings. Here, you can change the title, choose the default date, select which fields to import, and more.

  6. Click Next to choose how much data to import and how long you want to keep it in the data source.

  7. Click Import.

  8. Move to Step 3.

Step 3: Activate webhooks in Ringover

Since Ringover doesn't allow for automatic webhook activation, you'll have to do it manually. Here's how to activate the webhooks:

  1. In Plecto, go to Data sources > Credentials and open your Ringover credentials.

  2. You'll have to find your credential UUID.
    The UUID is the alphanumerical string that's part of the URL. The UUID in this example is highlighted in green: app.plecto.com/admin/credentials/ab1234asd5678as23fgh5u7/

  3. Copy the UUID and insert it in the following link: https://app.plecto.com/admin/data-sources/ringover_v2/<credentials_uuid>/hook/

  4. Go to your Ringover tab and open the Developer page.

  5. Find the section Webhooks and activate your webhook by enabling the button on the right.

  6. Take the URL you just prepared with your credential UUID and insert it in the following fields:

    Calls ringing
    Calls answered
    Calls ended
    Missed calls
    Scenario

You've now connected your Ringover data source and successfully enabled webhooks, which means that Plecto will receive and update information from Ringover as it happens. 💪

Available data

Currently, you can import the following data from your Ringover account to Plecto:

  • Call logs

  • Presences

  • Ringing calls – Only imports data through webhooks, which means that it will start importing data only after you've created the data source.

  • Surveys