PhoneGnome API >> phonegnome.Dial

phonegnome.Dial

Dials a given destination using PhoneGnome.

The call initiates a click-to-dial call. The associated PhoneGnome from which the call will be placed is dialed, and when answered, the call to the desitination connected.

URI

All XML-RPC requests should go to the following URI: http://my.phonegnome.com/RPC2

Parameters

1. country_code (string): Country code of the PhoneGnome
2. phone_number (string): Telephone number of the PhoneGnome placing the call
3. md5_pin (string): MD5 hash of the PIN of the PhoneGnome account (PIN is same as that of the my.phonegnome.com dashboard)
4. number_to_call (string): the number (or SIP uri) to call, just as it would be dialed from the PhoneGnome

Examples

Example XML-RPC request

<?xml version="1.0"?>
<methodCall>
 <methodName>phonegnome.Dial</methodName>
  <params>
   <param>
    <value><string>1</string></value>
   </param>
   <param>
    <value><string>3605551212</string></value>
   </param>
   <param>
    <value><string>844dda78e8a09008813020f47215e2a3</string></value>
   </param>
   <param>
    <value><string>18005551212</string></value>
   </param>
  </params>
</methodCall>

Successful Response

<?xml version="1.0"?>
<methodResponse>
 <params>
  <param>
   <value><string>ok</string></value>
  </param>
 </params>
</methodResponse>

Error Response

<?xml version="1.0"?>
<methodResponse>
 <fault>
  <value>
   <struct>
    <member>
     <name>faultString</name>
     <value><string>dial failed</string></value>
    </member>
    <member>
     <name>faultCode</name>
     <value><int>600</int></value>
    </member>
   </struct>
  </value>
 </fault>
</methodResponse>

© TelEvolution 2006