MailChimp for WunderAutomation

Please note that MailChimp for WunderAutomation doesn’t add new contacts to your MailChimp audiences. There are plenty of available free plugins that handles this, taking GDPR and other relevant legal aspects into consideration.

Please see Requirements section below

Triggers #

MailChimp for WunderAutomation provides a trigger that can handle incoming webhooks from MailChimp.

MailChimp Webhook #

This trigger has only one field

NameDescription
IdentifierA Unique string that identifies this webhook. When first selecting this action, a random code is generated.

You can edit the identifier if you prefer a different UR, but note that you can only use lower case characters a-z, 0-9, – (dash) and _ (underscore).

Filters #

Read more about using filters here.

The following filters are provided for workflows using MailChimp Webhook as trigger:

FilterDescription
MailChimp ListChecks if the MailChimp list (single value) is the specified as comparison value. Use this to make sure the MailChimp webhook is notifying about the MailChimp list you expect.
MailChimp EmailChecks if the email address (string) provided with the MailChimp webhook matches with the comparison value using the selected operator. Use this to exclude certain addresses / domains.
MailChimp update typeChecks the update type that the MailChimp webhook notified about.

Parameters #

The following parameters become available whenever the trigger that starts the workflow provides is the MailChimp webook:

ParameterDescription
mailchimp.update_typeReturns the name (label) or code of the updated type provided by the MailChimp webhook
mailchimp.listReturns the name (label) or id of the list provided by the MailChimp webhook
mailchimp.emailReturns the address provided by the MailChimp webhook

Actions #

The core functionality of MailChimp for WunderAutomation is to provide actions that helps you control your email marketing efforts.

For the actions to find the correct MailChimp contact to update, the following fileds are mandatory for all three actions:

FieldDescription
AudienceSelect the target MailChimp audience / list
Email addressThe email address / contact that the action should update. Use a parameter placeholder or a hard coded value.

Depending on the situation, this will typically be billing.email (WooCommerce order), currentuser.email or user.email.

Update contact #

Allows you to update basic information as well as merge fields for the contact.

Optional fields #

Select which fields to update by clicking the checkbox at each field name.

FieldDescription
StatusUpdates the contact status to the selected value. Please note that forcing a contact to status “subscribed” without a clear consent may be a legal violation.
VIP statusAdds or removes VIP status for the contact
Email typeSets the email type to HTML or text.

Merge fields #

Each MailChimp list have a set of merge fields. You can add or update merge fields for the list using this action. It will display all found merge fields associated with the selected list. It’s not possible to add new merge fields using this action, that is best done using the MailChimp web ui.

Click the checkbox next to each field to enable it for update. Use a parameter placeholder or a hard coded value.

Updating the address merge field #

The address merge field is one of the standard MailChimp merge fields. It’s special because it contains six subfields. If you update the address field, you update all six sub fields at once.

A note about the Country field. By default, MailChimp expects a 2-character ISO country code in this field. WunderAutomation automatically translates most country names in most languages to the correct ISO code. If WunderAutomation can’t resolve the country, MailChimp will default to “USA”.

For example. the following string will resolve to the country code “FI” (Finland).

StringLanguage
SuomiFinnish
SuomijaLithuanian
FinlandeFrench
ФинляндияRussian

Updating the birthday merge field #

The birthday merge field expects a date in the format “DD/MM”. It’s possible to format a WunderAutomation parameter to the correct format using the string “d/m”.

Add or remove tag #

Allows you to add or remove MailChimp tags on a contact.

Aside from the normal mandatory fields. The following fields are needed:

FieldDescription
Add or removeDropdown. Select if you want the action to add or remove a MailChimp tag
TagThe name of the tag to add or remove

Trigger event #

Allows you to trigger a MailChimp event. Read more about MailChimp events here. Events can be used to trigger MailChimp automations, for example to send out a remainder to write a review after purchase. They can also be used for advanced segmentation in MailChimp.

In addition to the normal mandatory fields for the MailChimp actions, you also need to provide an event name.

FieldDescription
Event nameThe name of the event. Note that the event name must be a minimum of two characters and a maximum of 30 characters. We recommend that you format the event name as a verb-noun phrase to match the other activities in a contact’s profile

Event parameters #

To make events even more powerful, it’s possible to add an unlimited amount of parameters to an event. In WunderAutomation, you do this by clicking “Add event parameter”.

FieldDescription
KeyThe name / identifier of the parameter
ValueUse a parameter placeholder or a hard coded value.

Read more about how to use event parameters in MailChimp automations here.

Requirements #

Powered by BetterDocs

Leave a Reply

Your email address will not be published. Required fields are marked *