Giter VIP home page Giter VIP logo

mautic-pipedrive-bundle's Introduction

Pipedrive integration based on new Mautic integration framework. Once installed, you can find it in Plugins configuration under, named as Pipedrive 2. It use OAuth 2.0 authorization.


Overview

Sync. your data between Pipedrive and Mautic without having to do anything manual! Using the Mautic integration with Pipedrive, you will take advantage of:

Bidirectional sync.: data are shared in real time between Pipedrive and Mautic. Native and Custom fields mapping: easy configuration with UI fields mapping. Behavioral data sync.: collected events from Mautic are added to your contact timelines in your Pipedrive CRM.

Detailed features

  • Contacts sync.
  • Companies sync.
  • Fields mapping
  • Automated real time sync. of all data
  • Targeted triggered sync. from forms, campaigns, points actions
  • Contact and Company owner sync.
  • Reciprocity deletion handling
  • Pipedrive labels (hot, warm, cold) sync.
  • Mautic Contact history sync. to Pipedrive

Installation

You can install this plugin using composer using command: composer require webmecanik/mautic-pipedrive-bundle

Or manually from GitHub: https://github.com/webmecanik/mautic-pipedrive-bundle

Setup

Authentication

  1. Ask Pipedrive support ([email protected]) to enable Marketplace Manager on your account. More info here.
  2. Create unlisted app in Tools and Apps > Marketplace manager > Call it "Mautic for {company}". Replace {company} by your company name

image

  1. Set Callback URL from URL from your plugin settings (you should have another value instead of http://localhost:8084/index_dev.php, do not use this here).

image

image

  1. Set these OAuth & Access scopes

image

  1. Copy Client ID and Client Secret from Pipedrive

image

  1. Go to Pipedrive 2 plugin in Mautic. Paste the Client ID and Client Secret from Pipedrive and set the subdomain of your Pipedrive account.

image

  1. Save your plugin configuration and click Authorize App.

Features settings

Features tab

Check your wished features.

If you want to have a full synchronisation (automated), you will need to enable special command in your CRONjob (see hereunder).

Commands

Run sync every 20 minutes

php bin/console mautic:integrations:sync Pipedrive2 --start-datetime="-20 minutes"

First time sync for data from last year

php bin/console mautic:integrations:sync Pipedrive2 -f --start-datetime="-1 year"

Mapping tab

Map you contact ans company fields according to your data exchange expectations. Be sure to respect field format and field constraint values.

Delete contacts reciprocity

By enabling this feature, anytime you delete a contact in Mautic or in Pipedrive, the deletion will be applied in the other application.

⚠️ Be extremely careful using this feature.

Sync. owners

You can enable the synchronisation of contacts and companies owners.

⚠️ You need to have users (owners) existing in both applications using the same email address.

Sync. contact activities

You can send Mautic contact activities in Pipedrive contact history. Then your sales team is able to have an overview of the contact activities (form submission, page hits, emails open, etc.).

  • In the feature tab, select the type of even you want to sync.
  • ⚠️ You need to create all the custom activities you'll sync. from the plugin tab. Go to Pipedrive > Settings > Company Settings > Activities > all activity events select in plugins settings. All activities types are matched by activity name (see hereunder).
  • Start using your app!

Requirements

This plugin needs the Company merge event merged in Mautic 5. You can cherrypick it from: mautic/mautic#11748 It also needs Disable activity push from Mautic repository: mautic/mautic#11255

Troubleshooting

First sync. can be taking all time contacts & companies?

Yes it can. See dedicated command above.

Be sure to have strictly the same field value for constraint format

  • In a number field you can have only numbers
  • In a select field you should have the same list of values between the 2 apps

Contact not synced?

  1. Check your plugin feature tab, be sure to have checked the expected features
  2. Check that your authentication is still working by entering again your credentials
  3. If the user that authenticated the plugin doesn't have Mautic or Pipedrive access, the sync. will be interrupted according to the right loss.

Owner sync. not working

Be sure to have the owner existing as users in both application with same email address. If the user is not existing, the user cannot be assigned as owner.

Contact not deleted

Once you delete your contact or company in Mautic, it can take several minutes to be applied in Pipedrive, it is not instant deletion. Same for deletion in Pipedrive, this could take few minutes.

Event type name

  • campaign.event
  • segment_membership
  • campaign_membership
  • lead.source.created
  • lead.source.identified
  • dynamic.content.sent
  • email.sent
  • email.read
  • email.replied
  • email.failed
  • campaign.event.scheduled
  • page.videohit
  • form.submitted
  • lead.imported
  • integration_sync_issues
  • message.queue
  • lead.donotcontact
  • point.gained
  • asset.download
  • stage.changed
  • lead.utmtagsadded
  • sms_reply
  • sms.sent
  • page.hit

mautic-pipedrive-bundle's People

Contributors

kuzmany avatar npracht avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

Forkers

npracht

mautic-pipedrive-bundle's Issues

installing pipedrive, which version of Mautic

@npracht @kuzmany
I have a few questions

  1. is this new plugin only available for version 5 of mautic or can this be installed on version 4?
  2. installing this manually, is there a specific folder name to use, so it is recognised in Mautic?

I would appreciate a quick response on this, thanks
M.

Sync triggering underfined method getInputOptionsDAO()

I have this plugin installed. Nothing is syncing between Pipedrive and Mautic, and when I run the cron job, I get the error:

php bin/console mautic:integrations:sync Pipedrive2

[ERROR] Call to undefined method Mautic\IntegrationsBundle\Event\SyncEvent::getInputOptionsDAO()

Can't install the plugin

Dear Webmecanik team,
First thanks for your good job!

I have trouble installing this new plugin. There seems to be a conflict with the MauticCrmBundle plugin, with a classname duplicated in both plugins (mautic-pipedrive-bundle and the legacy MauticCrmBundle).

I'm not using composer (neither for mautic install nor plugins).

I created a folder named "Pipedrive2" under plugins/ with the plugin content.
I then clicked on the button "Install/update plugins" but nothing appears.
I also tried to execute php bin/console mautic:plugins:reload and mautic:plugins:install and it also says that "0 plugins were installed or updated".

I tried removing MauticCrmBundle/ folder from the plugins/ folder. But it's not any better. The MauticCrmBundle/ seems to be still loaded from the composer/vendor repository.

image

Do you have any hint on how this plugin should be installed, which version of Mautic is it compatible with, and if MauticCrmBundle should be removed? The documentation probably lacks informations on those points.

Regards,

First Name and Last Name missing from contact mapping

Everything else seems to be working perfectly, but when I configure the plugin inside of mautic, the contact field mapping is missing fields for first name and last name and when new contacts sync from pipedrive, they are missing first and last name on their records.

image

image

Does not handle string values in Pipedrive that are too long gracefully

If string values are too long in Pipedrive, the plugin fails sync with an error instead of truncating the data gracefully.

 [ERROR] An exception occurred while executing 'UPDATE leads SET date_modified =
         ?, title = ?, company = ?, country = ? WHERE id = ?' with params       
         ["2023-03-03 04:29:48", "I help business owners and entrepreneurs      
         develop graphic solutions to solve real business problems, I Help      
         Business Owners and Entrepreneurs Develop Graphic Solutions to Solve   
         Real Business Problems", "Company Corporation", null, "20067"]:         
                                                                                
         SQLSTATE[22001]: String data, right truncated: 1406 Data too long for  
         column 'title' at row 1 

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.