Child pages
  • CSTA over HTTP - Requests

Contents

Snom phones support the following requests send to the phone via HTTP: 



RequestSystemStatus

Request:

<?xml version="1.0" encoding="UTF-8"?>
<RequestSystemStatus xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>


Answer:

<?xml version="1.0" encoding="utf-8"?><RequestSystemStatusResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"><systemStatus>normal</systemStatus></RequestSystemStatusResponse>


SnapshotDevice

Request:

<?xml version="1.0" encoding="UTF-8"?><SnapshotDevice xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"><snapshotObject>455455@ser.intern.snom.de</snapshotObject></SnapshotDevice>


Answer:

<?xml version="1.0" encoding="utf-8"?>
<SnapshotDeviceResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5">
<crossRefIDorSnapshotData>
<snapshotData>
<snapshotDeviceResponseInfo>
<connectionIdentifier>
<callID>-12</callID>
<deviceID>sip:455455@ser.intern.snom.de</deviceID>
</connectionIdentifier>
<localCallState>
<compoundCallState>
<localConnectionState>alerting</localConnectionState>
</compoundCallState>
</localCallState>
</snapshotDeviceResponseInfo>
</snapshotData>
</crossRefIDorSnapshotData>
</SnapshotDeviceResponse>



MakeCall

Request:

<?xml version="1.0" encoding="UTF-8"?><MakeCall xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
<callingDevice>sip:455455@ser.intern.snom.de</callingDevice>
<calledDirectoryNumber>455360</calledDirectoryNumber>
<autoOriginate>doNotPrompt</autoOriginate>
</MakeCall>

Answer:

<?xml version="1.0" encoding="utf-8"?>
<MakeCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5">
<callingDevice>
<callID>2</callID>
<deviceID>sip:455455@ser.intern.snom.de</deviceID>
</callingDevice>
</MakeCallResponse>


callingDevice is the user_name@pbx of a configured identity. When this field has an empty value, then the active identity is used to make the call. Otherwise the value is used to choose the identity by comparing the value with the configured user name of every identity.



ConsultationCall

Request:

<?xml version="1.0" encoding="UTF-8"?><ConsultationCall xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
<existingCall>
<callID>3</callID>
<deviceID>sip:455370@ser.intern.snom.de</deviceID>
</existingCall><consultedDevice>455320</consultedDevice>
</ConsultationCall>


Answer:

<?xml version="1.0" encoding="utf-8"?>
<ConsultationCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5">
<initiatedCall><callID>4</callID>
<deviceID>sip:455455@ser.intern.snom.de</deviceID>
</initiatedCall>
</ConsultationCallResponse>



AnswerCall

Request:

<?xml version="1.0" encoding="UTF-8"?>
<AnswerCall xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5">
<callToBeAnswered>
<callID>-17</callID>
<deviceID>sip:455455@ser.intern.snom.de</deviceID>
</callToBeAnswered>
</AnswerCall>


Answer:

<?xml version="1.0" encoding="utf-8"?>
<AnswerCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"/>



ClearConnection

Request:

<?xml version="1.0" encoding="UTF-8"?>
<ClearConnection xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'><connectionToBeCleared>
<callID>2</callID>
<deviceID>sip:455455@ser.intern.snom.de</deviceID>
</connectionToBeCleared>
</ClearConnection>


Answer:

<?xml version="1.0" encoding="utf-8"?><ClearConnectionResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"/>



ClearCall

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:csta="http://www.ecma-international.org/standards/ecma-323/csta/ed4">
<SOAP-ENV:Body>
<csta:ClearCall>
<csta:callToBeCleared>4711</csta:callToBeCleared>
</csta:ClearCall>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>



HoldCall

Request:

<?xml version="1.0" encoding="UTF-8"?><HoldCall xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed4">
<callToBeHeld>
<callID>4</callID>
<deviceID>sip:455455@ser.intern.snom.de</deviceID>
</callToBeHeld>
</HoldCall>

Answer:

<?xml version="1.0" encoding="utf-8"?>
<HoldCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"/>



RetrieveCall

Request:

<?xml version="1.0" encoding="UTF-8"?>
<RetrieveCall xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed4">
<callToBeRetrieved>
<callID>4</callID>
<deviceID>sip:455455@ser.intern.snom.de</deviceID>
</callToBeRetrieved>
</RetrieveCall>

Answer:

<?xml version="1.0" encoding="utf-8"?><RetrieveCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"/>


Conference Call

Request:

<?xml version="1.0" encoding="UTF-8"?><ConferenceCall xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed4"><heldCall><callID>13</callID><deviceID>sip:455455@ser.intern.snom.de</deviceID></heldCall> <activeCall><callID>14</callID><deviceID>sip:455455@ser.intern.snom.de</deviceID></activeCall></ConferenceCall>


Answer:

<?xml version="1.0" encoding="utf-8"?><ConferenceCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"><conferenceCall> <callID>14|13</callID><deviceID>sip:455455@ser.intern.snom.de</deviceID></conferenceCall> <connections> <connectionListItem><newConnection> <callID>14|13</callID><deviceID>sip:455455@ser.intern.snom.de</deviceID></newConnection> <oldConnection> <callID>14</callID><deviceID>sip:455455@ser.intern.snom.de</deviceID></oldConnection> </connectionListItem><connectionListItem><newConnection> <callID>14|13</callID><deviceID>sip:455820@ser.intern.snom.de</deviceID></newConnection> <oldConnection> <callID>14</callID><deviceID>sip:455820@ser.intern.snom.de</deviceID></oldConnection></connectionListItem><connectionListItem><newConnection><callID>14|13</callID><deviceID>sip:455370@ser.intern.snom.de</deviceID></newConnection><oldConnection><callID>13</callID><deviceID>sip:455370@ser.intern.snom.de</deviceID></oldConnection></connectionListItem></connections></ConferenceCallResponse>



TransferCall

Request:

<?xml version="1.0" encoding="UTF-8"?><TransferCall xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed4"><heldCall><callID>16</callID><deviceID>sip:455455@ser.intern.snom.de</deviceID></heldCall><activeCall><callID>15</callID><deviceID>sip:455455@ser.intern.snom.de</deviceID></activeCall></TransferCall>


Answer:

<?xml version="1.0" encoding="utf-8"?><TransferCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"><transferredCall><callID>how_should_i_know_4711</callID><deviceID>sip:455370@ser.intern.snom.de</deviceID></transferredCall></TransferCallResponse>



SingleStepTransferCall

Request:

<?xml version="1.0" encoding="UTF-8"?><SingleStepTransferCall xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'><activeCall><callID>2</callID><deviceID>sip:455320@ser.intern.snom.de</deviceID></activeCall><transferredTo>455370</transferredTo></SingleStepTransferCall>

Answer:

<?xml version="1.0" encoding="utf-8"?><SingleStepTransferCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"><transferredCall><callID>how_should_i_know_4711</callID><deviceID>tel:455370</deviceID></transferredCall></SingleStepTransferCallResponse>



DeflectCall

Request:

<?xml version="1.0" encoding="UTF-8"?><DeflectCall xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'><callToBeDiverted><callID>-4</callID><deviceID>sip:455820@ser.intern.snom.de</deviceID></callToBeDiverted><newDestination><device>455370</device></newDestination></DeflectCall>

Answer:

<?xml version="1.0" encoding="utf-8"?><DeflectCallResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"/>


GenerateDigits

Request:

<?xml version="1.0" encoding="UTF-8"?><GenerateDigits><connectionToSendDigits><callID>2</callID><deviceID>sip:455455@ser.intern.snom.de</deviceID></connectionToSendDigits><digitMode>DTMF</digitMode><charactersToSend>1234</charactersToSend></GenerateDigits>


Answer:

<?xml version="1.0" encoding="utf-8"?>
<GenerateDigitsResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"/>



GetSwitchingFunctionDevices

Request:

<?xml version="1.0" encoding="UTF-8"?><GetSwitchingFunctionDevices/>
Answer:
<?xml version="1.0" encoding="utf-8"?>
<GetSwitchingFunctionDevicesResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"><serviceCrossRefID>GSFD4711</serviceCrossRefID></GetSwitchingFunctionDevicesResponse>

2nd Answer (in uaCsta send via separate SIP-INFO, HTTP-CSTA appends this to initial answer):

<?xml version="1.0" encoding="UTF-8"?>
<SwitchingFunctionDevices xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"><serviceCrossRefID>GSFD4711</serviceCrossRefID><lastSegment>true</lastSegment>
<deviceList>
<device>
<deviceID>sip:455455@ser.intern.snom.de</deviceID>
</device>
<device>
<deviceID>sip:455456@ser.intern.snom.de</deviceID>
</device>
<device>
<deviceID>sip:455457@ser.intern.snom.de</deviceID>
</device>
</deviceList>
</SwitchingFunctionDevices>



GetDoNotDisturb

Request:

<?xml version="1.0" encoding="UTF-8"?>
<GetDoNotDisturb xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5"> 
<xmlns:xsi='sip:455455@ser.intern.snom.dehttp://www.w3.org/2001/XMLSchema-instance'>
<device>sip:455455@ser.intern.snom.de</device></GetDoNotDisturb>


Answer:

<?xml version="1.0" encoding="UTF-8"?>
<GetDoNotDisturbResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5">
<doNotDisturbOn>false</doNotDisturbOn>
</GetDoNotDisturbResponse>



SetDoNotDisturb

Request:

<?xml version="1.0" encoding="UTF-8"?>
<SetDoNotDisturb xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='sip:455455@ser.intern.snom.dehttp://www.w3.org/2001/XMLSchema-instance'>
<device>sip:455455@ser.intern.snom.de</device>
<doNotDisturbOn>false</doNotDisturbOn>
</SetDoNotDisturbfalse>


Answer:

<?xml version="1.0" encoding="UTF-8"?>
<SetDoNotDisturbResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"/>



GetForwarding

Request:

<?xml version="1.0" encoding="UTF-8"?>
<GetForwarding xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'><device>sip:455455@ser.intern.snom.de</device>
</GetForwarding>

Answer:

<?xml version="1.0" encoding="UTF-8"?><SingleStepTransferCall xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'><activeCall><callID>2</callID><deviceID>sip:455320@ser.intern.snom.de</deviceID></activeCall><transferredTo>455370</transferredTo></SingleStepTransferCall>



SetForwarding

Request:

<?xml version="1.0" encoding="UTF-8"?>
<SetForwarding xmlns='http://www.ecma-international.org/standards/ecma-323/csta/ed5' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
  <device>sip:455455@ser.intern.snom.de</device>
  <forwardingType>forwardImmediate</forwardingType>
  <activateForward>true</activateForward>
  <forwardDN>42</forwardDN>
  <ringDuration></ringDuration>
</SetForwarding>


Answer:

<?xml version="1.0" encoding="UTF-8"?>
<SetForwardingResponse xmlns="http://www.ecma-international.org/standards/ecma-323/csta/ed5"/>


Note: CSTA via HTTP used to require the csta-xml to be enveloped in SOAP, since 8.7.3 this is no longer necessary except for the proprietary requests described in 4 Proprietary CSTA Messages and Action URLs and for ClearCall. For all other services this is now optional.