4PSA Knowledge Base

Space shortcuts

Page tree

Applies to VoipNow 3 and higher!

Call Events is a service that provides ways to notify web applications about various events triggered by phone calls. The notification is performed using REST calls. With the help of this service, a developer can define custom requests to be sent when specific events occur.

There are currently 3 events supported by the Call Events service:

  • Dial-In, which occurs when a call is received by an extension.
  • Dial-Out, which occurs when a call is made by an extension.
  • Hangup, which occurs when the call the extension is involved in gets hung up.

Events management

In order to modify Call Events for an extension, you have to connect to the web interface and go to the extension's management page and click on Call Events icon in the Developers area.The attributes you can modify are:

  • Request method: The method used when making the request (this can be either GET or POST).
  • Event ID: A unique ID generated for each request, useful for identifying requests.
  • Make request to: The request URL that is called when the event is triggered.
  • Status: Requests can be enabled or disabled with the help of this functionality. A disabled request is no longer performed.
  • Notes: An informative note about the request, used for reference only.

Default request parameters

Here is a list with the parameters that are automatically added to each request. Their main usage is to provide third-party applications with more information about events:


NameOccurenceTypeRequiredDescription
CallID1StringNoThe call's unique identifier.
CallerIDNum1StringNoThe caller's CallerID number.
CallerIDNam1StringNoThe caller's CallerID name.
CalledDID1StringNoThe public number of the called extension (if available).
CalledExtension1StringNoThe extension that received the call. Supported format: extended extension number (e.g. yyyy*zzz).
CallStatus1StringNoThe call status. For Dial-In and Dial-Out type events, this parameter is set to CALLING, for Hangup events is set to ANSWER or UNKNOWN.
CallFlow1StringNoThe call flow: IN - for the calls received by the extension or OUT - for the calls made by the extension.
CallerExtension1StringNoThe extension that made the call. Supported format: extended extension number (e.g. yyyy*zzz).
CalledNumber1StringNoThe number that was dialed by the caller. It can be a public number or the extended number of an extension.


#trackbackRdf ($trackbackUtils.getContentIdentifier($page) $page.title $trackbackUtils.getPingUrl($page))

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 4.0 International.