New Call

This webhook is sent when a new call is created on the platform, it is configured at the appplication level

Authentication

AuthorizationBasic

Basic authentication of the form Basic <username:password>.

Query parameters

call_sidstringRequired

a unique identifier for the call.

application_sidstringRequired

a unique identifier for the jambonz application controlling this call

account_sidstringRequired

a unique identifier for the jambonz account associated with the application

directionenumRequired

the direction of the call:

inbound - The call was originated outside jambonz
outbound - The call was originated by jambonz

the direction of the call: * `inbound` - The call was originated outside jambonz * `outbound` - The call was originated by jambonz

Allowed values:

fromstringRequired

the calling party number

tostringRequired

the called party number

caller_namestringRequired

the caller name, if known

call_statusenumRequired

current status of the call:

trying - a new incoming call has arrived or an outbound call has just been sent
ringing - a 180 Ringing response has been sent or received
early-media - an early media connection has been established prior to answering the call (183 Session Progress)
in-progress - call has been answered
completed - an answered call has ended
failed - a call attempt failed
busy - a call attempt failed because the called party returned a busy status
no-answer - a call attempt failed because it was not answered in time

current status of the call: * `trying` - a new incoming call has arrived or an outbound call has just been sent * `ringing` - a 180 Ringing response has been sent or received * `early-media` - an early media connection has been established prior to answering the call (183 Session Progress) * `in-progress` - call has been answered * `completed` - an answered call has ended * `failed` - a call attempt failed * `busy` - a call attempt failed because the called party returned a busy status * `no-answer` - a call attempt failed because it was not answered in time

sip_statusdoubleRequired

the most recent sip status code received or generated for the call

Response

Return a 200 containing a JSON payload consisting of an array of verbs

1	import requests
2
3	url = "https://{yourserver}/webhooks/call"
4
5	querystring = {"call_sid":"d2515c3b-b79a-41a2-971a-445e769c823c","application_sid":"72c5c38f-9bba-40ce-aa83-aaa6be55e1b5","account_sid":"bad98250-b34d-459d-9e90-f97dfb9bc519","direction":"inbound","from":"+12125551212","to":"+14155551234","caller_name":"John Doe","call_status":"trying","sip_status":"100"}
6
7	headers = {"Authorization": "Basic <username>:<password>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())