This guide outlines the high-level scope and prerequisites for integrating your CRM or MAP with 6sense using a flat file approach, particularly if your system is not natively supported in 6sense.
The flat file integration allows customers to sync data from their internal CRM/MAP platforms into 6sense via secure SFTP. This method ensures flexibility while maintaining data consistency and integrity.
Prerequisites
Before initiating integration, ensure the following requirements are met:
Data Requirement Compliance: Data must follow the schema defined in our data requirement as mentioned below.
SFTP Setup:
Data should be uploaded to the 6sense SFTP location at the agreed time in the contract.
Customers should send the flat file data to the SFTP location specified by 6sense. They can obtain the SFTP endpoint details from their CSM or Product Consultant
Daily File Push: Upload your flat files to the SFTP location daily at the specified time as per your contract.
Metadata Requirement: If you’re sending data for Lead, Contact, Opportunity, or Account objects, you must also include the corresponding metadata file. Refer to the Metadata requirement for more details.
Data should be restricted to only following data types:
String
Picklist
Combobox
Textarea
Reference
Url
ID
Phone
Email
Multipicklist
Datetime
Date
Address
Double
Currency
Boolean
Int
Percent
Data requirement
Customers must map their internal objects from their CRM/MAP to the minimum object requirements specified for their ABM and Sales Intelligence plans.
We recommend that the customer provide the data in the following specified format for all the mandatory objects.
Recommended file format
File Type: CSV
File Naming Convention:
YYYYMMDD_YYYYMMDD_CUSTOMERNAME_CRM_OBJECT.csv
Example: 20171101_20190607_ABC_CRM_CONTACT.csv
Data Source Name(Internal to 6sense):
Note: This section is only relevant for the Product Consultant or Adoption Consultant from the 6sense team who is configuring the Flat File for customers. Customers do not need to be concerned with this data source.
For Account object: {org_name}_crm_account
For Contact object: {org_name}_crm_contact
For Lead object: {org_name}_crm_lead
For Opportunity object: {org_name}_crm_account
For Account Team Member object: {org_name}_crm_account_team_member
Sample data structure
File type: csv |
File name format: YYYYMMDD_YYYYMMDD_CUSTOMERNAME__CRM_CONTACT.csv |
Sample file name: [20171101_20190607_CUSTOMERNAME _CRM_CONTACT.csv] |
id | contactname | country | city | modifieddate | Create date |
---|---|---|---|---|---|
123456 | David | USA | Tempe | 12/12/2020 | 12/12/2020 |
723456 | Joseph | India | Delhi | 13/8/2020 | 13/8/2020 |
444343 | Timur | Spain | Madrid | 8/9/2020 | 8/9/2020 |
943456 | Rishi | USA | Clifton | 03/7/2020 | 03/7/2020 |
833545 | Abhi | USA | Las Vegas | 02/8/2020 | 02/8/2020 |
566565 | Justin | India | Pune | 28/2/2020 | 28/2/2020 |
782828 | Riyaz | USA | Seattle | 16/4/2020 | 16/4/2020 |
345666 | Steven | USA | Bristol | 9/3/2020 | 9/3/2020 |
Metadata requirement
Metadata is required for creating filters, displaying information on Sales Intelligence dashboards, and is also used in predictive modelling. Customers are expected to provide this information, in addition to data drops, to help us understand the structure of their data and any changes to it (such as column deletions or data type modifications).
When to send Metadata
Initial Onboarding: When you first upload data to 6sense.
Schema Changes: Any changes to your object schema, such as:
Data type modifications.
Column deletions or additions.
Note: If there’s no change in your schema, you do not need to resend the metadata file. 6sense will assume the existing metadata is still valid.
Required objects
Metadata must be provided for:
Lead
Contact
Account
Opportunity
Account Team Member
Metadata file format
File Type: csv
File Naming Convention:
objectname_metadata.csv
Example: contact_metadata.csv
Sample Metadata structure
File type: csv |
File name format : objectname_metadata.csv |
Sample file name: [lead_metadata.csv] |
FieldName | Data Type | Metadata | isdeleted | label |
---|---|---|---|---|
id | int | FALSE | Lead ID | |
firstname | string | FALSE | First Name | |
lastname | string | FALSE | Last Name | |
string | FALSE | Email ID | ||
jobtitle | string | FALSE | Job Title | |
createddate | date | FALSE | ||
modifieddate | date | FALSE | ||
accountid | string | FALSE | Account ID | |
country | string | FALSE | Country | |
department | string | FALSE | ||
leadsource | string | FALSE | ||
decisionrole | string | TRUE | ||
jobfunction | string | FALSE | ||
phone | long | FALSE | ||
nolongeratcompany | string | FALSE | ||
donotcall | string | FALSE | ||
donotemail | string | FALSE | Email of Lead | |
state | string | FALSE | State/Province | |
city | string | FALSE | City | |
address | string | FALSE | Address | |
zip | int | FALSE | Zip/Postal Code | |
ownerid | reference | {“reference”: [“User”]} | FALSE | Owner ID |
Metadata field descriptions
Field | Description |
---|---|
Field Name | Column Name in CRM/MAP data |
label | Display Name of the field |
IsDeleted | Marks if the column has been removed in your system |
Metadata | Used when a field refers to another object (e.g., ownerid referencing “User”) |
Datatype | Accepted types: string, int, long, float, boolean, reference |