Blog

PhoneTools: How does TPS and CTPS screening work in Salesforce?

Introduction

PhoneTools is a quick-to-launch TPS and CTPS screening solution for Salesforce CRM allowing your organization to assist with PECR compliance in minutes. The solution is built solely for Salesforce, by Salesforce experts.

Out of the box

Out of the box, PhoneTools supports the following objects:

  • Accounts
  • Contacts
  • Leads

This means that we have already:

  1. Provided a custom trigger for each object
  2. Created the required functional fields for each object
  3. Configured the default phone fields in the “Fields to Screen” settings

This means if you’re using any of the objects and fields listed above, it’s a swift process to implement. If you’re not using the above objects or fields then don’t panic, we cover how to configure PhoneTools for these scenarios too!

How TPS and CTPS screening in Salesforce works

PhoneTools will screen any phone field that is configured in the package’s “Fields to Screen” settings. This means there is no code required to implement (with the exception of a formula if you would like to set up screening criteria, but we’ll cover this later!).

Each object that contains phone fields that need screening against the TPS and/or CTPS database must contain three custom functional fields to track the phone fields’ TPS and CTPS statuses. These fields will also identify when the next screen is due, and provide a summary status for the whole record. A description of these three fields can be seen below:

  • Phone Status Field – provides a record status that summarizes the screening results of the configured phone fields. See more information about the record statuses.
  • Next Screen Due Field – when a record is screened, a date stamp is added 21 days in the future. This will indicate when the record next needs to be screened. (You will not be charged any extra for screening a record more than once a month.)
  • Screening Results Field – a JSON output listing the results for each screened field. This is perfect if you’re interested in doing some custom development on top of the solution.

When a phone number is updated on a record, all three functional fields are set to NULL on the record. This indicates that the record needs screening. This can either be screened manually by your users, or have it automatically screened with a batch job.

When a record is screened, each of the functional fields will be updated in accordance with the response from the PhoneTools service.

How can my users tell what’s safe to call?

A Lightning component needs to be added to the users’ record app pages. This provides a breakdown of the statuses for each configured phone field to screen. See more information about the phone statuses.

The Phone Status Field noted earlier in will also contain a summary status for each record. This can be used in reports to quickly identify records that have all numbers listed on either database, no number listed on either database, or records that contain some numbers that are listed on either database.


Back to the PhoneTools installation walkthrough


PhoneTools TPS & CTPS: Installation Walkthrough

PhoneTools is one of the quickest ways to begin screening your Salesforce records against the UK-TPS and UK-CTPS databases to check whether the numbers are safe to call. This installation walkthrough will get you set up with a basic configuration in no time so you can rest easy and know you have a solution in place.

Introduction

Object and field configuration

Record screening criteria

Lightning component

Screening options

AddressTools Premium: Install a default country for all users (optional)

Install a default value to all user records

To use QuickComplete Country functionality, you are required to install a default country. This populates the custom field pw_ccpro__QuickCompleteCountry__c on the User object for all users in the organization.

You can find out more about the QuickComplete by reading the article here. This is covered later in the installation walkthrough.

To install a default country:

  • Go to App Launcher | AddressTools Administration.
  • Use the picklist and select a Country under Default Country Installation.
  • If the picklist is empty, you may need to refresh the page after completing a data installation.
  • Select Install.

A process will begin in the background to populate the records in the organization. The time taken will vary in relation to how many users are in your organization.


Back to the AddressTools Premium installation walkthrough

IndustryComplete: Map Industry Code Lookup for Lead conversion

Why do I need to make changes to the Lead conversion process?

When using IndustryComplete, the component will populate a custom lookup field (pw_ic__IndustryCode__c) on the Lead records. When a Lead is converted to an Account, it is preferable to retain this information on the Account record. This can be achieved using the Map Lead Fields functionality in Salesforce Setup.

Map Lead Fields

  • Go to Salesforce Setup | Object Manager | Lead | Fields & Relationships.
  • Select Map Lead Fields.
  • Ensure the Account tab is selected.
  • Next to Industry Code Lookup, use the picklist in the Account Fields column and select Industry Code Lookup.
  • Select Save.

Now when converting a Lead, the Industry Code Lookup will be pushed to the Account.

Home: IndustryComplete: Installation Walkthrough

IndustryComplete: Setting up the Industry Lookup component on the Lead object

How to add the Industry Lookup component to your organization

  • Navigate to Setup | Object Manager | Lead | Lightning Record Pages.
  • If a Lead Lightning Record Page already exists, select Edit.
  • If you need to create a new Lead Lightning Record Page, Select New and follow the onscreen steps.
  • Drag the Industries Lookup component from the components list onto the layout.
  • Select Save and Activate.

Now your lead page(s) will be setup with the IndustryComplete Industries Lookup
component ready for use.

Home: IndustryComplete: Installation Walkthrough

IndustryComplete: Enabling the Lead trigger

Enable the Lead trigger

  • Go to App Launcher | IndustryComplete Administration.
  • Ensure that you’re on the Installation & Settings page.
  • Under the Settings heading, select the Enable IndustryComplete trigger(Lead) checkbox.
  • Select Save.

What settings are available with the Lead trigger?

The package comes with one trigger setting for the Lead object:

  • Populate Leads' Industry field from their "Industry Code Lookup" (IndustryCodeLookup__c) field

Home: IndustryComplete: Installation Walkthrough

IndustryComplete: Setting up the Industry Lookup component on the Account object

How to add the Industry Lookup component to your Organization

  • Navigate to Setup | Object Manager | Account | Lightning Record Pages.
  • If an Account Lightning Record Page already exists, select Edit.
  • If you need to create a new Lead Lightning Record Page, Select New and follow the onscreen steps.
  • Drag the Industries Lookup component from the components list onto the layout.
  • Select Save and Activate.

Now your account page(s) will be setup with the IndustryComplete Industries Lookup
component ready for use.

Home: IndustryComplete: Installation Walkthrough

IndustryComplete: Enabling the Account trigger

Enable the Account trigger

  • Go to App Launcher | IndustryComplete Administration.
  • Ensure that you’re on the Installation & Settings page.
  • Under the Settings heading, select the Enable IndustryComplete trigger(Account) checkbox.
  • Select Save.

What settings are available with the Account trigger?

The package comes with three trigger settings for the Account object:

  • Populate Accounts' "Industry Code Lookup" (IndustryCodeLookup__c) field from their SIC field
  • Populate Accounts' SIC field from their "Industry Code Lookup" (IndustryCodeLookup__c) field
  • Populate Accounts' Industry field from their "Industry Code Lookup" (IndustryCodeLookup__c) field

Home: IndustryComplete: Installation Walkthrough

IndustryComplete: Clearing Industry Codes

How to clear previously installed industry codes

To quickly remove all the industry codes that have previously been installed into your organization or manually added, this can be done by following the steps:

  • Go to App Launcher | IndustryComplete Administration.
  • Ensure that you’re on the Installation & Settings page.
  • Under the Clear Industries heading, click the Clear Industries button.

A process will now begin to remove all the records in the pw_ic__IndustryCode__c object.

Home: IndustryComplete: Installation Walkthrough

IndustryComplete: Installing Industry Codes

What are Industry Codes?

Industry Codes belong to standards that have been developed to assist with classifying industries into categories. There are three main Industry Standards:

  • Standard Industrial Classification (SIC)
  • International Standard Industrial Classification (ISIC)
  • North American Industry Classification System (NAICS)

What Industry Code Standards are available in IndustryComplete?

IndustryComplete supports the following codes out of the box:

  • ISICr40
  • NAICS07
  • NAICS12
  • NAICS17
  • USSIC87

You have the ability to customize existing industry code standards or create your own in your organization. See “Customize Industry Codes” for more information.

How to install industry codes

To get started:

  • Go to App Launcher | IndustryComplete Administration.
  • Ensure that you’re on the Installation & Settings page.
  • Under the Install Industries heading, select the industry codes which you would like to install.
  • Select Install Industries.
  • Wait for the process to finish.

Customize Industry Codes

During installation, the Industry Codes will be inserted into the pw_ic__IndustryCode__c object that is created with the IndustryComplete managed package. You have the ability to customize these records to meet your organizational requirements as you would any other record in your Salesforce environment.

A common change is to remove the standard name from the industry code name field. This can be beneficial for integrations that don’t expect an industry standard prefix to the codes.

Example:

“NAICS17-531210” will be installed with the NAICS17 data set. You can remove the “NAICS17-” from the record name leaving just “531210”.

As the Industry Codes object is created in your organization, you can create custom fields on the object to store relevant information on the codes.

Home: IndustryComplete: Installation Walkthrough