NewMail
August 28, 2020
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" <admin@mydomain.com></from>
<to>jan@safka.cz</to>
<subject>Welcome to your new world of success</subject>
<body><html><head><title>Welcome to your new world of success</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> <style type="text/css"> <!-- body,td,th { font-family: Arial, Helvetica, sans-serif; font-size: 12px; color: #333333; } a:link { color: #666666; } a:visited { color: #999999; } --> </style></head><body><div ALIGN="LEFT"><span style="font-family:helvetica,arial,sans-serif; font-size:12px; color:#000000; ">This is the secret message</span></div>
<br/>
<div ALIGN="LEFT"><span style="font-family:helvetica,arial,sans-serif; font-size:12px; color:#000000; ">Your super powerful team</span></div>
</body></html></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>