The
MMSMessage object is used when submitting MMS messages to the Gateway through the
SOAP API.
General information
MMS in general and Premium MMS (CPA) are currently supported for the following operators:
Norway:
Telenor Mobil
NetCom
Tele2
Packaging
To simplify the packaging and transmission of MMS Messages, we
have decided to use a simple ZIP file as the packaging of the MMS
content. This means that all the content files/parts of the MMS must
be zipped together into one zip-file before transmission to the MMS
Gateway. The zip-file should not have any internal directory structure;
all content files must reside in the root directory of the zip file, like
this:
MyZippedMMS.zip contains
Pres.smil
Image.gif
Message.txt
How to construct an MMS presentation with text, audio and image
content is beyond the scope of this interface documentation. Most will
use some kind of MMS composer or other software to create the files
required. Refer to
http://www.w3.org/AudioVideo/ for more
information about creating mobile content and SMIL files.
The zip-file is transmitted as a Byte-array to the MMS Gateway the
attribute below named Data.
Properties
The table below shows all attributes and their description:
Attribute | Description |
ReceiverNumber | Number of the receiver, internationally
formatted with country-code but no “+” or “00”
prefixed. |
SenderNumber | Number of sender to be displayed on receiver’s
handset. Numeric with no “+” or space, max 15
digits. Alphanumeric up to 11 characters can
also be used. |
Subject | This is the subject of the MMS to send or
receive. |
Tariff | Specifies the amount to charge the end-user in
units of cents/”ører”. For example, to charge the
end-user NOK 5,- you specify “500” as the
TARIFF value. Only valid values must be used.
Valid values are described in the CPA Agreement
from PSWinCom that is required to use this
property. |
Data | Byte-array containing the MMS Message content
as a packed zip-file. |
Network | Optional. Used to indicate special routing of the
message. Should only be set upon request from
gateway-owner. |
TimeToLive | Set this value to the number of minutes that the message should be valid before it expires if not delivered. Set to 0 to use the default value. |
CPATag | Optional. Used with CPA messages to indicate further details on the subscribers telephone bill what he/she has paid for. |
ReceiptRequest | If this attribute is set to true and forwarding of delivery reports are enabled for your Gateway account, then the delivery report for this message will be forwarded to your application. |
SessionData | Optional. A free text field that can be used to tag the session with customer specific data such as the application name, username, reference-id etc. The maximum length is 200 characters.
Leave empty unless required. |
AffiliateProgram | Optional. If you are part of an Affiliate-Program offered by the PSWinCom Gateway provider, you can use this element to specify your Affiliate Program code. Leave empty unless required. |
Code
C# notation of the SMSMessage object:
public class MMSMessage
{
public string ReceiverNumber;
public string SenderNumber;
public string Subject;
public string Network;
public int Tariff;
public int TimeToLive;
public string CPATag;
public bool RequestReceipt;
public string SessionData;
public string AffiliateProgram;
public byte[] Data;
public MMSMessage()
{
}
}
XML
<MMSMessage>
<ReceiverNumber>4792112233</ReceiverNumber>
<SenderNumber>2077</SenderNumber>
<Subject>My MMS</Text>
<Network> </Network>
<Tariff>0</Tariff>
<TimeToLive>0</TimeToLive>
<CPATag></CPATag>
<RequestReceipt>true</RequestReceipt>
<SessionData></SessionData>
<AffiliateProgram></AffiliateProgram>
<Data>____</Data>
</MMSMessage>
See also