Call POST

Call POST
POST /api/call

Upload a new call.
NOTE: This function will return a {tempcallid} which can then be used to attach audio. Only when the audio is attached is the call record uploaded to the server.

 

JSON Body Schema

{
 "startdatetimeutc": {"type": "string"},
 "callername": {"type": "string"},
 "callerphone": {"type": "string"},
 "callerdtmf": {"type": "string"},
 "callermacaddress": {"type": "string"},
 "callermediaendpoint": {"type": "string"},
 "destinationname": {"type": "string"},
 "destinationphone'": {"type": "string"},
 "destinationdtmf": {"type": "string"},
 "destinationmacaddress": {"type": "string"},
 "destinationmediaendpoint": {"type": "string"},
 "clientoperatingsystem": {"type": "string"},
 "servername": {"type": "string"},
 "location": {"type": "string"}
}

 

Result Code

200

OK

400

JSON body not provided invalid startdatetimeutc

401

Unauthorized

403

account has reached monthly deposit quota of <plan limit> hours
account has reached storage capacity of <plan limit> hours, and you have automatic remove oldest recordings disabled
recording for the contact <name> is disabled

405

Your reseller account has no clients with that phone number and there is no UnmatchedAssociatedAccount configured
Your reseller account has no clients with that phone number and the UnmatchedAssociatedAccount doesn’t exist

406

SSL must be used

500

Server Error

 

Result Body

{tempcallid}

This is used to upload audio to complete the call upload.

 

Example request

Example;-
PUT
https://api.calln.com/api/call

Headers:
Content-Type: application/json; charset=utf-8
Content-Length: {body length in bytes}

Body:
{'startdatetimeutc':'2013-10-09 15:23:54','callername':'fred','callerphone':'0409123456','callerdtmf':'','destinationname':'bill','destinationphone':'0312345678','destinationdtmf':'','clientoperatingsystem':'Windows Server 2008 R2 64-bit','servername':'testpc','location':'Melbourne office'}

Result;-
200 (OK)

Body:
{'tempcallid':'312947621348675456t8234'}

Calculate your CallN Costs in 60 Seconds

  • Accurate details are needed in order to use the right pricing tier information.
  • The calculator will give you the total cost of the plan according to the total months you specify
  • Accurate details are needed in order to use the right pricing tier information.
  • The calculator will give you the total cost of the plan according to the total months you specify
  • After you sign up, this will be used for your Calln domain.
  • A Team member will contact you on this number.
  • A summary of your calculations will be sent to this email address.
  • You may review our terms and conditions and privacy policies by clicking on the links above.