Call Notify
#

  • REST
  • Java

Call Notify
#

Call Notify
#

To help agents verify the name and other information about an inbound, outbound, or blind-transferred caller, you can send a request to a CRM that supports the display of a contact information page based on the calling number. The Call Notify webhook sends a message from Voiso to the CRM to enable the CRM to open the contact information page.

The callNotify webhook supports GET and POST request methods.

Activation
#

To use the Call Notify webhook, you must first enable it in the Voiso System Settings. Navigate to Administration > System Settings, and click Enabled.

After enabling the Call Notify webhook feature, complete the following configuration settings:

  • URL: The URL of your CRM API.
  • Authorisation token: (optional) Requests are sent with the specified token in the request header. The default is blank, meaning no token is sent in the request header.
  • Token prefix: (optional, required for the token) Requests are sent with the specified token prefix in the request header. The default is blank, meaning no token prefix is sent in the request header.
  • HTTP request method: Select either GET or POST. GET is the default selection.

Call Notify API settings in Administration System Settings

Event
#

Voiso sends a GET or POST message to the specified endpoint when an agent gets an inbound call, an agent or dialer makes an outbound call, or an agent blind transfers a call.

Sent Query
#

{
"callcenter": "client_name",
"type": "inbound",
"uuid": "07771c38-c159-4965-a878-be0162118b2b",
"agent_extension": "111",
"agent_name": "John Smith",
"agent_email": "john@gmail.com",
"agent_id": 1,
"queue_name": "Inbound queue name",
"script_name": "Inbound script name",
"call_start_time": 1630664544.661,
"agent_start_time": 1630664545.123,
"ani": "443336006114",
"dnis": "18885658889"
}

Example Query:

https://crm.com/endpoint?agent_email=john%40gmail.com&agent_extension=111&agent_id=1&agent_name=John+Smith&agent_start_time=1630664545.123&ani=443336006114&call_start_time=1630664544.661&callcenter=client_name&dnis=18885658889&queue_name=Inbound+queue+name&script_name=Inbound+script+name&uuid=07771c38-c159-4965-a878-be0162118b2b

Fields
#

NameTypeDescriptionValue
callcenterstringcontact center name
typecall typestringinbound, outbound, dialer
uuidstringcall uuid
agent_extensionstringuser extension number
agent_namestringagent name
agent_emailstringagent email
agent_idintegeragent id
queue_namestringqueue name
script_namestringscript name
call_start_timenumbercall start time in unix timestamp
agent_start_timenumberagent call start time in unix timestamp
anistringorigination number
dnisstringdestination number

Transfers
#

A new GET request is sent if the call is transferred from one agent to another.

Data from the second agent fill the following fields:

  • agent_extension
  • agent_email
  • agent_id
  • agent_start_time.

All other data remains the same.