Today we present the MailChimp integration available on our platform Cenit.io. MailChimp is an email marketing service, helps businesses with their marketing newsletters, automated messages, and targeted campaigns.
In the video we will show how to install the collection MailChimp version 1.0 in our tenant of Cenit.io, through the Shared Collection Pull action.
Then we show created objects like Connections, Webhooks, Libraries, Schemas, Data types, Events, Flows and Translators, that enables communication through MailChimp API and each with working examples.
Building the integration
1.To access to the tenant in Cenit.io, you should do sign-in cenithub.com
And then press the button data integrator, which prompted an username and password, remember if you are not registered, you can create a totally free account by Sign Up.
2. Will usually result in a redirect to cenithub.com, where we can see in Dashboard components previously installed. Now, we go to the Shared Collection menu option and list the available integrations. Once it has been found MailChimp-1.0.0, we pull.
The parameters required to set up integration are:
- API Key and
- Service Node, which is obtained from the last character of the API Key.
To set up this service must have an active account with its corresponding active API Key in mailchimp.com.
3. When we have successfully completed the Pull. The Dashboard shown in a group of objects that allow us to interact with the service. Schemas and Data Types.
4. The first step in our integration testing is, initiate the Data Type. Only now we begin some like Folder, Member, Template, List, Campaign.
5. On the left, you can see the Data Type that we have loaded upon which you can make a group of actions.
6. If we open the created connection to communicate with Mailchimp, we see that the URL is dynamic and uses the parameters defined in the PULL. For example the node service is used to determine the endpoint that should be used to make calls to the API, also with the user and the API Key we define a basic authorization header.
7. When the webhook are listed, notice that are dynamic and are generated from restful templates.
8. The flows support the allowed actions by the service and are associated with events that observe changes in the data. The flow to synchronize data are implemented with triggers time and should be adjusted according to user needs.
9. The flow can also be triggered by users when they want it through the API or using the admin Cenit.io. For example if we execute Folder Collection, then this will synchronize data type according to the information available on Mailchimp.
10. Another example is Contact Lists, if you look in Mailchimp we have 3 lists, and once synchronized is done you can see that have been downloaded to Cenit.io as shown.
11. To illustrate the interaction with MailChimp API through Cenit.io , we will set the token required to use the Cenit.io’s API . We create a new member and associate it with one of the existing lists.
12. We also have a set of actions that you can perform on the Data Type list, for example to obtain, create, update and delete a collection. If we execute ‘delete’, we can see that the list is permanently removed from Mailchimp.
13. We can also update the local data Type and the change is reflected in Mailchimp, because has defined an event that looks at local changes corresponding to an update.
14. Although in the Shared Collection has a set of flows, events and translators previus defined. The user can define new objects or also update existing as needed. For example, we define a new flow that allows us to create a folder.
To define a flow:
- 1. you should identify it with a unique name in the tenant.
- 2. associate with an event that can be of type: observer or scheduler.
- 3. Select a translator to process or generate the message (in this case generate a message with JSON format)
- 4. We selected a webhook
And is done. We already have the new flow ready.
15. Create a new folder using the admin API and then we note that the new folder is created in Mailchimp too. Add to this new folder two files and when we synchronize the folders, notice that the number of file has been updated.
16. We are currently working on support to file upload through Cenit.io.
Back to blog Get in touch