Differences

This shows you the differences between two versions of the page.

Link to this comparison view

virtual_sim_en [2012/07/06 10:16] (current)
admin created
Line 1: Line 1:
 +{{:logo_trasp.png|}}
 +
 +==== Language ====
 +
 +[[virtual sim|{{italy.png|Italiano}}]] 
 +
 +====== Virtual SIM API ======
 +
 +==== Type of services (Dedicated or Shared) ====
 +
 +You can choose to use Virtual SIM in two ways:
 +
 +  * Dedicated
 +
 +Will be assigned a mobile phone number exclusively dedicated to the customer account. All incoming messages will be forwarded
 +according the protocol choose.
 +
 +  * Shared
 +
 +Will be assigned a mobile phone number shared from different accounts. All incoming messages will be forwarded
 +to the customer according the protocol choose and the shared key at the beginning of the message body. Shared key will be choose 
 +during Virtual SIM setup procedure.
 +
 +===== Receipt of Short Messages through HTTP protocol =====
 +
 +With Virtual SIM service you can receive incoming SMS through HTTP POST. Below is an example of customer provided URL that the AirTelco SMS gateway
 +recall following the arrival of each incoming messages.
 +
 +<note>http://customerurl.tld/customerpage?to=VIRTUALSIMNUMBER&from=SENDERID&body=MESSAGE</note>
 +
 +==== HTTP POST Parameters ====
 +
 +  * to
 +
 +Virtual SIM phone number assigned to the customer account (Example: +393401112222)
 +
 +  * from
 +
 +Sender ID of the incoming message (Alphanumeric value - Example: +39333111122)
 +
 +  * body
 +
 +Message body encoded in Latin-1 (ISO-8859-1)
 +
 +===== Receipt of Short Messages through RSS Protocol (Really Simple Syndication) =====
 +
 +In this way is possible to get back last messages received formatted in the RSS standard.
 +
 +<note tip>RSS version supported is 1.0</note>
 +
 +Below an example of HTTP GET request initiated by the customer in order to get back last 5 messages.
 + 
 +<note>http://gateway.airtelco.com/raven/sms/receive?login=LOGIN&password=PASSWORD&recv_id=VIRTUALSIM_SERVICE_ID&action=getmess&rss=1&num=5</note>
 +
 +
 +==== Parameters ====
 +
 +  * login
 +
 +User ID Account.
 +
 +  * password
 +
 +Customer Password.
 + 
 +  * recv_id
 +
 +Unique identifier of the Virtual SIM service. It's possible to know which is the identifier of the service by entering in the [[http://www.airtelco.com/index.php?p=/accounts/login|reserved area]].
 +
 +  * action
 +
 +action parameter has to be equal to: **getmess** 
 +
 +  * rss
 +
 +rss parameter has to be equal to the version of the RSS protocol you want to use. (Version available: 1) 
 +
 +  * num
 +
 +through this parameter you can set the maximum number of messages not read you want to get back.
 +
 +Example of response:
 +
 +<?xml version="1.0"?> \\
 +<rdf:RDF> \\
 + <item rdf:about=""> \\
 + <title>+3933333333</title> \\
 + <link/> \\
 + <description>Hello World</description> \\
 + </item> \\
 +</rdf:RDF> \\
 +\\
 +
 +===== Receipt of Short Message through Email =====
 +
 +With the Virtual SIM Service you can receive a copy of the message via email. Contact AirTelco support team in order to set the email address you want to use.
 + 
 +===== SMS Voting =====
 +
 +With Virtual SIM Service you can use free of charge AirTelco SMS voting platform. 
  
virtual_sim_en.txt · Last modified: 2012/07/06 10:16 by admin
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki