Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

What is Mailigen?

...

  1. You need to subscribe for a Mailigen account or start with a trial account
  2. You need to create an API key from Mailigen admin interface and send to us
  3. We will set up code for you that will be able to communicate with Mailigen from Standard ERP

Importing contacts to lists

After the technical set up is done, you need to manually transfer your contacts from Standard ERP to Mailigen. In order to do so, follow these steps:

Note

Default contact validation: Only contacts that are customers, are not closed and do not have the "No Mass Emailing" checkbox ticked are considered valid for Mailigen lists

  1. In the Mailigen settings indicate which customer categories should be included in the contact list, separated by a comma (Setting - Include only categories). If all customer categories should be included, then leave this field blank
  2. Run the report "Burti - Mailigen Contact List", which will return all of the customers that match the categories defined in the previous setting, and save it to an .xls file
    • If you are creating a classification list, indicate the specific classifications in the report window (TODO)
  3. In Mailigen, create a new Subscriber list

    ...

      • Under List Actions, choose Custom fields to edit the fields in the list
      • Add a new field labelled "Contact" (this label can be

    ...

      • named something else too) and name the Merge Tag "CONTACT" (this cannot be modified)
      • Do not change the Merge Tag of the default field "First Name". These are the required fields, other fields are optional. The list should look

    ...

      • like this:
      • Image Modified
    1. In Mailigen

    ...

    1. > Lists

    ...

    1. > My Lists - choose a List

    ...

    1. > Actions

    ...

    1. > Import  - choose the previously exported .xls file and import

    ...

    1. Once the list is created, copy the list ID that is displayed in the url, when the list is open and being viewed (https://admin.mailigen.com/contacts/dashboard/?id=XXXXXX, where X is a number).

    ...

      • If you are creating a Main list (list with all the contacts), save this ID in the Mailigen setting "Main list Web ID"
      • If you are creating a classification list,

    ...

      • save this ID in the Mailigen lists setting column "Contact List Web ID" in the corresponding classification row


    Note

    If a new list is created and has to be used in place of the old list, update the "Main list Web ID " setting and leave the "Main list ID " blank (Main list List ID is automatically populated after the first a request to Mailigen, if theMain list  list Web ID is supplied)

    Contact updates from Mailigen to SERP

    Next, it is necessary to create Webhooks, so that when a contact unsubscribes or changes their email, the changes get sent to HW.

    1. In Mailigen, go to Settings > Webhooks
    2. Create

    ...

    1. a new Webhooks:

      ...

        • "Trigger on" - tick "email address changes"

      ...

        • and "unsubscribes"
        • "List" - should be the same list indicated in

      ...

        • a setting (each webhook applies only to one list, for multiple lists create multiple webhooks)
        • "URL"

      ...

      ...

        • "Send updates made by" - tick "a subscriber" and "account admin"

      ...

                         Image Added

      The contact list in Mailigen will be automatically updated if:

      ...

      Tip

      It is very easy to create a list from SERP using flex.bi with a report definition like this:

      Code Block
      {
        "cube_name": "HansaWorld CRM",
        "cube_reports": [ {
           "name": "All customer e-mails",
           "result_view": "table",
           "definition": {"columns":{"dimensions":[{"name":"Measures","selected_set":["[Measures].[Customer e-mail]","[Measures].[Customer primary contact]"],"members":null}]},"rows":{"dimensions":[{"name":"Customer","selected_set":["[Customer].[Customer].Members"],"members":null,"bookmarked_members":null}],"filter_by":{"conditions":[{"expression":["[Measures].[Customer e-mail]"],"operator":"matches","value":".+@.+"}]},"nonempty_crossjoin":true},"pages":{"dimensions":null},"options":{"nonempty":true},"view":{"current":"table","maximized":false,"table":{}}}
        } ],
        "calculated_members": [{"name":"Customer e-mail","dimension":"Measures","formula":"[Customer].CurrentMember.getProperty('E-mail')","format_string":""},{"name":"Customer primary contact","dimension":"Measures","formula":"[Customer].CurrentMember.getProperty('Primary contact')","format_string":""}]
      }


      How to send a letter from Standard ERP

      1. Create a template you will use to format this e-mail. You can create one from scratch or use their provided templates, but the main thing is that you need to have a code of the template without any spaces and in capital letters. For this example I will use one called USER-PASSWORDS:
      2. Create a new letter in CRM>>Register>>Customer Letters
      3. Select either specific customer or put an asterisk * in the customer field to send for all customers matching other criteria
      4. Select either a specific customer category or leave it blank to send the e-mails to all of the categories defined in the setting (if setting is blank, sends to all categories)

      5. If applicable select one or more classifications to filter down the contacts accordingly
      6. Enter the subject of the e-mail
      7. Enter the template name from above in the field Document (e.g. USER-PASSWORDS)
      8. Select the person that should be placed in the Reply to of the e-mail
      9. To check which contacts will be the recipients of the letter, use Operation >> Letter List
      10. Run Operations>>Create Mailigen campaign. This will create a campaign on Mailigen side. Due to different business checks we can't send the campaign immediately
      11. To check if the campaign has been created successfully, presss the button "Mailigen campaign check". If everything went well, the status of the letter will change to "Campaign created"
      12. Click Open Mailigen campaign button to go to Mailigen and send the campaign
      13. Once the campaign is done, OK the letter to indicate that it has been done. If there is an "Activity type" filled in the setting, then activities will be created for all of the recipients of the Customer Letter that currently match all of the criteria.

      ...