Wingman is a real-time sales coaching and notetaking tool for reps. Bridge the gap between coaching & action!

Authenticating

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

Step 1: Initiate a connection to Readme

Click the Connect button from the Connections card. If you are not an admin, you can invite your organization's Wingman admin to make a connection to your Wingman organization account. When you click on the Connect button, the web browser will navigate to the Wingman login page.

Step 2: Log in to Wingman

Log in to Wingman using your organization's credentials. The exact login mechanism may depend on your Wingman plan, and the sign-in mechanism used. You may have corporate SSO such as Azure AD, GSuite, or Okta along with multi-factor authentication. Once you have successfully logged-in you can find the API Key and API Secret as mentioned below in Step 3.

Step 3: Finding API Key in Wingman

Note: API access in Wingman is provided only in Enterprise plan.

To find the API key in Wingman, you can follow these steps:

  • Log in to your Wingman account on the Wingman website (trywingman.com).
  • Click on your profile picture or initials in the top right corner of the screen.
  • Click on "Settings" in the drop-down menu.
  • Click on the "Integrations" tab.
  • Find the integration that you need the API key for and click on "Show credentials".
  • Your API key will be displayed in the "API key" field.

Step 4: Back to Quolum

Once you have granted access to Quolum, Wingman is going to send you back to Quolum's page in Step 1, where you started. 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 Wingman 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.