Home
Administrator Guides
Transactional Message Administrator Guide
Integration with the Deliver transactional message service
The Deliver Transactional messaging System (TMS) is a web service hosted as part of HCL Unica hosted services. Application developers must work with digital marketers in your organization to create the client applications required to integrate your corporate transactional systems with the Deliver TMS. These client applications initiate each transactional message by making a SOAP request to the Deliver TMS over an HTTPS connection.
Attachments in transactional email requests
The Deliver TMS supports attaching one or more files to a transactional email message. The web services request must contain the file contents and information that describes each file.

Administrator Guides
- Startup and Administrator Guide
- Transactional Message Administrator Guide
  - About Deliver and transactional message
    A transactional message is a single message sent in response to a specific, predetermined transaction detected in your business systems. Unica provides the Deliver Transactional messaging Service (TMS) as a hosted web service to process transactional messages. Digital marketers work with application developers to integrate corporate transaction management systems with the Deliver TMS.
  - Integration with the Deliver transactional message service
    The Deliver Transactional messaging System (TMS) is a web service hosted as part of HCL Unica hosted services. Application developers must work with digital marketers in your organization to create the client applications required to integrate your corporate transactional systems with the Deliver TMS. These client applications initiate each transactional message by making a SOAP request to the Deliver TMS over an HTTPS connection.
    - Identification of transaction events
      Application developers must design the local transactional message client to interact with transaction monitoring systems used by your organization. The client must take transaction notifications as input and distinguish the type of transaction event that the transaction management system is reporting.
    - Access to recipient data
      To personalize transactional messages, the local transactional message client must access business systems and databases that can provide recipient-specific data used in transactional message.
    - Connection to the Deliver TMS
      You must design the local transactional message client to automatically connect to the Unica data center assigned to your hosted message account. The client must be able to provide the appropriate authentication credentials as part of the web service request.
    - Attachments in transactional email requests
      The Deliver TMS supports attaching one or more files to a transactional email message. The web services request must contain the file contents and information that describes each file.
    - Construction of the transactional email request
      To access the Deliver TMS, the transactional email client must be able to provide credentials to connect to the TMS. It must also provide mailing and message information as part of the web service request. Unica provides two versions of a WSDL as a guide to structuring a SOAP request that includes all information required to send a transactional email.
  - Deliver sample TMS client
  - The Deliver Transactional Mailing Service API
    The Deliver Transactional Mailing Service is a web service hosted in HCL Unica. It provides an API that contains one method calledsendMailing.
  - Sample client
    Unica provides sample transactional message clients to guide application developers that create client applications that make web service calls to the Deliver Transactional Messaging Service (TMS). This sample client is based on the second-generation WSDL.
  - About Dynamic Transactional Images
    Dynamic transactional images are images specific to a particular individual that you can include with transactional email messages. Dynamic transactional images are sent as attachments to transactional email but they display as images embedded in the body of the message.
  - Deliver sample TMS client

Attachments in transactional email requests

The Deliver TMS supports attaching one or more files to a transactional email message. The web services request must contain the file contents and information that describes each file.

The second-generation WSDL available from Unica describes how to configure a transactional email request that includes email attachments. The transactional email request must specify the following.

Name of the file to be attached
The MIME content type of the file
Contents of the file

You pass attachments to the Deliver TMS inline as separate MIME parts using techniques described in either of the following standards recognized by the World Wide Web Consortium (W3C):

SOAP Message Transmission Optimization Mechanism (MTOM)
SOAP Messages with Attachments (SWA)

Consult the W3C web site for details about these standards.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.