Configure Custom Connector

MoEngage can integrate with any SMTP connector for sending email campaigns. You would need to configure the connector, set up the unsubscribe mechanism, and optionally track bounces & complaints if your SMTP connector can post these details in the required format (as described later in the article)

Configure Custom SMTP Settings

• • • SMTP Host Name: IP Address or server name of the SMTP connector service you are using
    • SMTP Port: This is the SMTP port number of the connector service to which the connection would be established. To avoid the rate limits set by some hosting companies, we recommend using port 587 instead of port 25.
    • SMTP Protocol: You can select the protocol prefix (SSL/TLS) that your connector supports.
    • SMTP Authentication: Select "ON" here if your SMTP connector requires authentication to establish the connection. Then, enter the SMTP credentials in the username and password.  
    • Maximum send rate: This is the maximum number of emails per second that can be accepted by your SMTP connector.

Configure Custom Unsubscribe Settings

• "MoEngage Tracking" will add your unsubscribe page URL as the email footer - “If you'd like to unsubscribe and stop receiving these emails click here”.
• Add the callback URL for Unsubscribe Page URL as shown below:

  https://api-0X.moengage.com/v1/emailresubscribe

  MoEngage hosts each customer in a different data center; you can find your data center number (value of X) by checking the data center and API endpoint mapping here.

• Selecting "None" for promotional email campaigns will lead to higher chances of being classified as spam.

Configure Custom Bounce and Complaint Settings

• Bounce & Complaints Tracking: Moengage can receive this information in a POST call in the below format to the URL mentioned in your Moengage Account -> App Settings -> Email Settings -> Connector Configurations -> Custom -> Callback URL

• Add the callback URL as shown below:

  https://api-0X.moengage.com/v1/emailbounceendpoint/<>

  MoEngage hosts each customer in a different data center; you can find your data center number (value of X) by checking the data center and API endpoint mapping here.

POST Format - list of JSON. In "event" you can pass "hard_bounce", "soft_bounce" or "spam" for each case.

    [
    	{
      		"event": hard_bounce,
                "data": [
        	  {
                  	"email":"abc@moengage.com"
                  },
                  {
                  	"email":"bcd@moengage.com"
                  }
                ]
        }
    ]

You are all set up with connector configurations. You can now click on the "Save" button to test these settings (including credentials etc.) and save them. You can then select Custom SMTP as the default connector in General Settings. 

General Settings

While creating new email campaigns, the settings from General Settings will be used as defaults.  If you choose Email from the standard attribute with the correct connector configuration, we will track global opt-out against this email address.  If you chose a custom email attribute, unsubscribes will need to be handled separately.

MoEngage standard attribute name for email attribute is Email (Standard). This is a standard attribute where the name is provided by MoEngage, and the value is provided by the client.

FC & DND

To limit the number of emails sent to users in a certain period of time, please configure frequency capping settings. Do not disturb are quiet hours during which it is advisable to not send any messaging to users.  In case a message is scheduled to be sent during do not disturb hours, you can either discard the message or save it for after do not disturb hours are over.