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 management > Data sources+ New data source > Ringover.

  2. Insert the API key you generated in your Ringover account.

  3. (Optional) Rename your credentials in the Title field.

  4. Click Next.

  5. Choose the data types you want to import to Plecto.

  6. (Optional) Expand the Advanced settings to change the data source title, default date field used in formulas, or other settings. You can access the settings also after you've created the data source.

  7. Click Next to finish and import your data.

Step 2: 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 management > 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 types

For each data type you import, Plecto will create one data source and list it under Data management > Data sources. Currently, you can import the following data from your Ringover account to Plecto:

  • Call logs

  • Presences

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

  • Surveys