How to ... Send a Message with Attachments

In Cisco Unity Connection 8.5 and later, CUMI will allow voice mails to be sent that have additional attachments of any type. (In earlier versions of Connection, CUMI allows only voice messages with one audio attachment to be sent.)

Sending a Voice Message with Attachments

The basics of sending a voice message involve a creating multipart HTTP form that contains an object representation of a Message, an object representation of a Recipient list and a set of zero or more additional parts that will be added as message attachments. If there are parts beyond the first two, then the third one must be either audio/wav data or an object representation of a CallControl object (the CallControl object is used when the stream resides on the server after using CUTI to record over the phone). The third part is considered to be the "primary" body of the voice message.

The parts beyond the third part are passed transparently to the message system to be added as an attachment. These additional parts must have a content type and some data.

HTTP example for a send message POST request:

 POST /vmrest/messages HTTP/1.1
 Content-Type: multipart/mixed;boundary=Boundary_1_25804854_1282226936453
 Accept: application/xml
 MIME-Version: 1.0
 User-Agent: Java/1.6.0_21
 Host: cuc-install-67.cisco.com
 Connection: keep-alive
 Content-Length: 489122
 --Boundary_1_25804854_1282226936453
 Content-Type: application/json
 {"Subject":"subscriber send message test","ArrivalTime":"0","FromSub":"false"}
 --Boundary_1_25804854_1282226936453
 Content-Type: application/json
 {"Recipient":{"Type":"TO","Address":
 {"ObjectId":"cffc8051-1374-4e57-8d83-9e25aff4385a","Type":"SUBSCRIBER"}}}
 --Boundary_1_25804854_1282226936453
 Content-Type: audio/wav
 RIFFWAVEfmt @>data
 ""
 
 --Boundary_1_25804854_1282226936453
 Content-Type: text/plain;name=textfile.tx
 This is a test text message
 A third line
 end on 5
 --Boundary_1_25804854_1282226936453
 Content-Type: audio/wav
 RIFF??
 
 --Boundary_1_25804854_1282226936453
 Content-Type: text/plain;name=textfile.txt
 This is a test text message
 A third line
 end on 5
 --Boundary_1_25804854_1282226936453--