FTPZIP is a MailUp application that allows to send an email message to a defined list of recipients by simply uploading a ZIP archive to an FTP location (via FTP:21 or SFTP:22).
This features is typically used by advanced users that have a need for configuring and sending a campaign without accessing the MailUp web application, and without using the MailUp APIs.
Operation modes
FTPZIP presents different Operation Modes. They are:
- FULL: Create a newsletter in MailUp and send it
- SEND: Send a newsletter (the newsletter has been previously created in MailUp)
- SAVE: Create a newsletter in MailUp
Depending on what you are trying to accomplish, you can enclose in the ZIP archive different kinds of files. (Details of ZIP archive structure are here.)
The only mandatory file is the one called settings.xml. The information enclosed in settings.xml allows to determine the Operations Mode and the details needed for each different operation mode. (Details of the settings.xml structure and data are here.)
Operation mode use cases
FTPZIP manage the following use cases:
- (FULL) Create and send an email message to a list of recipients (examples of settings.xml here (Massive Mailing) or /wiki/spaces/mailupapi/pages/36339811. Examples of ZIP archive structure here).
- (SEND) Send an already defined email message to a list of recipients (examples of settings.xml here (Massive Mailing) or /wiki/spaces/mailupapi/pages/36339811. Examples of ZIP archive structure here).
- (SEND) Send a copy of an already defined email message to a list of recipients (examples of settings.xml here (Massive Mailing) or /wiki/spaces/mailupapi/pages/36339811. Examples of ZIP archive structure here).
- (SAVE) Create an email message (examples of settings.xml here. Examples of zip archive structure here).
Operation mode kind of mailing
Send of email message to a list of recipients can be executed in two different ways (see the differences here: FTPZIP Massive vs Transactional):
- Using Massive Send (details about settings.xml here).
- Using Transactional Send (details about settings.xml /wiki/spaces/mailupapi/pages/36339811).
FTPZIP will be configured to execute only Massive Send, only Transactional Send or both.
We recommend use of Massive Send when is required manage a single zip archive one at a time and the newsletter have to be sent to a great amount of subscribers.
We recommend use of Transactional Send when is required manage more than one zip archive at the same time and the newsletters have to be sent to a reduced of subscribers.
Here the differences between Massive Send and Transactional Send.
Upload ZIP Archive
The ZIP archive has to be uploaded in the FTP subfolder “/import_zip” that can be accessed from your FTP root path.
You can use FTP protocol (port 21) or SFTP protocol (port 22).
Notification alert messages
FTPZIP can send email message to notify the result of the operation or error arisen during the execution. The email messages are sent to the address written in the node notifyemail in settings.xml (see here).
Details about notifications messages are here.