Table of Contents
Support Guide
DNCscrub.com API Integration
-
Chloe Larson
Integration Summary
ShapeCRM integrates with the DNCscrub.com API to ensure compliance with Do Not Call (DNC) regulations. This integration is intended to verify phone numbers validity as well as identifying known litigators, thus preventing unwanted contact.
Process Overview
To activate DNCscrub.com integration it needs to be enabled in the integration settings area by Shape's Dedicated Support team. Please reach out to help@setshape.com to enable the integration for you.
A record’s primary number (which is the mobile phone) is automatically checked when created within the CRM.
The system categorizes the DNCscrub.com API response codes to determine the appropriate action for each phone number against the VALIDITY check as well as a separate call to check for KNOWN LITIGATORS.
If flagged, the specific reason is added to NOTES and the record is updated as:
- Do Not Contact
- SMS Opt-Out
- Email Unsubscribe
Implementation and Functionality
Record Processing​
Records are processed and checked against DNCscrub.com’s validity API endpoint.
- If passed, the number is then checked against DNCscrub.com’s Known Litigator API endpoint.
- If either fails, the record is flagged DNC, and is opted out for email and sms as well. The reason is added to notes.
Complete List of Result Codes for Validity check.
The DNCscrub.com API returns specific single-letter codes indicating the status of each phone number checked. Here's a comprehensive list for reference:
Passed DNC
These codes indicate that the phone number has passed the DNC check, meaning it is not restricted by DNC regulations and can be contacted.
- C: Clean - Number can be called.
- E: EBR - Valid EBR, not on DNC list, can be called.
- Y: VoIP - Not in any DNC databases or overridden by exemption.
- X: Industry Exemption - Do Not Call number that can be called by exemption.
- O: EBR Override - Do Not Call number overridden by explicit EBR, can be called.
- H: US Wireless/VoI{ and Valid EBR - Overrides DNC, but cannot be called from a predictive dialer.
- G: Valid EBR and US Wireless/VoIP - Not on DNC, cannot be called from predictive dialer
- W: US Wireless - Not in the DNC Database but cannot be called from a predictive dialer.
- R: Expired EBR- Previously valid EBR, not on the DNC list, can be called. (Future availability)
Failed DNC
These codes indicate that the phone number has failed the DNC check, meaning it is restricted by DNC regulations and should not be contacted.
- L: Wireless in no-telemarketing state - Not on DNC, not EBR, can't be manually dialed.
- F: Valid EBR and Wireless in no-telemarketing state - Not on DNC, can't be dialed.
- V: Valid EBR overriding DNC Wireless in no-telemarketing state - Can't be dialed.
- I: Invalid - Inactive area code or special use number.
- M: Malformed - Not 10 digits, error response returned.
- B: Blocked - Area code not covered or in no-call area, no exemptions available.
- P: Project DNC/DNF match - No further checks, determined at Campaign level.
- D: Do not call database match - Additional details in the Reason field.
Keywords: DNC, opt out, unsubscribe, dncscrub.com, integration, API, check, pass, fail, validity check, Do Not Call, regulation
