Tracked deliveries via SMTP (SMTP-DMDS Sandbox)

Normally, a user sends emails through an outgoing server via their client program, such as Outlook or Thunderbird.

In the outgoing server configuration, e.g., smtp.domain.com, it is usually set to use password for authenticated sending, and STARTTLS is enabled to ensure that the mail transport, from our computer to the outgoing server, is encrypted, preventing anyone from discovering the username, password, or mail content through sniffing or network interception.

If you want to integrate with DMDS via SMTP, you must use the dmdsid as the username and the APIKEY as the password, just like with the DMDS REST API, and the server will be a fixed name smtp-dmds.planisys.net.

Additionally, to assign the mail to a campaign, the campaign number in brackets must be placed as the first characters of the subject.

Note

When defining an API type campaign on the web, a short number is generated, which is introduced in the Email Subject. For example: Subject: [22]Hello good afternoon

In this way, the email enters the SMTP-DMDS Sandbox and can be processed to add view and click tracking.

In this version, the email will be sent to a single recipient, allowing a list of accounts in Cc or copy, and attachments will be preserved. It does not support Blind Copy or Bcc.

To view read and click events, they will appear as effective deliveries of the selected Campaign in the DMDS web interface under the Results Tab.

Warning

The sender will NOT be replaced with the sender specified in the campaign. The campaign’s default subject will also be overwritten.

Regarding the Subject, the recipient will receive it in the email without the campaign number in brackets.

Note

If you forget the campaign number in brackets or enter an incorrect number, the email will simply be discarded. The SMTP-DMDS Sandbox does not generate error messages to prevent backscattering, i.e., bounce attacks.

Besides using the Subject to indicate the Campaign, you can also use a X-Planisys-Campaign-Numid header followed by the campaign number.

This header is very simple to add when using mail sending libraries, e.g., PHPMailer or Swift.

Finally, to integrate untouchable systems, you can send emails without specifying the campaign in the Subject or as a Header, as long as there is a campaign in the system called default.

In the Campaign screen, you can modify the option to add an Unsubscribe message at the end, as well as the option to add Google Analytics Tags to clickable URLs.

On the other hand, when creating Campaigns via API, you can obtain a specific Campaign APIKEY, which can be used with the username dmds-nrocampana and the APIKEY as the password. This way, your DMDS can support different users utilizing different campaigns with their own statistics. It’s also a way to resell traffic to third parties by assigning them a campaign with its own sending key.

Warning

The use of SMTP-DMDS does not support blind copy or Bcc because it is an SMTP mechanism that is not captured by the SMTP Sandbox used in this environment. In other words, blind copies are not present in the email headers, so they cannot be analyzed by SMTP-DMDS.

Última actualización el 2024-08-21