Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

On this page:



Available solutions

You can develop your integration with MailUp by mixing the available solutions, taking advantage of the features they provide. Each listed item is a link to the correspondent documentation.


Development can be done starting from scratch learning from available samples (see docs for each solution), or you can use the RubyGem (that is a wrapper of the REST API)

 


Comparison matrix

Here below there is a comparison matrix between available solutions.

 

(tick) = available

(warning) = available with restrictions (see specific notes for each case)

 

 

Manage lists and groups

 HTTP, FormsSOAPRESTSMTP+FTPList+Frontend
Create/Delete/Update lists (tick)     
Create/Delete/Update groups (tick)(tick)    
Read lists and groups (tick)(tick)    

 

Subscriptions

 HTTP, FormsSOAPRESTSMTP+FTPList+Frontend
Import recipient (single)(tick)(tick)(tick)(warning)1(warning)2  
Import of recipients (bulk) (tick)(tick) (tick)(warning)3 
Bulk import limit
(Mega Bytes )
 

MailUpImport : Multiple import by splitting in blocks,
up to 1,5 MB per block

SendMessageNL: as FTP case

Multiple import by splitting in blocks,
up to 7 MB per block
 N/A, but successfully
tested either with 50 MB or with
a single import file containing 4 millions email addresses
10 MB 
Force optin of unsubscribed recipient (single)?(warning)2(tick) (warning)2  
Force optin of unsubscribed recipients (bulk) (tick)  (tick)  
Unsubscribe recipient (single)(tick)(tick)(tick) (warning)2  

Unsubscribe recipient (bulk)

 (tick)  (tick)  
Read personal data fields settings (tick)(tick)    
Update recipients' personal data fields(tick)(tick)(tick) (tick)  
Check recipient's subscription status(tick) (tick)    
Add to group (single)(tick)(tick)(tick) (warning)2  
Add to group (bulk) (tick)(tick) (tick)  
Remove from group (single)  (tick)    
Remove from group (bulk)    (warning)4  

 

Email

 HTTP, FormsSOAPRESTSMTP+FTPList+Frontend
Create email message (tick)(tick)(tick) (tick) 
Read email messages (tick)(tick)    
Manage tags  (tick)    
Manage attachments (tick)(tick)(tick) (tick) 
Manage both embedded and not embedded images in the same message   (tick)   
Manage dynamic fields (tick)(tick)  (tick) 
Manage dynamic content (tick)?  ? 
Manage image upload (i.e. make them hosted by MailUp)  (tick)(tick) (tick) 
Manage attachments (tick)(tick)(tick) (tick) 
Full content customization for each recipient   (tick)   
Allow mixing embedded and not embedded images in one email message   (tick)   
Transactional emails (account credentials after signup, password reminders...) (tick)5 (tick)   
Transactional emails (newsletters, customized messages) (warning)5 (tick)   
Promotional emails (tick)(tick)    
Send to a single recipient (tick)(tick)(tick) (warning)2,3 
Send to a group (tick)(tick)  (tick) 
Send to all list subscribers (tick)(tick)  (tick) 
Scheduled sending (tick)     
Manage queue of messages to be sent (tick)     
Get email statistics in real time (tick)(tick)   (tick)
Get email statistics (with scheduled process)    (tick)  

 

SMS

 HTTP, FormsSOAPRESTSMTP+FTPList+Frontend
Create SMS (with dynamic fields) (tick)  (warning)6  
Manage dynamic fields (tick)     
Send SMS to a recipient (tick)  (warning)6  
Send SMS to a group/list (immediate & scheduled) (tick)  (warning)6  
Get SMS statistics in real time       
Get SMS statistics (with scheduled process)    (tick)  

 

Other features

 HTTP, FormsSOAPRESTSMTP+FTPList+Frontend
SecurityHTTP with encrypted querystring
parameters and IP restriction9 in
most of the pages7

HTTP, user authentication, and IP
restriction9 for MailUpImport web service


HTTPS and user authentication for
other SOAP web services

OAuth2 with refresh tokenSTARTTLS Encryption is supportedsFTP and FTPs are supported

Authorization workflow
at application level
(sender and mailing
shall be approved before
before sending) 
HTTP with encrypted querystring
parameters in most of the pages8
New trial account activation  (tick)    
        

 

(1) New recipients are added to list when a message is sent to them 

(2) For this API the feature is designed for bulk operations, its massive use on single recipients may affect system performances

(3) New recipients are added when listed in enclosed "one2many.import" file

(4) Requires a customization

(5) Can be used for confirmation requests, not for massive use (see this Rate Limiting about SendSingleNewsletter)

(6) With the "Text message (SMS) sending from .CSV file" feature 

(7) where these features are not available, the actions require a click on a confirmation email before proceeding

(8) please note that the purpose of frontend web pages is to be freely available by specifying an URL, without any console authentication 

(9) Restrictions on caller IP cannot be used and shall be disabled in case of cloud hosting (in this case it is not possible to get all possible IPs to be authorized)

 



Use cases

For each use case more solutions may be available, but they always differ in some aspects. Check them out to see which one better fits your needs.

Synchronize recipients between your application and MailUp

You may need to transfer a set of recipients, eventually with their personal data, from your application to MailUp; or viceversa. Several possible solutions are available

FTP based integrations

You can use FTP Batch Processes for massive data transfer using files in CSV format. This feature can be used with very high numbers of recipients (import has been successfully tested with 4 millions of recipients in a single file) and it is configured on request by MailUp support team.

 Click here to know more about available FTP transfer types

You can request this feature to

Data transfer is not in real time: it is usually configured as daily or weekly, but for specific cases even hourly data transfer can be done)

SOAP API

You can use MailUpImport SOAP API for an immediate import of recipients. In particular, you can use StartImportProcess method, eventually combined with NewImportProcess if the number of recipient is higher than 5000. These methods also allow a batch import as "pending", with the confirmation email that has to be manually sent using the adimin console account. SOAP API is not bidirectional, since it does not allow export of recipients.

SOAP API + FTP

You can get the best of FTP and SOAP API by using SendMessageNL API method, which performs scheduled sending to a group of recipients that is specified on a file. In this case you have to transfer the file to MailUp before calling the method. Export of recipients can be done with an FTP based integration.

REST API

Rest API allows immediate and bidirectional import and export of recipients. Due to restriction on HTTP channel, no more than 7MB can be uploaded with a single import. For the export of recipients the paging feature is recommended to keep control on maximum size of tranferred data. REST API is the only MailUp solution that allows removal of a single recipient from a group

Webhooks

You can configure webhooks to enable a fast callback to your website when a recipient changes the subscription status or the personal data fields (e.g. by accessing to an autoprofile form). Callback method can be configured in order to include recipient's details as method parameter. Webhooks are managed by a worker process that is like a "frequent cron": you may experience some minutes of delay between the action and the corresponding callback.

HTTP GET/POST and subscription forms

This option works only for single recipients. Subscription forms are based on HTTP GET/POST methods, which allow subscription unsubscription and update for a single recipient. No features are available with this solution for managing groups of recipients in a single operation nor for exporting recipients from MailUp.

Manage suppression lists

You can contact MailUp support and ask configuration of an FTP based integration with a batch process that is configured to run hourly. This process has to be set to import in a new group (group name = file name) the recipents that are listed in the file to be imported. Then, when you access to MailUp admin console, you can schedule your campaign to be sent to "all subscribers except for the recipients that belong to a certain group". It should be easy for you to identify the right group because it has the name of the imported file plus a timestamp.

Send email/SMS campaigns from your CRM

To manage your campaign with MailUp you need to import (subscribe) the recipients first. Refer to section above to discover how to move recipients from your an external application to MailUp

SOAP API

You can create a new message using SOAP API or refer to an existing message by specifying its ID. Since email statistics are aggregated per message, be aware that when you reuse a previously sent message then it is likely that you will not be able to split the aggregated statistics. You can use CreateNewsletter to create an email message, Clone Message to make a copy of an existing one and finally you can use SendNewsletter  to program an immediate or scheduled sending (at sending time you will be able to specify who will receive that campaign). For SMS you can use a similar approach with CreateSMS and SendSMS methods. Since SMS statistics are very poor when compared to email, there was no need to implement a "clone SMS" method

SOAP API + FTP

Email only. As an alternative to importing recipients and then calling SendNewsletter , method SendMessageNL allows a bulk import and the scheduling of a specified email message with a single operation. Refer to method documentation to learn more about this method and its known limitations

REST API

Email only. REST API offers the most complete suite form creating and managing an email message, but it still has some limitations about sending that are going to be removed in some of the next product releases:

  • scheduled sending is not yet supported (only immediate sending to all subscribers or to specified groups/recipients)
  • recipient selection by applying filters is not available
  • capability of immediate delivery (e.g. for confirmation messages) regardless what else is happening in the delivery queue at that time is not supported
FTP

SMS Only. FTP solution offers the capability to import (bulk) recipients and send them SMS messages that can be fully customized for each recipient. Refer to "Text message (SMS) sending from .CSV file" for more info.

Send transactional emails/SMS

SMTP+

Email only. SMTP+ offers a scalable solution that is valid also for high volumes of transactional email messages to be sent. Delivery time depends on the bandwidth agreed for that console account.

SOAP API

SOAP API offers a good and scalable solution for transactional SMS with SendDirectSMS, while for email you can use SendSingleNewsletter or SendNewsletter but you must be aware of the existing limitations (refer directly to the documentation of these methods or check out the API use policy

Read statistics

Email statistics are the number and the details about opens and clicks, usually grouped by message. About SMS we can only know the delivery status and, in case of error, the error code.  

FTP

A batch export can be configured to periodically export on a CSV file the statistics of email and/or SMS messages. Export frequency can be set from 1 hour to 2 weeks. Contact us to ask a batch export for your console account (non standard configurations may require an extra fee). 

SOAP API 

WebService MailupReport provides a couple of methods to retreive statistics by message or by recipient.

REST API

REST API offer the best suite about MailUp statistics, also allowing filtered and paged searches  

Frontend

Frontend pages provide a reduced version of some statistics pages of the console account, so that an external application can embed them. Available pages are similar to

 

  • No labels