Aircall is the phone system for modern business. An entirely cloud-based voice platform that integrates seamlessly with popular productivity and helpdesk tools that workplaces are already using, Aircall was built to make phone systems as easy to manage as any other business workflow—accessible, transparent, and collaborative.

Authenticating

Aircall uses API Key Auth, a developer-friendly delegated access protocol. Quolum has already connected the necessary wires with Aircall. Using a sequence of click-throughs, your organization's administrator allows Quolum to make API calls to Aircall without getting access to passwords.

Step 1: Initiate a connection to Aircall

Click the Connect button from the Connections card. If you are not an admin, you can invite your organization's Aircall admin to make a connection to your Aircall organization account. When you click on the Connect button, the web browser will open a pop-up asking API Key and API Secret as shown in Step 2.

Step 2: Log in to Aircall

Log in to Aircall using your organization's credentials. The exact login mechanism may depend on your Aircall plan, and the sign-in mechanism used. You may have corporate SSO such as Azure AD, GSuite, or Okta along with multi-factor authentication. Sometimes you may need to enter an API key and a token, the step by step details of which can be found in step 3. Once you have successfully logged-in you can find the API Key and API Secret as mentioned below in Step 3.

Step 4: Back to Quolum

Once you have granted access to Quolum, the Connect button on the Connections card would now say Reconnect. Reconnect is used to reauthenticate under circumstances where the access has expired.

Under the hood

Using the OAuth protocol, Quolum now has delegated access to your Aircall Workspace. The Quolum server, running on Amazon AWS VPC, will be able to make API calls and retrieve feature-level utilization of projects, stories, and tasks. Later, this data is crunched and available for visualization on the Quolum dashboard.