MARR Overview

how message archiving works

Standard message handling, be it fax, voicemails or recordings, store the messages in Mailboxes which are accessible online and have various notification options, they are then deleted after 14 days or 3 days if opened.  The Message Archiving option does not change this process but extends it, as the messages are stored in mailboxes they are also archived into a seperate Message Archive area and stored for as long as required. They can be accessed online or via FTP as required.

You define the period to keep the messages for (minimum 3 months, maximum 36 months, can be longer by arrangement), as the message creation date exceeds the defined period files are deleted. This period can be increased or reduced at any time.

Note:Reducing the time period will result in files being deleted from the archive.

The service is charged for in advance at the beginning of each month, on the basis of the pricing structure. The format of the filenaming and directory are described below in the FTP Summary.

pricing structure

The pricing is made up of 2 elements, a Base charge and if appropriate an Additional minutes charge. The Base charge includes recording time (this used to be purchased separately but has now been included into the Message Archiving Service).

The Base charge is levied a month in advance and Additional costs monthly in arrears (based on the total previous months minutes stored).

The charges can be paid for by Card, Direct Debit or Operating Balance debit as long as a minimum of a 100 pound Automatic Operating Voucher is in place on the account.

Example:

1. Turning the MARR service on will cost 30 pounds for the month or part thereof, this will be billed at the beginning of the first complete month.
2. At the beginning of the first complete month, if the total storage used is 3000 minutes, the cost would be 30 pounds.
3. 2nd month if the total storage used is 4000 minutes, the total cost is 30 pounds.
4. 3rd month if the total storage used is 6000 minutes, the total cost is 42 pounds, as an extra block of 5000 minutes has been started.
5. 4th month if the total storage used is 4500 minutes, the total cost is 30 pounds.

how to activate the service

The requirements are:

• that the account is an active account
• the account has a Preferred payment method configured
• has completed all account details.

To activate select the Message Archive link under Mailboxes on the left hand menu when logged in to your account. You will be asked to select the Period of storage and if Voicemails should be archived, you will then be asked to agree to the T&Cs, if the account is setup as per the requirements then MARR will be activated. If you Account does not meet the requirements then it will be activated but you will be contacted by Support to complete the requirements, if this is not accomplished then the Service will be disabled.

how to terminate the service

You must contact Callagenix either online or via email and request termination of the Message Archive service 30 days notice is required. Notice can be given at any time.

If you wish to cancel the service, then you request this by accessing the MARR Settings page and setting the MARR Period to Request Cancellation. A cancellation request is passed to Callagenix accounts and they will process this for you, confirming the cancellation when it occurs.

how the archive FTP works

There is an FTP area for each account ftp://ftp.callagenix.com this area contains archived files in a set of subdirectories, these are fax, voicemail, recordout and recordin which match the respective message types, there are also directories for Datafiles and Billing.

The file naming has changed so that downloaded files can be more easily identified and each message file also has an associated data file (xml extension) that can also be accessed at the same time, this should ease the process of importing, storing and accessing the message data.

MARR Datafile

When the MARR service creates an archive record, it creates an archive file in the relevant account's archive storage area. This file is a copy of the original voicemail, recording or fax file received (.tif files for faxes and .wav files for voicemails and recordings). An accompanying message details file is created in the same location with the same name, but with a .xml extension. This details file contains the message details as they appear in the database archive. The details file is saved in XML format, and appears as in the following example:

<?xml version='1.0' encoding='utf-8'?>
<details>
	<MessageID>841210</MessageID>
	<MailboxID>2134</MailboxID>
	<MessageType>Voicemail</MessageType>
	<MessageLength>4 seconds</MessageLength>
	<DateArchived>Thu Oct 18 13:32:02 UTC+0100 2007</DateArchived>
	<CallLogID>22985560</CallLogID>
	<MailboxName>CGX Default</MailboxName>
	<ServiceID>2443</ServiceID>
	<ServiceName>Out of Hours</ServiceName>
	<CallersNumber></CallersNumber>
	<NumberDialed>02070222933</NumberDialed>
	<DivertNumber></DivertNumber>
	<CallStartDate>Thu Oct 18 13:29:10 UTC+0100 2007</CallStartDate>
	<CallDuration>18 seconds</CallDuration>
	<FileSize>34220 bytes</FileSize>
</details>
 

The tags used in this file encapsulate the following information: