Mailbox Service

The mailbox service is used to interact with thing mailboxes.

When a mailbox message is sent, the TR50 client that receives the mail item has the option to reply with data to the sender.  The ackTimeout specifies how long the sender is willing to wait for a reply from the receiving client.  If the receiving TR50 client is not online at the time the message is sent or is otherwise delayed in retrieving mailbox messages, the ttl specifies how long to hold the message in Device Cloud for future delivery to the receiving client.  

• An ackTimeout of minus one (-1) indicates that the command must return immediately and not wait for a reply.  The message is stored in the cloud depending on the ttl specified.

• A ttl of minus one (-1) indicates that Device Cloud must hold the message indefinitely until it can be delivered to a client. Messages can still be aged out of an account before delivery, depending on the organization's retention settings for the mailbox.

• If the ackTimeout parameter is specified but the ttl parameter is not, then the ttl is equal to the value of ackTimeout.