Overview

Use CRM integrations to configure integration faster and stream information directly to Totango DNX-CX to start analyzing and taking action on your customer data.

CRM integration saves time, reduces Totango Admin’s dependency on Ops and data teams, and enables easier integration management by reusing data connectors, editing and duplicating integrations, using automatic field mapping and real-time previewing and validation.

CRM integrations main capabilities:

• Reuse data source connectors
• Sync data from several instances of the same data source
• Filtering incoming information
• Integration configurable scheduling
• All CRM information is monitored in a unified view
  
  

This article includes the following topics:

• Configuring CRM Integration

• Maintaining Your CRM Integrations

• FAQs

Related articles:

• Configuring CRM Integration Connections
• Control Your Data Sync with Write-Back Capability 
  
  

Configuring CRM Integration

Configuring CRM integrations is simple and include these steps:

1. Configure your connection
2. Select the integration type and data source (object, fields, and filter)
3. Preview the data
4. Map and validate the data
5. Configure settings and integration schedule

Follow the steps below to configure your CRM integration:

1. Configure your connection
   • Go to your Totango instance and click on Global Settings > Data Management > Customer Data Hub > click on CRM card (note: you will need Totango admin privileges).
     
     
     
   • Follow this article to Configuring CRM Integration Connections
     
     
2. Select the integration type and data source (object, fields, and filter)
   Go back to the CRM integration page and click on the green plus button and select "New Integration".
   
   These are the supported integration types:
   
   
   After selecting the type, choose the connector (you can reuse the connectors already configured), CRM object (as named in your CRM), and object fields.
   
   
   You can filter incoming data stream by defining it in the data source query filter text box. This query filter should follow the CRM application query language. 
   
   
   
3. Preview the data
   Click "Load Preview" button to review 10 objects retrieved directly from your CRM.
   The preview action is a mandatory action because it serves in testing the CRM connector and data source configuration, error messages will be presented in the preview section.
   
   
4. Map and validate the data
   After the preview and automatic mapping are done, review the keys and attribute mapping and make the necessary changes. You MUST validate the file before saving the file integration
   
   Note, creating new attributes is done from the mapping section. Make sure to configure all the needed information for the new attribute creation.
   
   
5. Configure settings and integration schedule
   The CRM integration name is automatically assigned based on its source connector and object, it is advised to add a meaningful description.
   
   In case your CRM integration contains additional accounts that you do NOT wish to update in Totango, turn OFF the “Create new objects” option.
   
   Setup the CRM integration schedule
   
   Note,
   * You can sync the data now regardless of the scheduling defined by checking the relevant checkbox.
   * You can enable/disable the scheduling of this integration by checking the relevant checkbox.
   
   
6. Save the integration.
7. It is advised to review the integration notification settings to make sure the right people will be informed about the progress and outcome. Read more.

Maintaining Your CRM Integrations

• Click on the integration to view its details.
  
  
  
  
• Maintain your integration by clicking the integration menu
  
• Edit file integration configuration & Duplicate: You can edit and duplicate a recurring integration. One-time integrations can be duplicated but not edited.
  
• Run Now: You can run incremental sync for already configured integration from the UI by clicking the “Run Now” option in the menu and this will not impact the existing schedule (if recurring).
  This incremental sync will update all information from previous successful sync.
• Run Full Sync Now:  You can run full sync for already configured integration from the UI by clicking the “Run Full Sync Now” option in the menu and this will not impact the existing schedule (if recurring). This full sync will update all current object information (for example, sync all account up-to-date information)
• Download: In order to analyze errors, you can download a file including all the information synced. You can download any file from any previous upload in the “History” modal.
• Disable scheduled: In case of maintenance work or an error, you can disable the integration schedule.
• History: You can analyze the integration history in the “History” modal. You can filter the integration history, view every integration details, and download the file which includes the synced data.
  
  
  
• Trigger API Endpoint: In case you want to trigger the integration right when your company data process ends, use the trigger API option in the menu to find the API call structure and details. Since it works exactly as triggering a file integration you can read more about it here.
• Delete: In case the integration is no longer needed, you can delete it. Note, this action is irreversible.

FAQs

Q: What happens if an attribute used in integration is deleted from the data model?
A: You cannot delete an attribute that is mapped in a recurring job. You will be able to delete an attribute that was in use in a one-time upload.

Q: Can I sync data that includes non-existing accounts in Totango?
A: Yes, these accounts can be created automatically as part of the sync depends on the account creation settings. You should allow the integration to create new objects in the integration settings section.

Q: Can I use the same object field twice?
A: Yes. Re-using the same object field more than once in integration is possible, just pick the same object field from the dropdown