Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
top
top

...

Section


Column
width80%

Overview

A Contact is a person or a company that your organisation is doing business with. CRM.COM maintains full details of your contacts such as emails, phones, addresses, payment methods and this information is used primarily to communicate to contacts. In addition optional data protection compliance and KYC (Know your Customer) verification information can be handled.  

Setting Up Contacts 

Info
iconfalse
 (Configuration) > CRM > Set up Contacts Settings



Before you start using Contacts, you must set up the system to reflect your own business needs.

Anchor
status
status
Settings


Contact Settings provide a set of rules associated to contact identification and authorisation

Supported Types
Anchor
Supported Types
Supported Types


Supported types are the various types of contact details allowed for Addresses, Emails, Phones and Relations. The contact details available are the same for both 'Person' contacts and 'Company' contacts.

  • Label: Give the preferred name to be used by the system for each specific contact detail, if the label is left blank then the original name provided will be used (e.g Home, Business etc.).  
  • Supported for Person/Supported for Company:  Select which details should be available on the Contacts screen for both person and company contacts. 
  • Mandatory for Person/ Mandatory for Company: Specify whether it should be compulsory to provide this information during contact creation. 
  • Default for Person/Default for Company: Select one of the chosen supported types to be the default selected type for person contacts, and one for company contacts.   

Categories


Configure the Categories to be used for classifying contacts according to their business role (e.g. customers, partners etc.). Use the +New option to create a category. Categories can be created using a hierarchical structure, if a category is a parent category then leave 'Parent' blank.  

Industries and Industry Sectors


An economy is made up of sectors which can be broken down into industries. A sector refers to a large segment of the economy, whereas an industry consists of a specific group of companies with common business activity. An example of an industry sector could be Food & Beverage, and its industries (among others) could include hotels & tourist accommodation, restaurants, snack bars, cafeterias etc. Once industries and industry sectors are configured in the system, they can be added to 'Company' type contacts and used for grouping and referencing.

Name Day Rules


Name day rules allow the automatic assignment of a name day to contacts of type 'Person', so that they can be contacted with wishes and/or rewards for  their name day. You can define the name day rules manually, or alternatively import (or export) them using the respective action from the Actions menu option.      

Use the Edit option to initiate the configuration. 

A background process needs to start (run) in order to populate the 'Name day' date for those Contacts satisfying the name day rules. To do this choose Modify, to schedule the background process, then Save, or choose Run now to start the process immediately. Of course name days can also be entered directly from the Contact screen (in the Demographics section) for each individual contact. 

Anonymisation & KYC 



Tip
titleRecommended additional setup
In addition to the above Contact specific settings, the following may also be configured for Contacts to operate at its full capacity.
  • Security Management: Set up Privacy Level Assignment Rules to control creating or modifying Contacts through security settings.
  • System Settings: Define the Formatting Settings regarding Contacts.
  • Communications: Create communication templates, including dynamic links that enable customers to opt in and out of mailing lists.

Back to top

Using Contacts 

Info
CRM > Contacts  

'Contacts' is used to organise the details of customers, prospect customers, users and partners. Specify the search criteria matching the contacts you are interested in locating on the Contacts search screen, or alternatively use New > Person or Company to enter the details of a new contact. Provide the information defined as mandatory on the Contacts  screen and Save the contact. You can Delete a Contact as long as there is no associated account.

 Contacts may have one of the following life cycle states (appears next to the contact's name):

  • Financial - the contact is associated with an account. 
  • Marketing - the contact is not associated with an account, this is the default status when a contact is first created. The 'Marketing' life cycle state of a contact will automatically become 'Financial' if it is associated with an account.
  • Organisational - the contact is associated with an organisational unit or user. Contacts with this life cycle state can also be viewed from the organisational units. Please refer to the System Settings > Network Management Settings manual for further information. 

Importing Contacts 


The most efficient way to create contacts is by importing an Excel or CSV file (Foundation > Utilities > Imports) which will automatically create the contacts, this is especially useful if the contacts are already available on a third party system. Templates in three different formats are available to download in order to prepare the file to be imported. Please refer to the relevant Foundation documentation for more information. 

Addresses


Addresses entered for a contact are used by various processes in the system both for billing and delivery of goods and services. For example, in case of billing, an address can help to determine the taxes to be applied on products bought by the contact, and for delivery, the address can help determine if delivery is possible. Addresses of various types (e.g. Home, Business etc.) can be entered for each contact, one of the addresses must be selected as the primary address.  See Supported Types on how to configure address types.   

Tip
If you would like to use an address auto-complete feature enable Melissa address registry or Google Places Autocomplete from Configuration > System Settings > Setup Regional Settings > Address Registry Settings. For more information refer to the System Settings manual.

Additional Contact Details


At the bottom of the Contacts screen there are five sections available for providing further information regarding the contact:  

  • Demographics/Company Profile: For a 'Person' contact enter date of birth and personal id information, for a 'Company' contact enter business details and company registration information.  
  • Preferences and Relations: Marketing authorisation settings and relations to other contacts are recorded here.
    • Authorisation Preferences: Contacts can opt-in and out of communications regarding direct (in-house) and affiliate (partner) marketing campaigns, but they do not have the option to opt out of communications regarding financial matters, such as bills. Specify whether the contact wishes to receive direct and affiliate marketing material (the settings default to those defined in Authorisation Settings). Contacts can update their authorisation preferences directly from their email, for more information refer to Dynamic Links Settings in the Communications manual.
    • Relations: Identify any contact relation to other contacts (either business or personal), select the type of relation from a list of pre-defined relations provided by the system. Additional contact relations can also be defined (see Supported Types)    
  • Attachments: Any file attachments relating to the contact can be referenced here, e.g. documents supplied by the contact for the KYC verification procedure, consent forms for keeping and processing  personal data etc. For attachments related to KYC verification be sure to specify the attachment 'classification' in order to allow the KYC profile to be assigned correctly.   
  • Security InformationSelect the collaboration profile group to which this contact's details belong. The collaboration profile selected determines which data owned by the particular group can be shared (accessed and/or modified) between other groups with regards to predefined privacy levels. Collaboration groups can be defined via Configuration > System Settings > Setup Network Management Settings > Collaboration Profiles - refer to the relevant Configuration manual for further information.

Back to top

Other Contact related processes

Communicating contact details


The existing details of a Contact can be sent to the Contact through the Communications procedures. It is also possible to automate communications by setting up an 'Event Based Communication Definition' accordingly. You can use tags related to contact details (special text that is automatically replaced by values from a specific entity) when creating communications. Tags are available for selection by typing '#'. Refer to the Communications manual for a complete list of tags.

Anchor
KYC
KYC
KYC Profiles


Know Your Customer (or KYC) is the process through which a company verifies and establishes the actual identity of its customers (contacts). In order to achieve this, the company asks it's customers to provide valid and reliable identification documents (e.g. printed or scanned copies of their ID cards or passports) to be verified against the information given by the customer. KYC is important because it enables a company to have a better understanding of its customers in order to classify them based on their risk profile. The risk profile in turn determines specific restrictions that can be applied such as the ability to obtain an account or buy services and physical goods. Additionally, the KYC profile can be used as a condition in CRM.COM for the assignment of the Account credit limit, and Wallet balance thresholds. 

Setting up KYC Profiles

Info
 (Configuration) > CRM > Setup Contact Settings > KYC Settings 


KYC flows and restrictions are applied only if the KYC Settings definition is 'Active'. Activation and deactivation can be enforced using the Actions option.

Choose Edit to set the following:

  • KYC Profile Expiration SettingsSelect 'Valid for a specific period' to define when the KYC profile of a contact will expire - a value must be supplied (e.g. 2) and a time interval (e.g. days, months, years). Alternatively, selecting 'Always Valid' indicates that the KYC profile of a contact will never expire. In cases where the KYC profile does expire, the contacts will have to go through the verification process again. 
  • KYC Profiles: A list of KYC profiles to be applied to contacts, at least one KYC profile must exist if the KYC definition is 'Active'. 
    • Name: The name of the profile which must be unique.
    • Level: The level number to allow ordering of the KYC profiles (also see note below). 
    • Alternative Code: The KYC profile code. If it's not supplied then it will be automatically generated by the system. 
    • Requires Verification: Indicates whether the KYC profile will require verification after it is assigned to a customer.
    • Default: Select the default KYC profile. 
  • KYC Person Profile Rules KYC Company Profile Rules: These are the business rules that will determine the required contact details for each KYC profile to be used to subsequently establish if a contact passes the verification procedure or not. You can define separate KYC rules for individuals (person) and for companies. 

    • Field: Select the item of information to assign to the KYC profile, all contact details are available for selection. 
    • Semi-optional: This indicates that either one of two contact details must be supplied in order to apply the KYC rule (e.g. provide either the contact's ID number or passport number). At least two or none contact details must be marked as semi optional. 
    • Attachment classification: Indicate if a copy of a particular document type must be supplied by the contact to verify the specific contact details. An attachment can be a printed/scanned copy of a reliable document that proves information validity.  
    • Requires renewal: Identify which contact details require renewal after a period of time, e.g. an ID number doesn't require renewal as it never changes, but a passport number does.  
    • KYC Profile: Select the KYC profile to which this contact detail belongs to. 
Note

KYC profiles are applied in a hierarchical  manner, e.g. if there are two KYC profiles - KYC profile level 1 (lower level) and KYC profile level 2 (higher level), then KYC profile level 1 is a sub-set of KYC profile level 2. This means that if a contact is assigned KYC profile level 2 then all the elements belonging to both KYC profile level 2 and KYC profile level 1 must be fulfilled. 

Using KYC Profiles 

On creating a contact with an account (i.e. a contact of life cycle state 'Financial') the system will attempt to assign the KYC profile based on the configured KYC rules. If any of the rules have been specified as requiring an attachment (with a given 'Attachments classification') then these documents must be included in the Contact's 'Attachments' section with the correct classification in order to fulfill the KYC rule requirements. 

The KYC life cycle state indicates the customer's KYC verification progress:

  • Pending verification: The customer has provided the necessary information but it has not yet been verified. 
  • Verified: The contact's information has been verified and accepted.
  • Refute: Verification failed. Not all the required information has been provided to allow verification, further actions are required (e.g. not all documents were submitted or uploaded documents have to be resent by the contact)
  • Expired: The customer's KYC profile has expired and the whole verification procedure needs to be repeated again.

By default, a financial contact is allowed to buy physical goods or services only if their KYC status is 'Verified'. Contacts whose KYC profile is not verified or has expired cannot perform transactions.   

If a customer's KYC status is set to ‘Refute’ or ‘Expired’ then the customer will be required to re-submit all necessary information or documents again for verification purposes.  It is up to the user to ‘Verify’ or ‘Refute’ a customer’s KYC profile using the respective actions (see below), however a profile is automatically set to ‘Expired’ in any of the following cases:

  • The allowable time frame since the customer's profile was last verified has expired - this expiration period is set in the KYC definition. 
  • The ID card expiry date has passed 
  • The passport expiry date has passed 

Whenever a contact is created or edited, the KYC profile is assigned accordingly if the following conditions are met:

  • The necessary fields defined in the KYC definition are provided for the contact and that they comply with the defined requirements.  
  • The contact is associated to an account (i.e. the contacts life cycle state is 'Financial').

When a contacts KYC state is set to 'Pending Verification', this denotes that 'Requires Verification' was selected for the KYC profile during definition. In this case, there are two options available in the KYC profile information box (Contact screen) allowing the user to change the Contact's KYC state:
  • Verify:  The required documentation has been provided and validated by an agent against the information given by the contact. Once selected the life cycle state changes to 'Verified'. 
  • Refute: The required documentation has not been submitted or must be re-sent. The agent must give a reason for refuting, and the life cycle state changes to 'Refute'. 

Note
If you have refuted a customer due to inadequate or unverified information, the life cycle state can be changed back to 'Pending Verification' (using Actions > Reassign KYC Profile) and then verified once this information has been provided .

Expiring KYC profile: The KYC expiration process is a background process that checks the date of when each KYC profile should expire (based on the KYC configuration) and updates the KYC state of the profile to 'Expired'. 

Communicating KYC information to customers: This can be achieved by creating customer lists (segments) of financial customers with a specific KYC profile which expires in a user-defined number of days, and notifying the customers by sending them communications through a batch process. It is also possible to instantly privately communicate to a customer any changes associated to their KYC profile, so that they are informed upon a specific change. More specifically you can instantly send a communication (email/SMS) to customers upon the following events:

  • On Assigning a KYC profile
  • On KYC Profile Verification
  • On KYC Profile Refute
  • On KYC Profile Expiration
Refer to Configuration > Setup Communication Settings > Event-based Communication Rules and Foundation > Segmentation manuals for more information on how to set up the Event Based Communications, create and notify customers, and create the lists of customers that should be notified.

Back to top   

Anchor
GDPR
GDPR
Contact Consent 


In order to comply with your regional data privacy laws and the General Data Protection Regulation (GDPR - EU law), certain measures must be taken by businesses to protect every individual's rights to control how their personal information is collected and processed. The following tools are available in CRM.COM to ensure that the collection and processing of personal data from your customers conforms to your regional data privacy laws and the General Data Protection Regulation.
  • Requesting Contact consent for keeping and processing data.
  • Anonymising data for contacts who have withdrawn their consent or who have been inactive for a specific period of time.
  • Know-Your-Customer profiles for identifying and verifying the contact's details.
  • Deleting contacts if certain criteria are fulfilled.

Each Contact has a state associated to their consent which can be one of the following:

  • Pending: Contact has not yet provided their consent. 
  • Accepted: Contact has provided their consent.
  • Rejected: Contact has not given their consent.
  • Withdrawn: A contact who previously provided their consent has withdrawn it. 

Setting up Contact Consent 


Info
 (Configuration) > CRM > Setup Contact Settings > Settings > Consent Settings

Image Modified

'Enable contact consent' so that you can set up how data of contacts can be manipulated according to the consent state (with the exception of cases where the contact has provided their consent 'Accepted' in which case there are no restrictions or options to restrict) . In all other cases the following options are available.

  • Complete functionality: Indicates that the contacts and the actions applicable for them are fully functional.
  • No functionality allowed: Indicates that no further actions can be applied on these contacts, but they will exist as contacts in the system, (only available for 'Rejected' and 'Withdrawn' states).
  • Anonymise Contact: Indicates that contacts will be fully anonymised and no longer functional in any way (only available for 'Rejected' and 'Withdrawn' states).
  • Import consent form automatically: Select if a general consent form will be automatically provided for each contact when created. If this is the case, then select the consent form filename from the drop-down list provided in the attachments library (see below). This feature is used in conjunction with the Contact accepting/rejecting consent via e-mail.

To define the relevant documents associated with contact consent visit Configuration > System Settings > Setup and Manage Attachments.

  • Attachments Classification: Define the attachment categories to be used. 
  • Attachments Library: Create a library of files or URL's to serve as attachments for the consent procedure.

Using Contact Consent  

A contact consent state (apart from 'Pending' which is the default state) can be changed in the system in 3 different ways:
  1. By using the dedicated action from the Contacts page Add consent form in which case the consent state can be selected and the consent form can also be uploaded.
  2. By using links available in emails or SMS sent to the contacts through which the contact can either accept or reject the consent. For more information on using links refer to the Communications manual.
  3. Through a third party system such as a portal or mobile app which can make use of the associated WEB APIs.

A contact consent form can be attached to every Contact through which their consent can be verified. The consent form can be individualised, for example, a scanned copy of a signed accepted consent form, or alternatively, a global consent form which is the same for all contacts. If the form is individualised then it can be added using the dedicated action on the Contact screen Add Consent Form in which case a consent form can be uploaded or selected through the attachment's library. If however the consent form does not need to be individualised, then it can be automatically attached to all contacts by specifying the consent form in the Contact Consent Settings (described above). The contact's relevant attachment documents are included in the 'Attachments' section on the Contact screen.  

Requiring re-consent: From time to time it may be necessary to update the general consent form, therefore requiring re-consent from the contacts. This is possible by using the 'Require Re-Consent' action available on the Consent Settings screen and is available only if the 'Import consent form automatically' has been activated. This is applicable only for contacts that have either accepted, rejected or pending consent state. Once the action is selected a process will run and the following information will be updated:
  • Consent State: Pending
  • Consent Updated Date: empty
  • Consent Form: updated with the new attachment (ensure that the new file has been updated or exists in the attachments library first) 

The affected Contacts are then considered as 'Pending Consent' and the respective functionality applied based on the Contact Consent Settings.

Exporting customer data: Information associated with each individual contact can be exported in various formats and even sent to them via email. This functionality is possible via the Printouts option on the Contacts summary screen. 

Audit trail: An audit trail is a list of changes to the Contact or associated contact details kept on record by the system, and can be viewed by the user. Reports are available which display a list of the audit trail logs for a specific Contact and its related entities, and another to display the changes performed on a contact by a specific user. For more information on Audit Trail refer to Network and Security Setup.

Anchor
anonymize
anonymize
Anonymising Contacts
 


The anonymisation process is vital to GDPR compliance. Once a contact is anonymised then no CRM.COM functionality is possible, including updating or executing any action on the Contact or associated accounts, service requests, activities etc. Financial transactions imported to the system which may be related to an anonymised account are posted on the System's Suspense Account instead (available through Account Definitions). 

Setting up Anonymisation 

Info
 (Configuration) > CRM > Setup Contact Settings > Anonymisation

Define whether the contact anonymisation functionality should be enabled, then provide the necessary settings for extra checks before the anonymisation takes place in order to safeguard against erroneous anonymisation. The Minimum Number of Months which must have passed since the last contact update, subscription termination, financial transaction and wallet transaction posting. Then schedule when the process should be repeated as required. 


Using Anonymisation 

A contact can be anonymised in the following three ways:

  • Using Actions > Anonymise Contact on the Contact screen (if the anonymisation process has been enabled in Configuration > CRM > Setup Contact Settings > Anonymisation). 
  • Through the batch process that can be set up in the Anonymisation section of Contact Settings.
  • Once the Contact rejects or withdraws consent and the Consent Settings of the Contact definition are set to anonymise the contact.

A contact cannot be anonymised if it:

  • Is associated to a user, a group, a unit or a community.
  • Has a running subscription, job, activity, service request or lead.
  • Has un-billed items.
  • Does not meet the conditions set in the Anonymisation settings. 
  • Has a 'Financial' life cycle state (only 'Marketing' contacts can be anonymised). A Contact must first be converted to 'Marketing' by terminating their account. 


Note
Check Appendix A for a full list of the data in CRM.COM that is anonymised once the process takes place.



Ui expand
titleAppendix A

Anchor
appendix
appendix
Appendix A - Anonymised Data

The following data will be set to 'Anonymised' once the anonymisation process is executed.

Entity
Field
Contact First Name and First Name UC
Contact Middle Name and Middle Name UC
Contact Last Name and Last Name UC
Contact ID Number
Contact ID Registration Country
Contact Passport Number
Contact Passport Registration Country
Contact Social Security Number
Contact Date of Birth - Day, Month, Year
Contact Company Name and Company Name UC
Contact Tax Reference Number
Contact Registration Number
Contact Registration Country
Contact VAT Number
Contact All Address Information
  • Street number
  • Street Name
  • Postal Code
  • Floor
  • Apartment Number
  • Area
  • City
  • District
  • Municipality
  • PO Box
  • PO Box Postal Code
Contact All Phones Information
  • Area Code
  • Phone number
  • Full phone number
  • Country
  • Notes
Contact All Emails Information
  • Email Address
  • Notes
Contact Attachments
  • File Name
  • File Content
  • URL
Contact All "From Values" and "To Values" from Contact's Audit Log
Accounts Name and Name UC
Accounts Number
Accounts Payment Preferences
  • Used for recurring payments
  • Medium identifier
  • Medium Type
  • Medium Brand
  • Bank
  • Bank Branch
  • Bank Account Type
  • Bank Account holder
  • Bank Account number
  • IBAN
  • BIC
  • Unique Mandate Ref
  • Mandate Sign Date
  • Mandate Terminate Date
Payment Gateway Cards
  • Reference Number
  • Card holder name
  • Brand
  • Type
  • Card holder address line 1
  • Card holder address line 2
  • Card holder address city
  • Card holder address zip
  • Card holder address state
  • Card holder country
  • Card holder address line 1 check result
  • Card holder address zip check result
  • Card holder address security code check result
  • Default
  • Last digits
  • Finger print
  • Expiration month
  • Expiration year
Accounts All Presentment Preferences Information (method, value, is active)
Accounts All "From Values" and "To Values" from Account's Audit Log
CommunicationsSubject
CommunicationsDescription
CommunicationsShared Notes
CommunicationsTo Recipient
CommunicationsFrom Recipient
CommunicationsContent
Financial Transactions
  • Credit notes
  • Invoices
  • Invoice Cancellations
  • Payments
  • Payment Cancellations
  • Refunds
Shared Notes
SubscriptionsNotes
Subscription ActionsCancellation Notes
ActivitiesDescription
ActivitiesShared Notes
ActivitiesContact email
ActivitiesContact phone
JobsDescription
JobsShared Notes
JobsContact Info Phone
JobsContact Info Email
Customer Events
  • Purchase
  • Referral
  • Social Media
  • Web
  • Achievement
  • Financial Achievement
  • Financial Statement
  • Spend Requests
Description
Service RequestsDescription
Service RequestsShared Notes
Service RequestsCaller Email
Service RequestsCaller Phone
LeadsDescription
LeadsShared Notes
LeadsContact Info Phone
LeadsContact Info Email
Rated Billing Items
  • Normal Subscription RBI
  • Normal UDR RBI
  • Prepaid Subscription RBI
  • Prepaid UDR RBI
  • Job RBI
Cancellation Notes
Access TokensAuthentication code
Access TokensIdentifier
Access TokensPass code





Column
width20%


Panel

On this page

Table of Contents
maxLevel3


Panel

For the developer

Check out the Contact WEB API for APIs for a complete list of actions available to integrate CRM.COM to external systems.

Ui button
colorblue
newWindowtrue
iconlink
titleSelf-service WEB APIs
urlhttps://speca.io/CRM/self-service#subscriber_group

Ui button
colorblue
newWindowtrue
iconlink
titleBack office WEB APIs
urlhttps://speca.io/CRM/backoffice-admin#contact_group



Panel

Analytics

Check out reports and dashboards available for Contacts 

Ui button
colorturquoiseblue
iconinfo
titleAnalytics
urlhttps://discover.crm.com/display/WIP/2019Analytics+-+R18



...