- 1. Getting Started
- 2. What's New
- 3. Dashboard
- 4. Contacts
- 5. Components
- 6. Channels
- 7. Campaigns
- 8. Reports
- 9. Points
- 10. Stages
- 11. Plugins
- 12. Use Cases
- 13. Cron Jobs
- 14. SAML SSO
- 15. Themes
- 16. Translations
- 17. Tips & Tricks
- Published with GitBook
Mautic - Salesforce CRM plugin
This plugin can push a contact to Salesforce CRM when a contact makes some action. If you don't have the Salesforce CRM account yet, create it.
SSL. Your Mautic instance nas to run on https. Salesforce will not allow you to create App with just http callback URL.
Get the Salesforce client credentials
There is an official documentation about how to get the Key and Secret although it doesn't seem to be updated.
Go to: Setup (top right corner) / Build (bottom left corner) - Create / Apps / Connected Apps / New
Create a new app like this: Make sure the Selcected OAuth Scopes are Access and manage your fata (api) and Perform requests on your behalf at any time (refresh_token, offline_access).
Copy the Consumer Key and Secret.
Configure the Mautic Salesforce plugin
Insert the keys to the Mautic Salesforce plugin and authorize it.
Configure the field mapping. Formula fields from salesforce will be pulled and can be saved into a Mautic custome field. Salesforce lead's Id can be matched with a mautic custom field.
Enabled features: You can pull leads and/or push leads from and to the integration.
Push leads is done through a form or a campaign.
Pull leads is done through command line and it can be setup as a cronjob.
Feature specific settings: Select the objects you wish to pull or push records from. You can push contacts to the Leads object in salesforce. you can also push activities (contact's timeline records) to a custom object in salesforce.
Pulling records will be done from Leads and/or Contacts objects in records and Accounts from Salesforce will be pulled into Mautic companies.
Updating of a Contact's Owner can be be enabled by turning on Update Contact Owner. This is not enabled by default. In order for a Contact in Mautic to match a User in Salesforce the email addresses in the two system must be identical.
Command line script to pull records from Salesforce
To pull records from salesforce you need to use a command from CLI. Use this command:
Used to pull records from the Leads object in Salesforce
- php app/console mautic:integration:fetchleads
Used to push activities to the Salesforce custom object described below
Parameters both commands take:
--time-interval This parameter is used to setup the amount of time we want to pull records from. Possible entries: "10 days", "1 day", "10 minutes", "1 minute". Maximun time interval "29 days".
--integration=Salesforce to use with salesforce integration. In future this command may be used for other integrations.
Setting up Mautic's custom object in Salesforce
To be able to push activities to the salesforce integration you first need to setup a custom object in your salesforce instance. Please setup the object as it is described below. (Note: these are two underscores with no space between - not rendered well in Github).
Custom object name: Mautic__timeline (API name: Mautic_timeline__c)
API names of fields:
- ActivityDate__c : Date/Time
- contact_id__c : Lookup(Contact)
- Description__c : Long Text Area(131072)
- WhoId__c : Lookup(Lead)
- MauticLead__c : Number(18, 0) (External ID)
- Mautic_url__c : URL(255)
- ReferenceId : Text(255)
Test the plugin
Follow these steps to test the integration.
The REST API is not enabled for this Organization.
This means the API is not turned on in your Salesforce account. Read more