Skip to main content

NewMail

Description

New mail function is used to send regular e-mail from Atollon. I supports sending both plaintext and html e-mails. In case html e-mail is sent, plaintext part is generated automatically.

Fields Description

Field Description Example
priority E-mail priority handled by other mail clients 1, 2, 3
group Message group with similar characteristics, required

For e-mails sent in context, there is always default "group" available in the response of request to getFolder, getProject, getActivity. For example:

<messageGroup>133185101</messageGroup> 

treeHandle Message container (mailbox)

Similar comment to "group" field above:

<messageDefault>133186101</messageDefault> 

html What is the body format?

0..plaintext

1..html

encoding Use utf-8 only

utf-8

from Full format of sender mailbox

 

to Recipient address

 

subject Subject of the message

 

body Either plaintext or html part of the message (based on above html = 0/1 flag)

 

attachments.attachment Link to documentId in Atollon. The document will be converted to base64 and added to sent e-mail

 

forwardEmails List ids of e-mail messages that will be attached

 

Example

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://atollon.com/enterprise/wsdl">
   <soapenv:Header/>
   <soapenv:Body>
      <wsdl:NewMail>
         <server>acme</server>
         <session>5B5EA....8BD04</session>
      <mail>
        <priority>2</priority>
        <group>491826101</group>
        <treeHandle>491827101</treeHandle>
        <html>1</html>
        <encoding>utf-8</encoding>
        <from>"Your team" &lt;admin@mydomain.com&gt;</from>
        <to>jan@safka.cz</to>
        <subject>Welcome to your new world of success</subject>
        <body>&lt;html&gt;&lt;head&gt;&lt;title&gt;Welcome to your new world of success&lt;/title&gt; &lt;meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /&gt; &lt;style type="text/css"&gt; &lt;!-- body,td,th { font-family: Arial, Helvetica, sans-serif; font-size: 12px; color: #333333; } a:link { color: #666666; } a:visited { color: #999999; } --&gt; &lt;/style&gt;&lt;/head&gt;&lt;body&gt;&lt;div ALIGN="LEFT"&gt;&lt;span style="font-family:helvetica,arial,sans-serif; font-size:12px; color:#000000; "&gt;This is the secret message&lt;/span&gt;&lt;/div&gt;

&lt;br/&gt;

&lt;div ALIGN="LEFT"&gt;&lt;span style="font-family:helvetica,arial,sans-serif; font-size:12px; color:#000000; "&gt;Your super powerful team&lt;/span&gt;&lt;/div&gt;

&lt;/body&gt;&lt;/html&gt;</body>
        <attachments>
          <attachment>
            <documentId>496477101</documentId>
          </attachment>
        </attachments>
        <forwardEmails/>
      </mail>
      </wsdl:NewMail>
   </soapenv:Body>
</soapenv:Envelope>
Response
<ns0:Envelope xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://atollon.com/enterprise/wsdl">
   <ns0:Body>
      <ns1:NewMailResponse>
         <result>OK</result>
         <time>0.07684398</time>
         <newId>496505101</newId>
         <newAcl>MSGS000000151828</newAcl>
         <needApproval>0</needApproval>
      </ns1:NewMailResponse>
   </ns0:Body>
</ns0:Envelope>