{"id":7936,"date":"2023-08-30T09:21:55","date_gmt":"2023-08-30T08:21:55","guid":{"rendered":"https:\/\/help.cirrus-shield.com\/?post_type=docs&p=7936"},"modified":"2023-10-30T12:24:29","modified_gmt":"2023-10-30T11:24:29","slug":"mailchimp","status":"publish","type":"docs","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/admin-guide\/plugins\/mailchimp\/","title":{"rendered":"Mailchimp"},"content":{"rendered":"\n

Introduction<\/strong><\/p>\n\n\n\n

This guide aims to walk you through the process of effectively integrate Mailchimp with Cirrus Shield.<\/p>\n\n\n\n

Prerequisites<\/strong><\/p>\n\n\n\n

Before you can start using the service, you will need to do the following steps:<\/p>\n\n\n\n

In Mailchimp<\/em><\/strong><\/p>\n\n\n\n

1. Create a Mailchimp Account<\/strong><\/p>\n\n\n\n

To get started, you will need to create a Mailchimp account. If you do not have one already, you can sign up by visiting the following link: https:\/\/mailchimp.com\/<\/a><\/p>\n\n\n\n

2. Obtain Your API Key<\/strong><\/p>\n\n\n\n

After successfully creating your Mailchimp account, the next step is to acquire your API key. This key will enable you to connect seamlessly with our service. To obtain your API key, follow these steps:<\/p>\n\n\n\n

a. Access the API Key Management Page<\/strong><\/strong><\/p>\n\n\n\n

Click on the following link to access your Mailchimp account’s API key management page: https:\/\/us9.admin.mailchimp.com\/account\/api\/?_ga=2.224117659.1627744431.1691751332-217670292.1678692587<\/a><\/p>\n\n\n\n

b. Generate a New API Key<\/strong><\/p>\n\n\n\n

Once on the API key management page, select the option to “Create A Key.” This will prompt you to provide a name for your API key.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

c. Retrieve and Save Your API Key<\/strong><\/p>\n\n\n\n

After naming your API key, the system will generate the key for you. It is crucial to copy and save this key in a secure location. You will need it during the configuration process<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n
\"\"<\/figure>\n\n\n\n

In Cirrus Shield<\/em><\/strong><\/p>\n\n\n\n

    \n
  1. Install the Mailchimp Plugin :<\/strong><\/li>\n<\/ol>\n\n\n\n

    Start by navigating to the “Configuration” section in Cirrus Shield, then select “Extensions.” From there, install the Mailchimp plugin to enable the integration between the two platforms.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    2. Create Essential Objects: Contact, Lead, and Campaign :<\/strong> <\/strong><\/p>\n\n\n\n

    To utilize the Mailchimp Plugin effectively, you need to ensure that at least one of the following objects is created: “Contact,” “Lead,” or “Campaign.” These objects require specific fields with designated types, particularly the crucial fields: “First_Name,” “Last_Name,” and “Email.” Refer to the image provided below for samples of the required fields.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Furthermore, it is essential to link the created campaign to the “Contact” and\/or “Lead” objects.<\/p>\n\n\n\n

    To create an object, access “Configuration,” then choose “Objects,” and proceed to create the desired object.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    After creating the object, go to \u201cChamps personnalis\u00e9s\u201d and create a new field, based on the fields that are shown in the image.<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    N.B : Make sure to create the fields with the same name and same type of the images regarding the objects<\/strong><\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    It should be the same done for the rest of the fields based on their name and field types.<\/p>\n\n\n\n

    3. JavaScript Button<\/strong> :<\/strong><\/p>\n\n\n\n

    Create a button for the object that you will be using with Mailchimp, the objects can be \u201cContact,\u201d \u201cLead\u201d or \u201cCampaign.\u201d To create a JavaScript button, navigate to Configuration -> Object -> Details -> Bouton Personnalis\u00e9s<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Then you create a button with the following information<\/p>\n\n\n\n

    \"\"<\/figure>\n\n\n\n

    Here will be the codes that you can use with each object respectively:<\/p>\n\n\n\n

    Contact :<\/strong><\/p>\n\n\n\n

    function SendContactsBasedOnFilter()\n{\n    let TokenGUID = GetTokenID();\n    let orgInfo = new Object();\n    let userInfo = new Object();\n    \n    let list_name = document.getElementsByClassName(\"cuselText\")[0].getElementsByTagName('label')[0].innerHTML;\n    \n    let divElement = document.getElementById(\"divSubDataTablePartialListView0\")\n    let rows = divElement.querySelectorAll('tr');\n    let contactGUIDs = [];\n    let contacts = [];\n    let userLanguage = null;\n\n    $.ajax({\n        beforeSend: function (xhrObj) {\n            xhrObj.setRequestHeader(\"Accept\", \"application\/json\");\n        },\n        type: \"GET\",\n        async: false,\n        dataType: \"json\",\n        contentType: \"application\/json\",\n        url: \"\/RestApi\/Query?authToken=\" + TokenGUID + \"&selectQuery=SELECT Name, Email, Language FROM User\",\n        success: function (Data) {\n            if (Data.Data != undefined) {\n                userInfo = Data.Data.User[0];\nuserLanguage = userInfo.Language;\n            }\n            else {\n                userInfo = null;\n            }\n        },\n        error: function (XMLHttpRequest) {\n            alert(XMLHttpRequest.statusText);\n        }\n    });\n\n    rows.forEach(row => {\n        contactGUIDs.push(row.id);\n    });\n\n    contactGUIDs.shift();\n\n    contactGUIDs.forEach(GUID => {\n        var contact = GetDataByID(GUID,\"Contact\", \"First_Name, Last_Name, Email\");\n        contacts.push(contact);\n    });\n\nif(contacts == null || contacts.length === 0){\n var message = \"There are no contacts.\";\n if (userLanguage === \"fr\") {\n   message = \"Il n' y a pas de contacts.\";\n }\nalert(message);\nreturn;\n}\n\n    $.ajax({\n        beforeSend: function (xhrObj) {\n            xhrObj.setRequestHeader(\"Accept\", \"application\/json\");\n        },\n        type: \"GET\",\n        async: false,\n        dataType: \"json\",\n        contentType: \"application\/json\",\n        url: \"\/RestApi\/Query?authToken=\" + TokenGUID + \"&selectQuery=SELECT Id, Name, Country, City, Street, PostalCode FROM Organization\",\n        success: function (Data) {\n            if (Data.Data != undefined) {\n                orgInfo = Data.Data.Organization[0];\n                if (Data.Data.Organization[0].Country == null) {\n                    orgInfo.Country = \"France\";\n                }\n            }\n            else {\n                orgInfo = null;\n            }\n        },\n        error: function (XMLHttpRequest) {\n            alert(XMLHttpRequest.statusText);\n        }\n    });\n\n    try {\n        var settings = {\n            \"url\": `https:\/\/mchmp.cirrus-shield.net\/Mailchimp?list_name=${list_name}`,\n            \"method\": \"POST\",\n            \"timeout\": 0,\n            \"headers\": {\n                \"Content-Type\": \"application\/json\"\n            },\n            \"data\": JSON.stringify({ \"Contacts\": contacts, \"User\": userInfo, \"Organization\": orgInfo }),\n            \"error\": function (XMLHttpRequest) {\n                alert(\"Error: \" + XMLHttpRequest.responseText);\n            }\n        };\n\n        $.ajax(settings)\n            .done(function (response) {\n                var message = \"Contacts have been successfully sent to Mailchimp.\";\nif(userLanguage === \"fr\"){\nmessage = \"Les contacts ont \u00e9t\u00e9 envoy\u00e9s \u00e0 Mailchimp avec succ\u00e8s\";\n}\n                alert(message);\n            });\n    } catch (error) {\n        console.log(error);\n        alert(response);\n    }\n}\n<\/code><\/pre>\n\n\n\n
    Lead :<\/strong><\/p>\n\n\n\n
    function SendLeadsBasedOnFilter()\n{\n    let TokenGUID = GetTokenID();\n    let orgInfo = new Object();\n    let userInfo = new Object();\n    \n    let list_name = document.getElementsByClassName(\"cuselText\")[0].getElementsByTagName('label')[0].innerHTML;\n    \n    let divElement = document.getElementById(\"divSubDataTablePartialListView0\")\n    let rows = divElement.querySelectorAll('tr');\n    let contactGUIDs = [];\n    let contacts = [];\n    let userLanguage = null;\n\n $.ajax({\n        beforeSend: function (xhrObj) {\n            xhrObj.setRequestHeader(\"Accept\", \"application\/json\");\n        },\n        type: \"GET\",\n        async: false,\n        dataType: \"json\",\n        contentType: \"application\/json\",\n        url: \"\/RestApi\/Query?authToken=\" + TokenGUID + \"&selectQuery=SELECT Name, Email, Language FROM User\",\n        success: function (Data) {\n            if (Data.Data != undefined) {\n                userInfo = Data.Data.User[0];\nuserLanguage  = userInfo.Language;\n            }\n            else {\n                userInfo = null;\n            }\n        },\n        error: function (XMLHttpRequest) {\n            alert(XMLHttpRequest.statusText);\n        }\n    });\n\n    rows.forEach(row => {\n        contactGUIDs.push(row.id);\n    });\n\n    contactGUIDs.shift();\n\n    contactGUIDs.forEach(GUID => {\n        var contact = GetDataByID(GUID,\"Lead\", \"First_Name, Last_Name, Email\");\n        contacts.push(contact);\n    });\n\nif(contacts == null || contacts.length === 0){\n var message = \"There are no leads.\";\n if (userLanguage === \"fr\") {\n   message = \"Il n' y a pas de prospects.\";\n }\nalert(message);\nreturn;\n}\n\n    $.ajax({\n        beforeSend: function (xhrObj) {\n            xhrObj.setRequestHeader(\"Accept\", \"application\/json\");\n        },\n        type: \"GET\",\n        async: false,\n        dataType: \"json\",\n        contentType: \"application\/json\",\n        url: \"\/RestApi\/Query?authToken=\" + TokenGUID + \"&selectQuery=SELECT Id, Name, Country, City, Street, PostalCode FROM Organization\",\n        success: function (Data) {\n            if (Data.Data != undefined) {\n                orgInfo = Data.Data.Organization[0];\n                if (Data.Data.Organization[0].Country == null) {\n                    orgInfo.Country = \"France\";\n                }\n            }\n            else {\n                orgInfo = null;\n            }\n        },\n        error: function (XMLHttpRequest) {\n            alert(XMLHttpRequest.statusText);\n        }\n    });\n\n    try {\n        var settings = {\n            \"url\": `https:\/\/ mchmp.cirrus-shield.net \/Mailchimp?list_name=${list_name}`,\n            \"method\": \"POST\",\n            \"timeout\": 0,\n            \"headers\": {\n                \"Content-Type\": \"application\/json\"\n            },\n            \"data\": JSON.stringify({ \"Contacts\": contacts, \"User\": userInfo, \"Organization\": orgInfo }),\n            \"error\": function (XMLHttpRequest) {\n                alert(\"Error: \" + XMLHttpRequest.responseText);\nconsole.log(XMLHttpRequest);\n            }\n        };\n\n        $.ajax(settings)\n            .done(function (response) {\n              var message = \"Leads have been successfully sent to Mailchimp.\";\nif(userLanguage === \"fr\"){\nmessage = \"Les prospects ont \u00e9t\u00e9 envoy\u00e9s \u00e0 Mailchimp avec succ\u00e8s\";\n}\n                alert(message);\n            });\n    } catch (error) {\n        console.log(error);\n        alert(response);\n    }\n}\n<\/code><\/pre>\n\n\n\n
    Campaign<\/strong>:<\/strong><\/p>\n\n\n\n
    function SendCampaignMembers()\n{\n    var TokenGUID = GetTokenID();\n    var orgInfo = new Object();\n    var userInfo = new Object();\n    var test = document.querySelectorAll(\"#cell1id\");\n    var list_name = test[0].textContent;\n    var contacts = [];\n    var userLanguage = null;\n    var campaign_members = GetDataByColumn(\"Campaign\", GetRecordGUID(), \"Campaign_Member\", \"Name, Member\");\n\n$.ajax({\n        beforeSend: function (xhrObj) {\n            xhrObj.setRequestHeader(\"Accept\", \"application\/json\");\n        },\n        type: \"GET\",\n        async: false,\n        dataType: \"json\",\n        contentType: \"application\/json\",\n        url: \"\/RestApi\/Query?authToken=\" + TokenGUID + \"&selectQuery=SELECT Name, Email, Language FROM User\",\n        success: function (Data) {\n            if (Data.Data != undefined) {\n                userInfo = Data.Data.User[0];\n                userLanguage = userInfo.Language;\n            }\n            else {\n                userInfo = null;\n            }\n        },\n        error: function (XMLHttpRequest) {\n            alert(XMLHttpRequest.statusText);\n        }\n    });\n\n\n\n    if (campaign_members == null || campaign_members.length === 0) {\nvar message = \"There are no campaign members.\";\nif(userLanguage === \"fr\"){\nmessage = \"Il n'y a aucun membre de campagne.\";\n}\n        alert(message);\n        return;\n    }\n\n    campaign_members.forEach(element =>\n    {\n        var contact = GetDataByID(element.Member, \"Contact\", \"First_Name, Last_Name, Email\");\n        if (contact == null)\n        {\n            contact = GetDataByID(element.Member, \"Lead\", \"First_Name, Last_Name, Email\");\n        }\n        contacts.push(contact);\n    });\n\n    $.ajax({\n        beforeSend: function (xhrObj) {\n            xhrObj.setRequestHeader(\"Accept\", \"application\/json\");\n        },\n        type: \"GET\",\n        async: false,\n        dataType: \"json\",\n        contentType: \"application\/json\",\n        url: \"\/RestApi\/Query?authToken=\" + TokenGUID + \"&selectQuery=SELECT Id, Name, Country, City, Street, PostalCode FROM Organization\",\n        success: function (Data) {\n            if (Data.Data != undefined) {\n                orgInfo = Data.Data.Organization[0];\n                if (Data.Data.Organization[0].Country == null) {\n                    orgInfo.Country = \"France\";\n                }\n            }\n            else {\n                orgInfo = null;\n            }\n        },\n        error: function (XMLHttpRequest) {\n            alert(XMLHttpRequest.statusText);\n        }\n    });\n    \n    try {\n        var settings = {\n            \"url\": `https:\/\/mchmp.cirrus-shield.net\/Mailchimp?list_name=${list_name}`,\n            \"method\": \"POST\",\n            \"timeout\": 0,\n            \"headers\": {\n                \"Content-Type\": \"application\/json\"\n            },\n            \"data\": JSON.stringify({ \"Contacts\": contacts, \"User\": userInfo, \"Organization\": orgInfo }),\n            \"error\": function (XMLHttpRequest) {\n                alert(\"Error: \" + XMLHttpRequest.responseText);\n            }\n        };\n\n        $.ajax(settings)\n            .done(function (response) {\nvar message = \"Contacts have been successfully sent to Mailchimp.\";\nif(userLanguage === \"fr\"){\nmessage = \"Les contacts ont \u00e9t\u00e9 envoy\u00e9s \u00e0 Mailchimp avec succ\u00e8s\";\n}\n                alert(message);\n            });\n    } catch (error) {\n        console.log(error);\n        alert(response);\n    }\n}\n<\/code><\/pre>\n\n\n\n
    And then make sure to change the visibility of the button based on the users that will be using it, you can do this by going to the object where you created the button -> button details -> Profils<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    And finally you will be able to see the button in the details page of the record of the specific chosen object<\/p>\n\n\n\n
    Configuration <\/strong><\/p>\n\n\n\n
    To configure the plugin that you installed, you\u2019ll have to go to the details of the Mailchimp installed plugin.<\/p>\n\n\n\n
    \"\"<\/figure>\n\n\n\n
    This will direct you to the configuration page. Initiate the configuration process by entering your Cirrus Shield credentials (Username & Password) and your Mailchimp credentials (Access Token). After inputting the necessary information, click “Create” to save the configuration to Cirrus Shield.<\/p>\n","protected":false},"author":12,"featured_media":0,"parent":1363,"menu_order":5,"comment_status":"open","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"doc_tag":[],"class_list":["post-7936","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/7936","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/comments?post=7936"}],"version-history":[{"count":2,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/7936\/revisions"}],"predecessor-version":[{"id":8562,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/7936\/revisions\/8562"}],"up":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/1363"}],"next":[{"title":"Sirene","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/admin-guide\/plugins\/sirene\/","href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/8009"}],"prev":[{"title":"Email Template","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/admin-guide\/plugins\/email-template\/","href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/7854"}],"wp:attachment":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/media?parent=7936"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/doc_tag?post=7936"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}