Событие "Входящий звонок" включает 5 моментов для отправки оповещений. Каждый момент содержит список параметров доступных для передачи.
Передавая в CRM-систему информацию о принятых звонках, их можно сопоставить со сделками которые завели менеджеры. Таким образом, вы получаете дополнительный инструмент контроля отдела продаж и автоматизации работы в crm-системе.
Давайте детально рассмотрим моменты отправки оповещений и доступные параметры, для каждого момента.
Отправка событий по звонкам Callback
Звонки Callback относятся к событию Входящий звонок, поэтому для отправки параметров нужно выбирать моменты, которые относятся к этому событию.
Отделить звонки вы можете ориентируясь на значение параметра Тип подмены:
- dynamic
- static
- callback
В данном файле описаны все параметры которые можно передавать событием "Входящий звонок"
Передача параметров пользователя
Для события Входящий звонок характерна передача параметров пользователя. Это может быть переменная в глобальной области видимости или статический параметр для идентификации приложения, переданный в URL-запроса.
1. Передача параметра custom
Чтобы передать параметр custom, нужно настроить отслеживаемые сущности на странице настроек коллтрекинга.
Допустим на сайте, есть некая переменная url, укажем это в значении и введём понятное имя.
После создания и настройки сущности, можно перейти к добавлению в webhook.
В меню навигации, выберите Интеграция -> Webhooks и нажмите на Добавить параметр.
В списке доступных параметров, выберите вашу сущность, она уже появится среди списка.
2. Передача статического параметра
Так же, Вы можете передать статический параметр вместе с оповещением. В большинстве ситуаций, он указывается не более, чем для идентификации приложения, из которого отправлено оповещение.
Обратите внимание! Передать статический параметр можно только методом GET, в url адресе обработчика.
В окне настройки Webhook запроса, перейдите в поле Направление и добавьте статические параметры для передачи.
На примере показана передача 2х статических параметров – source и service
Обратите внимание! Метод отправки данных не имеет значения, т.к. параметры и их значение прописаны в URL-адресе, на который отправляется оповещение.
Важно! Название параметра должно быть на латинице и без пробелов, иначе не будет корректной передачи данных. Если нужно название параметра только на кириллице и/или с пробелами, в таком случае его следует записать в фигурных скобках. К примеру: {{название параметра}}
3. Пример обработанных параметров в формате JSON, переданных в момент ответа
{
"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":"Основной пул, все переходы",
"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":"Иван Иванов"
"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"
}