Webhooks. Incoming call event.
Katerina Tverdochleb avatar
Written by Katerina Tverdochleb
Updated over a week ago

Incoming call event can send notifications at different moments, such as:

  • before call

  • after call

  • after call rating menu

  • when taking the call

  • on location forwarding

By transferring information about calls to the CRM system, you get an additional tool to control the sales department and boost work in the CRM system.

Sending events on Callback calls

Callback is considered an incoming call, so if you want to send such calls to your CRM system, you should choose the moment the call will be transferred at.

You can divide the calls into several types using the Insertion Type parameter:

  • dynamic

  • static

  • callback

Customized parameters submission

  1. Custom parameter submission

To submit a custom parameter, you should create a tracking entity and choose it from the parameters list. Please check more details on this in the Tracking entities article.

2. Static parameter submission.

You can also submit a static parameter. It is mostly used to identify the application from which the event is sent.

NB! You can pass a static parameter only by GET method in the url address of the processor.

In order to submit static parameters, you should go to Webhook configuration in Webhook 2.0 section and add those parameters in Destination field.

Here, two parameters, i.e. source and service, are submitted as an example.

NB! You can choose any method of sending the data, as the parameters and their value are specified in the URL to which the parameters are sent.

NB! The parameter name should be written in Latin without spaces, otherwise, the data will not be submitted correctly. If you need to submit a parameter name in Cyrillic and/or with spaces, you should provide it in curly brackets. For example: {{parameter name}}

Here, in this file, you can find all the parameters that can be sent by the Incoming call event.

Example of processed parameters in JSON format forwarded when taking the call

{
"caller":"380441112233",
"callee":"380442223344",
"status":"PROPER",
"date":"2018-08-13 11:11:11",
"call_duration":61,
"type":"in",
"waiting":43,
"dialog":18,
"destination":"380443334455",
"number_call":1,
"proper":1,
"repeated":0,
"pool_name":"Main pool",
"source":"ringostat",
"medium":"support",
"campaign":"test",
"content":"webhhok_simple_test",
"term":"webhook",
"record":"3333333333.3333333",
"user_uuid":"669962468.1534189331",
"user_ip":"10.10.10.10",
"gaid":"UA-11111111-1",
"record_link":"https://app.ringostat.com/recordings/3333333333.33...
"unique_first":1,
"unique_proper":1,
"first_proper":1,
"full_num":"+380441112233",
"manager_id":"6164",
"manager":"4411;4416;4421;5364;5909;6164",
"call_id":"3333333333.3333333",
"roistat_visit_id":"17541",
"landing":"ringostat.com/?utm_source=ringostat&utm_medium=support&utm_campaign=test&utm_term=webhook&utm_content=webhhok_simple_test",
"last_page":"ringostat.ua/benefits",
"replace_type":"dynamic",
"custom":"https://ringostat.ua/benefits"
"referrer":"https://www.google.com/"
"scheme":"Основная"
"has_recording":"0"
"call_card":"https://app.ringostat.com/project/callcards/card/....
"employee_fio":"John"
"department":"Sales department"
"calldate_timestamp_micros":“1230219000000000”,
"recording_wav":"https://app.ringostat.com/recordings/ua8_-11111111111.1111111.wav?token=462908f128343fc23862397ddd638953"
"roistatid":“666666”,
"add_num_id":“102"
"useragent":“Mozilla/5.0 (Linux; Android 8.0.0; LND-L29 Build/HONORLND-L29; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/96.0.4664.45 Mobile Safari/537.36”
"project_id": "1000"
}

Did this answer your question?