Nooks
Discover the reps who hold a Nooks seat, and track calls dialed and talk time per rep from the Nooks Dialer
Nooks is an AI parallel dialer and virtual salesfloor for sales teams. The Nooks integration connects your Nooks workspace to Harmony, giving your team visibility into who holds a Nooks seat and how much each rep dials, so reps who stopped dialing stand out. Nooks appears as a managed application in Application Management.
What the Nooks integration enables
User Discovery
Surface every member of your Nooks workspace who holds an active seat
Dialer Activity
Track the calls each rep dials and their talk time, per day, from the Nooks Dialer
Inactive Seats
See which reps have not dialed recently, using each rep's most recent day of dialing
Multi-Workspace Support
Connect several Nooks workspaces, each as its own instance
Prerequisites
Access to Developer Settings in Nooks - you need to be able to open Developer Settings > API Keys in the Nooks workspace you want to connect. This is usually a workspace admin
The Nooks Dialer - for dialer activity. Without it, Harmony still syncs your workspace's members, but not calls (see Troubleshooting)
A Harmony account with admin privileges
Connect Nooks to Harmony
Step 1: Create a Nooks API key
Sign in to your Nooks workspace
Go to Developer Settings > API Keys
Create a new API key and give it a descriptive name (for example,
Harmony Integration)Copy the key right away. Nooks shows it only once. It starts with
nooks-api-
Step 2: Navigate to Integrations
Log in to your Harmony dashboard
Go to Settings > Integrations
Find Nooks under SaaS Applications, or search for it by name
Click its card. If a Nooks workspace is already connected, click + Create instance
Step 3: Enter Credentials
Instance name (required) - for example the name of the Nooks workspace
API key - the key you copied in Step 1
Click Connect
When you click Connect, Harmony asks Nooks which workspace the key belongs to before saving. If Nooks rejects the key, the connection is refused with the reason. If Nooks is busy or does not answer, the connection is also refused; try again in a few minutes.
Once connected, Harmony begins syncing members and dialer activity from your Nooks workspace. To connect another workspace, open the Nooks card again, click + Create instance, and repeat Step 3 with an API key from that workspace.
Disconnect Nooks from Harmony
Log in to your Harmony dashboard
Go to Settings > Integrations
Find Nooks under SaaS Applications and click its card
Click the delete (trash) icon next to the instance you want to remove
Confirm when prompted
Once disconnected, Harmony stops syncing data from Nooks. Previously synced data remains available in Harmony. You can also revoke the API key in Nooks under Developer Settings > API Keys.
What Harmony Syncs from Nooks
Members
Nooks user ID, name, email address and CRM user ID of every member with an active seat. Every listed member is recorded as active
Calls dialed
The outgoing calls each rep placed through the Nooks Dialer in parallel, power or one-off dialing, per day
Talk time
The seconds of a rep's dialed calls that a person answered. Calls answered by voicemail, a phone tree or a machine are not counted
Other calls
Incoming calls, outgoing calls logged in Nooks from another dialer, and calls with no recorded direction, each with their talk time, per rep per day. These show as activity only (see below)
Viewing Nooks Data in Harmony
Application Management - Nooks appears as a managed application, where you can review its member list and each rep's calls dialed, talk time and last activity
User profiles - individual users show their Nooks access alongside other application data
Multiple workspaces - each connected workspace appears as its own Nooks instance
Permissions Explained
Harmony reads Nooks through its Partner API (partner-api.nooks.in), authenticated with the API key you provide. All access is read-only.
GET /v1/me
Identify the workspace the key belongs to
GET /v1/users
Workspace members with an active seat, and the emails that match calls to reps
GET /v1/dialer/calls
Calls placed through the Nooks Dialer, totalled per rep per day
Things to know about the key:
The key cannot be scoped. A Nooks API key has full read and write access to its workspace. Harmony only reads: it does not add or remove members, place calls, or change anything in Nooks or your CRM
Harmony shares your rate limit. Nooks allows 300 requests a minute on each of
/v1/usersand/v1/dialer/calls, and 30 a minute on/v1/me, per workspace across all of your keys. Harmony makes at most two requests a second, leaving most of that for your other tools
Troubleshooting
Data & Privacy
Last updated
Was this helpful?
