Call latching description cum technical document

Format of API :
http://www.valuecallz.com/utils/sendVoice.php?cid=&tonumber=&bparty=&tts_data=&max_lat ch_duration=&bufferFlag=retrytime=&returnurl=

Description of parameters:
1) Cid: Has to be provided by ValueFirst and binded with the account. It would be string i.e. LE456CVB234RT123. 2) Tonumber: Source party number (call center number). It could be of 10 digit with xxxxxxxxxx and 11 digits with 0xxxxxxxxxx and 12 digits with 91xxxxxxxxxx. 3) Bparty: Destination party number (end user number). It could be of 10 to 12 digit Number. It could be of 10 digit with xxxxxxxxxx and 11 digit with 0xxxxxxxxxx and 12 Digit with 91xxxxxxxxxx. 4) Tts_data: Variable data if supported by the template (comma separated -- numeric

alphanumeric and date is currently supported only). It would be string and comma separated i.e. your Account balance is due on, 2011-05-06 12:03:45. 5) Max_latch_duration: Latch duration in seconds (by default 2700 seconds). And we can Specify it to a particular limit in seconds so that call will disconnect after the Specified Time. It would be numeric value i.e. 30. 6) BufferFlag: If user wants to buffer the calls and wants to execute on a specified time. It Must set to “true”. it would be string. 7) Retrytime: It is time to execute the buffered call (Must be encoded in YYYY-mm-dd H: i: s format) 8) Returnurl: Has to be provided by client where the MIS needs to be updated at their End.(i.e http://someIP.com/somefile)

The format of URL which will be pushing back to client is given below: http://someIP.com/somefile?srcNo=&destNo=&status=&responseCaptured=&duration=&Credit

e. 5 7) Deliveredon: Call end time in encoded date time format. The client can send us the URL up to http://someIP. 13-4. 2011-01-03 02:23:33 10) latching_credit_used: Call latching credit used (1credit=1. .it would be in hexadecimal string i.it would be the value which user enter during call flow in case of IVR. Descriptions of the parameters for ‘returnurl’ : 1) srcNo: Source party number(call center number) .destination party call status) .5 for 30 seconds call for both the calls. In normal case 1 credit is of 30 seconds.e. 30 6) Credit_used: No of credits used during a call. It would be numeric i. 0x11. It would be in date time format i. 2011-01-03 02:23:33 8) latching_status_String: Call latching status (source party call status. Describe the duration of call in Seconds. it would be numeric i. It would be numeric and dash separated i. 4) responseCaptured: User response captured(default NULL). 2) destNo: Destination party number(end user number). 5) duration: This parameter specifies the duration of call in Seconds.e.e.e. It would be in date time format i.e. It could be of 10 digits with xxxxxxxxxx and 11 digits with 0xxxxxxxxxx and 12 digits with 91xxxxxxxxxx.com/somefile and client can append one or more parameter to the URL. it would be numeric i. It could be of 10 digits with xxxxxxxxxx and 11 digits with 0xxxxxxxxxx and 12 digits with 91xxxxxxxxxx. 3) Status: IVR(Interactive Voice Response) call status._used=&deliveredon=&latching_status_String=&latching_duration=&latching_credit_used=&la stVoiceClip=&Call_Id=&C_Id=&triedon=&retry_count= This is the URL which we get from the client. 9) latching_duration: Call latching duration (default 0).e. This is the time when first party picks up the call. And in case of latching the credit is of 1. 5.5).

12) Call_Id: Unique call ID same as Http API returns in response. duration. latching_credit_used.e. 13) C_Id: Campaign ID same as cid.e.5 >= 8 digits 16 digit(alphanumeric) Yyyy-mm-dd hh:ii:ss 2 vc-1 Yyyy-mm-dd hh:ii:ss . It would be numeric i. latching_duration are set in case of latching rest of the parameters are common in both cases. lastVoiceClip are used in case of IVR (Interactive Voice Response). 2011-06-07 07:34:45 15) retry_count: . The table below specifies the sample values for returnurl parameters: Parameter name srcNo destNo Status responseCaptured duration Credit_used Deliveredon latching_status_String latching_duration latching_credit_used Call_Id C_Id tried_on retry_count lastVoiceClip tried_on Ivr sample value 91xxxxxxxxxx 91xxxxxxxxxx 0x10 1-2-3 30(in seconds) 2 Yyyy-mm-dd hh:ii:ss null null null >= 8 digits 16 digit(alphanumeric) Yyyy-mm-dd hh:ii:ss 2 vc-1 Yyyy-mm-dd hh:ii:ss Latching sample value 91xxxxxxxxxx 91xxxxxxxxxx Null Null Null Null Null 0x10-0x10 30(in seconds) 4. vc-1 and it is the last clip which is listened by the end-user during the call flow. And user can perform any kind of action on the basis of the clip. Like to send a message after the particular clip played during the call flow. responseCaptured. 13456279. It would be string like LE456CVB234RT123 14) tried_on: This is the time when client initiated the request. The parameters like status.It represents the nth retry and it would be numeric. credits_used.11) lastVoiceClip: It would be string i.and the parameters like latching_status_String. It would be in datetime format i.e. Its value range depends on the retry configuration during the creation of the campaign.