SmartFocus Cloud Service APIs Document name Transactional Messaging Templates SOAP API Guide Service Transactional Messaging Service for Managing Templates Protocol SOAP over HTTP Version 11.8 Last updated on June 22, 2015
Table of Contents Table of Contents Table of Contents 2 Introduction 5 About This Document 5 About SmartFocus APIs 5 Feedback 5 Support Options 5 Training Options 5 SmartFocus's Products and Services 5 Disclaimer 5 Introducing SmartFocus APIs 6 Module Overview 6 Getting started with integration 7 Prerequisites 7 Quick Start 7 Integration Using APIs 7 URL Encoding Considerations (for HTTP GET methods only) 8 Security 8 Overview of the Transactional Messaging Templates & Dynamic Content API 9 Transactional Messaging Templates and Dynamic Content API Use Cases 11 Connection 13 Recommended Token Usage 13 openapiconnection 14 closeapiconnection 16 Template Management 17 createtemplate 17 18 createtemplatebyobj 20 deletetemplate 22 updatetemplate 23 updatetemplatebyobj 25 clonetemplate 27 gettemplate 28 getlasttemplates 30 gettemplatesbyfield 32 gettemplatesbyperiod 34 gettemplatesummarylist 36 gettemplatepreview 39 gettemplatepreviewbyobj 41 gettemplatepreviewwithlinksbyobj 44 www.smartfocus.com 2
Table of Contents createandaddstandardtemplateurl 47 createandaddpersonalizedtemplateurl 48 updatetemplateurlbyfield 49 deletetemplateurl 51 trackalltemplatelinks 52 untrackalltemplatelinks 53 tracktemplatelinkbyposition 54 untracktemplatelinkbyorder 56 getalltemplatetrackablelinks 57 getalltemplatetrackedlinks 58 getallunusedtemplatetrackedlinks 59 getnotifdefaultsender 60 getnotifnotvalidatedsenders 61 getnotifvalidatedaltsenders 62 addbanner 63 testtemplatebygroup 64 testtemplatebygroupbyobj 66 testtemplatebymember 68 testtemplatebymemberbyobj 70 Dynamic Content Management 72 createbanner 72 72 createbannerbyobj 74 updatebanner 76 updatebannerbyobj 78 deletebanner 80 clonebanner 81 getbanner 82 getlastbanners 84 getbannersbyfield 86 getbannersbyperiod 88 getbannerpreview 90 getbannerpreviewbyobj 91 createandaddstandardbannerurl 93 createandaddpersonalizedbannerurl 95 deletebannerurl 97 trackallbannerlinks 98 trackbannerlinkbyposition 99 untrackallbannerlinks 100 untrackbannerlinkbyorder 101 www.smartfocus.com 3
Table of Contents updatebannerurlbyfield 102 getbannerurlbyorder 104 getallbannertrackablelinks 106 getallbannertrackedlinks 107 getallunusedbannertrackedlinks 108 Reference 109 www.smartfocus.com 4
Introduction Introduction About This Document This document is a reference document for using SmartFocus APIs. It does not explain the purpose or functions of SmartFocus features. For information on these features, please consult the SmartFocus Online Help or the SmartFocus User Guide. This document is intended for developers and project managers. About SmartFocus APIs An Application Programming Interface (API) is a source code interface that a computer system or program library provides in order to support requests for services made from another computer program. The goal of SmartFocus APIs is to offer customers the ability to pilot a complete campaign from their own system. Feedback The Transactional Messaging Templates SOAP API Guide is constantly being enhanced to provide you with more and more information on using SmartFocus API methods. If you can't find the information you need or want to provide feedback, simply drop us a line at documentation@smartfocus.com. We look forward to hearing from you! Support Options SmartFocus provides you with a dedicated Account Manager to accompany you throughout the execution of your projects in SmartFocus. Your Account Manager is the gateway to support, training, and professional services. Working with your Account Manager, you can rely on SmartFocus s deliverability and technical support teams for complex troubleshooting and optimization. Training Options SmartFocus provides fully comprehensive training ranging from basic product training through to advanced modules and both strategic and tactical marketing courses. The training courses are designed to help you increase productivity, develop new methods, and share best practices to optimize your email, mobile, and social marketing campaigns. To get more information on training, please contact your Account Manager. SmartFocus's Products and Services For more information on SmartFocus's products and services, please see www.smartfocus.com Disclaimer While the information contained in this publication is believed to be true and accurate, SmartFocus cannot accept any legal responsibility for any errors or omissions contained herein. All information is subject to change without notice. None of the material in this publication may be reproduced or transmitted in whole or in part without the express written permission of SmartFocus. www.smartfocus.com 5
Introducing SmartFocus APIs Introducing SmartFocus APIs Module Overview The Transactional module is a way to access your Transactional Messaging Templates and Dynamic Content Blocks (often referred to as Notification Messaging or NMP templates and banners) through the API. It provides full access to the Templates and Dynamic Content Blocks for insert, update, get, and preview. www.smartfocus.com 6
Getting started with integration Getting started with integration Prerequisites To access SmartFocus s APIs and take full advantage of this software s ease of integration with other systems, you will need the following: An Internet connection A recent browser and operating system An active SmartFocus account with the API feature enabled Quick Start The process for interfacing your website, CRM, or any other internal system with the APIs is quite straightforward. Step 1: Get your API key in SmartFocus Note: You must have a dedicated API login. This login will NOT have access to SmartFocus. Contact your Account Manager to have a dedicated API login. To connect through the API, the user must first obtain a manager key using the CCMD Web Application. Calling the connect method (with the login, password, manager key) will provide a token, to be used in all subsequent calls. This token will expire in the following cases: When a close connection call is made. When the maximum number of calls per session, defined by the manager in SmartFocus, is reached. When the session times out. Step 2: Build your application Integration Using APIs The first step in getting started with web services is to configure the range of remote servers that will access this module. Webmasters and developers should be able to interface with this new API with any programming language that uses standard HTTP calls. List of APIs that are available: RESTful API SOAP API SOAP API The SOAP API consists in posting an XML file through HTTP POST. API call summary: SOAP Submission URL www.smartfocus.com 7
Getting started with integration SOAP Parameters & associated values All parameter names are case sensitive. When specific values are expected, it should be assumed that parameter values are case sensitive. The order of must be strictly followed. A parameter and its contents must appear on the same line without spaces and line breaks. In this guide, line breaks have sometimes been added for display reasons. URL Encoding Considerations (for HTTP GET methods only) Some characters cannot be part of a URL - for example, spaces are not allowed. Some characters have a special meaning in a URL for example, the hash (#) character is used to locate a specific point within a page, and the equals (=) character is used to separate a name from a value. A query string may need to be converted to satisfy these constraints. This can be done using a schema known as URL encoding. In particular, encoding the query string uses the following rules: Letters (A-Z and a-z) and numbers (0-9) are not encoded. The period (.), comma (,), tilde (~), and underscore (_) characters are not encoded. A space is encoded as %20. The forward slash (/) is encoded as %2F. All other characters are encoded as %FF hex representation with any non-ascii characters first encoded as UTF-8 (or other specified encoding). To encode as RFC 1738, use the + sign to replace spaces. Security As web services are accessible over the Internet and can be interfaced with any system, there is a risk of fraudulent access and usage of the system. To tighten security, SmartFocus APIs can be accessed using the HTTPS protocol. To use HTTPS, just replace HTTP with HTTPS in all the submission URLs. www.smartfocus.com 8
Overview of the Transactional Messaging Templates & Dynamic Content API Overview of the Transactional Messaging Templates & Dynamic Content API The Transactional Messaging Templates & Dynamic Content API allows you to manage your Transactional Messages and Dynamic Content: Create, edit, and delete Messages Create, edit, and delete Dynamic Content Blocks Add, edit, track, and untrack Message and Dynamic Content Block links For further information on how to create, edit, and manage Transactional Messaging creatives, please consult the SmartFocus User Guide or SmartFocus Online Help. The following methods are available: www.smartfocus.com 9
Overview of the Transactional Messaging Templates & Dynamic Content API Connection Method openapiconnection closeapiconnection This method provides a session token when given valid credentials. This method terminates the session token. Template Management Method Template Management createtemplatebyobj deletetemplate updatetemplate updatetemplatebyobj clonetemplate gettemplate getlasttemplates gettemplatesbyfield gettemplatesbyperiod gettemplatesummarylist gettemplatepreview gettemplatepreviewbyobj gettemplatepreviewwithlinksbyobj createandaddstandardtemplateurl This method creates a Transactional Messaging Template. This method creates a Transactional Messaging Template by object. This method deletes a Transactional Messaging Template. This method updates a Transactional Messaging Template. This method updates a Template by object. This method clones a Transactional Messaging Template. This method retrieves a Transactional Messaging Template. This method retrieves the most recently created Transactional Messaging Templates. This method retrieves a list of Transactional Messaging Templates containing a given value in a specified field. This method retrieves a list of Transactional Messaging Templates created during a specified period. This method retrieves a list of Templates and their details. This method retrieves a preview of the HTML or text part of a Template without personalization. This method retrieves a Template preview by object using personalization and dynamic content fields. This method retrieves a Template preview with displayed links using personalization and dynamic content fields. This method creates and adds a standard link to the Template. createandaddpersonalizedtemplateurl This method creates and adds a personalized link to the Template. updatetemplateurlbyfield deletetemplateurl trackalltemplatelinks untrackalltemplatelinks tracktemplatelinkbyposition untracktemplatelinkbyorder getalltemplatetrackablelinks getalltemplatetrackedlinks getallunusedtemplatetrackedlinks getnotifdefaultsender getnotifnotvalidatedsenders getnotifvalidatedaltsenders addbanner This method updates a Template link by field. This method deletes a Template link. This method activates link tracking for all links in a Template. This method deactivates tracking for all the links in a Template. This method activates link tracking for a link in a specific position in a Template. This method deactivates link tracking for specific link by its order number. This method retrieves a list of all the trackable links in a Template. This method retrieves a list of all the tracked links in a Template. This method retrieves a list of all the unused tracked links in a Template. This method retrieves the Transactional Messaging default sender. This method retrieves the Transactional Messaging non-validated senders. This method retrieves the Transactional Messaging validated senders. This method adds a Dynamic Content Block to a Template. www.smartfocus.com 10
Overview of the Transactional Messaging Templates & Dynamic Content API Method testtemplatebygroup testtemplatebygroupbyobj testtemplatebymember testtemplatebymemberbyobj This method sends a test email to a group of members. This method sends a test email to a group of members. This method sends a test email to a member. This method sends a test email to a member. Dynamic Content Management Method Dynamic Content Management createbannerbyobj updatebanner updatebannerbyobj deletebanner clonebanner getbanner getlastbanners getbannersbyfield getbannersbyperiod getbannerpreview getbannerpreviewbyobj createandaddstandardbannerurl createandaddpersonalizedbannerurl updatebannerurlbyfield deletebannerurl trackallbannerlinks trackbannerlinkbyposition untrackallbannerlinks untrackbannerlinkbyorder getbannerurlbyorder getallbannertrackablelinks getallbannertrackedlinks getallunusedbannertrackedlinks This method creates a Dynamic Content Block. This method creates a Dynamic Content Block by object. This method updates a Dynamic Content Block by field and value. This method updates a Dynamic Content Block by object. This method deletes a Dynamic Content Block. This method clones a Dynamic Content Block. This method retrieves a Dynamic Content Block using its ID. This method retrieves the most recently created Dynamic Content Blocks. This method retrieves a list of Dynamic Content Blocks that contain the same given value in a specific field. This method retrieves a list of Dynamic Content Blocks from a given period. This method displays a preview of a Dynamic Content Block. This method retrieves a preview of a Dynamic Content Block by object. This method creates and adds a standard link to the Dynamic Content Block. This method creates and adds a personalized link to the Dynamic Content Block. This method updates a Dynamic Content Block link by field. This method deletes a Dynamic Content Block link. This method activates tracking for all untracked Dynamic Content Block links and saves the Dynamic Content Block. This method tracks the Dynamic Content Block link through its position in the Dynamic Content Block. This method untracks all the Dynamic Content Block links. This method untracks a link in the Dynamic Content Block by its order. This method retrieves a Dynamic Content Block link by its order number. This method retrieves a list of all the trackable links in a Dynamic Content Block. This method retrieves a list of all the tracked links in a Dynamic Content Block. This method retrieves a list of all the unused tracked links of the Dynamic Content Block. Transactional Messaging Templates and Dynamic Content API Use Cases Create a Dynamic Content Block and Add it to a Template To create a Dynamic Content Block and add it to a Template, you would typically carry out the following procedure: www.smartfocus.com 11
Overview of the Transactional Messaging Templates & Dynamic Content API 1. Use the openapiconnection method to open the connection. 2. Use the createbannerbyobj method to create the Dynamic Content Block. 3. Use the gettemplatesbyperiod method to retrieve a list of recently created Templates and find the ID of the Template to which you want to add the Dynamic Content Block. 4. Use the addbanner method to add the Dynamic Content Block to the Template. 5. Use the closeapiconnection method to close the connection. Clone a Template and Update the New Template with a Different Dynamic Content Block To add a different Dynamic Content Block to a Template: 1. Use the openapiconnection method to open the connection. 2. Use the gettemplatesbyperiod method to find the Template ID. 3. Use the clonetemplate method to clone the Template. 4. Use the getbannersbyperiod method to retrieve a list of recently created Dynamic Content Blocks and find the new Dynamic Content Block that you want to add. 5. Use the updatetemplatebyobj method to add the new Dynamic Content Block to the Template. 6. Use the closeapiconnection method to close the connection. www.smartfocus.com 12
Connection Connection Prerequisite: To use SmartFocus APIs, you need to have the API manager login provided by SmartFocus and the associated password. To connect through the API, you must first retrieve the manager key from SmartFocus. 1. Go to Account Administration and select Logins. 2. Click the Edit icon next to your API manager. 3. In the API section of the popup window, copy the API key (also known as the manager key) and use it to open a connection to retrieve the token that will be used in your calls. Calling the connect method (with the login, password, manager key) will provide a token, to be used in all subsequent calls. This token will expire in the following cases: When a close connection call is made. When the maximum number of calls per session, defined by the manager in SmartFocus, is reached. When the session times out. Recommended Token Usage An open connection call generates a token that should be used until it expires. Once the token expires, an API call will generate a session exception. At this point, you should open a new connection to continue your API calls. Example: An example workflow: 1. Open the connection to generate the token. 2. Use API method calls as needed. If a call fails due to a problem with the session: a. Send another open connection call to renew the token. b. Resend the call that failed due to the session issue. 3. Send a close connection call once all API method calls for the session have been sent successfully. Note: For time consuming calls (e.g., uploading a large file), you may need to use an open connection call to ensure that the token will remain valid for the duration of the call. www.smartfocus.com 13
openapiconnection This method provides a session token when given valid credentials. Note: The token is valid for 60 minutes. Required login The login provided for API access return pwd The password Note: API passwords expire after 365 days. The token to use in all other API calls key The manager key copied from SmartFocus (see Connection on page 13) You must fill in the apiname parameter to check rights of client on this API. You must fill in the login parameter to authentifiate on this API. You must fill in the password parameter to authentifiate on this API. You must fill in the managerkey parameter to authentifiate on this API. Error while decoding managerkey. Your login is not valid!! Your password is not valid!! No manager retrieved for those login, password. No available connection for manager {0}. {0} doesn't exist or is not activated on client account. {0} is not activated for the client. This manager does not have authorized access to this API. Error while parsing validdate on managerkey. Date not valid on managerkey! The managerkey is no longer valid. Your API access is closed! www.smartfocus.com 14
<api:openapiconnection> <login>br_test</login> <pwd>aptrokez</pwd> <key>cdx7crle_26blfnjosgfdawh6lj3y6pwg5peova</key> </api:openapiconnection> <ns2:openapiconnectionresponse xmlns:ns2="http:/ <return>{token}</return> </ns2:openapiconnectionresponse> www.smartfocus.com 15
closeapiconnection This method terminates the session token. parameter Required parameter token The connection token return The connection is closed if the operation was successful, otherwise an error code appears. No available connection for the specified token. <api:closeapiconnection> <token>{token}</token> </api:closeapiconnection> <ns2:closeapiconnectionresponse xmlns:ns2="http:// <return>connection closed</return> </ns2:closeapiconnectionresponse> www.smartfocus.com 16
Template Management Template Management createtemplate This method creates a Transactional Messaging Template. Required token The connection token return The ID of the Template name description subject from fromemail to encoding body replyto replytoemail type The name of the Template The description of the Template The subject of the Template The From name. For SMS messages, the From name cannot exceed 11 characters. The From email address The To name The encoding used (e.g. UTF-8) The body of the Template (must be between the tags <![CDATA[ and ]]> ) The Reply To name The Reply To email address The type of Template: TRANSACTIONAL SOCIALNETWORK You must fill in the name parameter. You must fill in the description parameter. You must fill in the subject parameter. You must fill in the from parameter. You must fill in the fromemail parameter. You must fill in the to parameter. You must fill in the replyto parameter. You must fill in the replytoemail parameter. Error while retrieving the default sender on your account. www.smartfocus.com 17
Template Management This sender is not configured for your account. Template type not supported. <api:createtemplate> <token>{token}</token> <name>first test</name> <description>special rose promotion template</description> <subject>special Rose Bouquet</subject> <from>john Blum, Flower power Shop</from> <fromemail>johnblum@smartfocus.com</fromemail> <to>dear Customer</to> <encoding>shift-jis</encoding> <body> <![CDATA[[EMV HTMLPART] <html> <body/> <table width="625" border="0" align="center" cellpadding="0" cellspacing="0"> <tr> <td bgcolor="#f3f3f3"> <img src="http://emailvision.com/web/imgv5/spacer.gif" width="86" height="20"> </td> <td bgcolor="#f3f3f3"> <img src="http://emailvision.com/web/imgv5/spacer.gif" width="453" heightt="20"> </td> <td bgcolor="#f3f3f3"> <img src="http://emailvision.com/web/imgv5/spacer.gif" width="86" heightt="20"> </td> </tr> <tr> <td bgcolor="#f3f3f3"> </td> <td bgcolor="#f3f3f3"> <img src="http://emailvision.com/web/imgv5/logo.gif" width="453" heightt="44"> </td> <td bgcolor="#f3f3f3"> </td> </tr> <tr> <td colspan="3" bgcolor="#f3f3f3"> </td> </tr> <tr> <td rowspan="3" bgcolor="#f3f3f3"> </td> <td bgcolor="#f3f3f3"> <img src="http:// emailvision.com/web/imgv5/framebluetop.gif" width="453" height="14"> </td> <td rowspan="3" bgcolor="#f3f3f3"> </td> </tr> <tr> <td bgcolor="#00a0da"> <table width="453" border="0" cellspacing="0" cellpadding="0"> <tr> <td width="10"> </td> www.smartfocus.com 18
Template Management magazine.</b> <td width="433"> <font face="arial" size="3" color="#ffffff"> <b>hello, <br>you have successfully subscribed to Emailvision </font> </td> <td width="10"> </td> </tr> </table> </body> </html>]]></body> <replyto>john</replyto> <replytoemail>johnblum@smartfocus.com</replytoemail> <type>socialnetwork</type> </api:createtemplate> <ns2:createtemplateresponse xmlns:ns2="http:// <return>196</return> </ns2:createtemplateresponse> www.smartfocus.com 19
createtemplatebyobj This method creates a Transactional Messaging Template by object. Required token The connection token return The ID of the Template template The Template object You must fill in the name parameter. You must fill in the description parameter. You must fill in the subject parameter. You must fill in the from parameter. You must fill in the fromemail parameter. You must fill in the to parameter. You must fill in the encoding parameter. You must fill in the replyto parameter. You must fill in the replytoemail parameter. You must fill in the type parameter. Error while retrieving the default sender on your account. This sender is not configured for your account. Template type not supported. <api:createtemplatebyobj> <token>{token}</token> <template> <name>special Rose Bouquet</name> <description>order confirmation</description> <subject>special Rose Bouquet</subject> <from>john Blum, Flower power Shop</from> <fromemail>info@flowerpowershop.com</fromemail> <to>dear Customer</to> <encoding>shift-jis</encoding> <body> <![CDATA[[EMV TEXTPART]Dear [EMV DYN]FIRSTNAME[EMV /DYN] [EMV DYN]LASTNAME[EMV www.smartfocus.com 20
/DYN],Thank you for subscribing to MyDate.You are subscribed with the Email address:[emv DYN] EMAIL[EMV /DYN][EMV CONTENT]2[EMV /CONTENT]Let us know if you have any question.my Date Customer Service.[EMV HTMLPART] <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>my Sample HTML</title> </head> <body> <img src="http://mypath/to/my/header.gif" width="600" height="100"/> <table width="600" border="0" cellspacing="0" cellpadding="0"> <tr> <td> <font size="2" face="arial">dear [EMV DYN]FIRSTNAME[EMV /DYN] [EMV DYN] LASTNAME[EMV /DYN],Thank you for subscribing to MyDate.You are subscribed with the Email address: [EMV DYN]EMAIL[EMV /DYN] <font size="2" face="arial">let us know if you have any question.my Date Customer Service.</font> </td> </tr> </table>[emv CONTENT]1[EMV /CONTENT] <font size="2" face="arial">let us know if you have any question.my Date Customer Service.</body> </html>]]></body> <replyto>john Blum</replyTo> <replytoemail>john@flowerpowershop.com</replytoemail> <type>transactional</type> </template> </api:createtemplatebyobj> <ns2:createtemplatebyobjresponse xmlns:ns2="http:// <return>224</return> </ns2:createtemplatebyobjresponse> www.smartfocus.com 21
deletetemplate This method deletes a Transactional Messaging Template. Required token id The connection token return The ID of the Template true if it was successful, false if it was not successful No template found!! <api:deletetemplate> <token>{token}</token> <id>193</id> </api:deletetemplate> <ns2:deletetemplateresponse xmlns:ns2="http:// <return>true</return> </ns2:deletetemplateresponse> www.smartfocus.com 22
updatetemplate This method updates a Transactional Messaging Template. Required token The connection token return true if it was successful, false if it was not successful id field value The ID of the Template The field to update name description subject from to replyto replytoemail encoding The value to set for the field You must fill in the id parameter. You must fill in the field parameter. You must fill in the name parameter. You must fill in the encoding parameter. You must fill in the replyto parameter. No template found!! <api:updatetemplate> <token>{token}</token> <id>118</id> <field>name</field> www.smartfocus.com 23
<value>api_creation_update</value> </api:updatetemplate> <ns2:updatetemplateresponse xmlns:ns2="http:// <return>true</return> </ns2:updatetemplateresponse> www.smartfocus.com 24
updatetemplatebyobj This method updates a Template by object. Required token The connection token return true if it was successful, false if it was not successful template The Template object No template found!! Error while retrieving the default sender on your account. This sender is not configured for your account. Template type not supported. <api:updatetemplatebyobj> <token>{token}</token> <template> <id>224</id> <name>special Rose Bouquet</name> <description>order confirmation</description> <subject>special Rose Bouquet</subject> <from>john Blum, Flower power Shop</from> <fromemail>info@flowerpowershop.com</fromemail> <to>dear Customer</to> <encoding>shift-jis</encoding> <body> <![CDATA[[EMV TEXTPART]Dear [EMV DYN]FIRSTNAME[EMV /DYN] [EMV DYN]LASTNAME[EMV /DYN],Thank you for subscribing to MyDate.You are subscribed with the Email address:[emv DYN] EMAIL[EMV /DYN][EMV CONTENT]2[EMV /CONTENT]Let us know if you have any question.my Date Customer Service.[EMV HTMLPART] <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>my Sample HTML</title> </head> <body> www.smartfocus.com 25
<img src="http://mypath/to/my/header.gif" width="600" height="100"/> <table width="600" border="0" cellspacing="0" cellpadding="0"> <tr> <td> <font size="2" face="arial">dear [EMV DYN]FIRSTNAME[EMV /DYN] [EMV DYN] LASTNAME[EMV /DYN],Thank you for subscribing to MyDate.You are subscribed with the Email address: [EMV DYN]EMAIL[EMV /DYN] <font size="2" face="arial">let us know if you have any question.my Date Customer Service.</font> </td> </tr> </table>[emv CONTENT]1[EMV /CONTENT] <font size="2" face="arial">let us know if you have any question.my Date Customer Service.</body> </html>]]></body> <replyto>john Blum</replyTo> <replytoemail>john@flowerpowershop.com</replytoemail> <type>socialnetwork</type> </template> </api:updatetemplatebyobj> <ns2:updatetemplatebyobjresponse xmlns:ns2="http:// <return>true</return> </ns2:updatetemplatebyobjresponse> www.smartfocus.com 26
clonetemplate This method clones a Transactional Messaging Template. Required token The connection token return The ID of the Template id newname The ID of the Template The new name for the cloned Template You must fill in the id parameter. You must fill in the name parameter. No template found!! <api:clonetemplate> <token>{token}</token> <id>196</id> <newname>copy Special Rose Bouquet</newName> </api:clonetemplate> <ns2:clonetemplateresponse xmlns:ns2="http:// <return>201</return> </ns2:clonetemplateresponse> www.smartfocus.com 27
gettemplate This method retrieves a Transactional Messaging Template. Required token The connection token return The Template object id The ID of the Template You must fill in the id parameter. No template found!! Error while retrieving the default sender on your account. Error while retrieving the defined sender for this template. Template type not supported. <api:gettemplate> <token>{token}</token> <id>201</id> </api:gettemplate> <ns2:gettemplateresponse xmlns:ns2="http:// <return> <body> <![CDATA[[EMV TEXTPART]Dear [EMV DYN]FIRSTNAME[EMV /DYN] [EMV DYN]LASTNAME[EMV /DYN],Thank you for subscribing to MyDate.You are subscribed with the Email address:[emv DYN] EMAIL[EMV /DYN][EMV CONTENT]2[EMV /CONTENT]Let us know if you have any question.my Date Customer Service.[EMV HTMLPART] <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>my Sample HTML</title> www.smartfocus.com 28
</head> <body> <img src="http://mypath/to/my/header.gif" width="600" height="100"/> <table width="600" border="0" cellspacing="0" cellpadding="0"> <tr> <td> <font size="2" face="arial">dear [EMV DYN]FIRSTNAME[EMV /DYN] [EMV DYN] LASTNAME[EMV /DYN],Thank you for subscribing to MyDate.You are subscribed with the Email address: [EMV DYN]EMAIL[EMV /DYN] <font size="2" face="arial">let us know if you have any question.my Date Customer Service.</font> </td> </tr> </table>[emv CONTENT]1[EMV /CONTENT] <font size="2" face="arial">let us know if you have any question.my Date Customer Service.</body> </html>]]></body> <description>order confirmation</description> <encoding>shift-jis</encoding> <encrypt>edx7cqkmjtt88sa93241132mkjp2vtult53124zfk7l-kvde602w8wrkmk</encrypt> <from>john Blum, Flower power Shop</from> <fromemail>email@blandine.ccemails.com</fromemail> <id>201</id> <name>copy Special Rose Bouquet</name> <random>35b9838324320c004035b</random> <replyto>john Blum</replyTo> <replytoemail>john@flowerpowershop.com</replytoemail> <sent>false</sent> <subject>a more fancy subject</subject> <to>dear Customer</to> <type>transactional</type> </return> </ns2:gettemplateresponse> www.smartfocus.com 29