This guide covers the Cognism Enrichment Integration in Nooks. It will walk through the steps to connect Cognism to Nooks, how the enrichment feature works, and some frequently asked questions about the integration. 

Background

Nooks Enrichment helps users quickly get new mobile numbers and email addresses for their prospects. This tool helps reps save time, increase coverage, and improve connect rates by streamlining the data enrichment process. 

Nooks Numbers partners with Cognism as an out-of-the-box data enrichment provider. When Cognism is used to enrich phone numbers without the Cognism API passthrough integration being connected, Nooks Enrichment credits will be consumed. 

By connecting the Cognism enrichment integration, teams that are current Cognism customers can use their Cognism credits (instead of Nooks Enrichment credits) to enrich prospect phone numbers in Nooks. Reps can use Cognism either as a standalone provider or as part of a waterfall enrichment process, which sequentially searches multiple providers for new phone numbers.

Setup Requirements

The Nooks <> Cognism integration requires you to be a current Cognism customer. 

To complete the setup steps, you will need to be an admin user in Cognism and an admin or manager in Nooks.

Integration Setup Steps

Follow the steps below to connect the Nooks <> Cognism enrichment integration.

Step 1: Generate Cognism API Token

To connect Cognism to Nooks, you need to obtain an API Token in Cognism. To do this:

1. Log in to Cognism using user admin credentials.

2. Click on your Profile Icon, then select Settings.

3. In the left-hand navigation menu, select Tokens/API. 

4. Click the blue +Create New Token button.

5. Once the new API Token is created, click the clipboard icon to the right of it to copy it. 

6. Do not navigate away from this page until you have entered the API Token into Nooks. 

This guide from Cognism’s help center contains additional information on how to generate a new Cognism API Token.

Step 2: Enter the API Token in Nooks

Once you have the API Token, head to the settings page in Nooks to connect the Cognism enrichment integration. To do this:

1. Open the Nooks web app. 

2. In the left-hand navigation menu, click Settings > All Settings.

3. Under Integrations, click Nooks Enrichment or Nooks Numbers.

4. Click the Connect Cognism button. 

5. In the pop-up window, enter the Cognism API Token you copied from Cognism. 

6. Press the Connect Cognism button in the lower-right of the pop-up.  

Once the Cognism integration is connected, users can use Cognism to find new phone numbers in Nooks.

Connection Errors

If an error occurs when you click the Connect Cognism button, a notification will appear in the top-right corner of the screen. Below are the steps to resolve common connection errors.

Phone Number Enrichment with Cognism

When using Cognism for prospect phone number enrichment, Nooks attempts to find a net-new mobile phone number for the prospect. Nooks will not use Cognism to look for other phone number types (e.g., direct dial phone numbers) for the prospect. 

If your team has configured successful enrichments to map to a field in your CRM, Nooks will map enriched mobile numbers found in Cognism to that designated field on the prospects' corresponding CRM records. 

DNC List Screening during Phone Number Enrichment

The Nooks <> Cognism API passthrough integration helps ensure that Do Not Call screening is applied during the enrichment process. Nooks is not a data provider, but a vehicle for enrichment integration partners, such as Cognism, to enrich in Nooks. Nooks reflects the logic and suppression rules already established in Cognism to identify and suppress restricted numbers at the time of enrichment in Nooks. Nooks solely relies on Cognism’s API to filter these contacts before they are surfaced in Nooks. 

This guide in the Cognism help center contains more information on how Cognism handles DNC suppression.

Cognism Credit Usage

Enriching phone numbers via Cognism consumes crtedits. The source of these credits depends on whether your integration is active:

• Before Connecting (Default): Enrichment uses your team's Nooks Enrichment credits.

• After Connecting (API Passthrough): Enrichment uses your organization's Cognism Bulk Credits.

When Nooks enriches a number using Cognism, credits will be deducted from your organization’s Bulk Credits in Cognism. Because using Cognism to enrich phone numbers in Nooks leverages the Cognism API, Nooks is unable to reference any user-specific limits that your team has configured in Cognism’s app settings. 

When the Cognism API Passthrough Integration has not been connected and Nooks is used to enrich a number with Cognism, credits will be deducted from your team’s Nooks Enrichment credits. Connecting the Cognism API Passthrough Integration shifts credit usage from your team’s Nooks Enrichment credits to your team’s credits in Cognism.

Cognism Enrichment Integration Health Monitoring

Nooks will alert you if an error is detected with your Cognism API passthrough integration. There are two potential errors that will appear.

Cognism credentials are no longer working. Enrichments using Cognism will fail – contact an admin or manager to reconnect.

• Where this error appears: This error will appear at the top of the Nooks Numbers page and at the top of the Nooks Enrichment or Nooks Numbers settings page. A "Credentials Error" chip will also appear next to Cognism in the Data Providers section of the Nooks Enrichment or Nooks Numbers settings page.

• How to resolve this error: This error indicates Nooks has lost connection to the integration, most often because your Cognism API key has expired or been deleted. To resolve this error, try reconnecting to the Cognism enrichment integration.

Cognism enrichment credits are exhausted. Contact an admin or manager to purchase more credits.

• Where this error appears: This error will appear at the top of the Nooks Numbers page and at the top of the Nooks Enrichment or Nooks Numbers settings page. A "Credentials Error" chip will also appear next to Cognism in the Data Providers section of the Nooks Enrichment or Nooks Numbers settings page.

• Steps to resolve this error: This error indicates that your team has run out of credits in Cognism. To resolve this error, purchase additional credits through Cognism.

FAQs