К основному содержимому
Все коллекцииAPI и WebhooksWebhooks
Webhooks. Событие "Входящий звонок"
Webhooks. Событие "Входящий звонок"
Katerina Tverdochleb avatar
Автор: Katerina Tverdochleb
Обновлено более 3 мес. назад

Событие "Входящий звонок" включает 5 моментов для отправки оповещений. Каждый момент содержит список параметров доступных для передачи.

Передавая в CRM-систему информацию о принятых звонках, их можно сопоставить со сделками которые завели менеджеры. Таким образом, вы получаете дополнительный инструмент контроля отдела продаж и автоматизации работы в crm-системе.

Давайте детально рассмотрим моменты отправки оповещений и доступные параметры для каждого момента.

Отправка событий по звонкам Callback

Звонки Callback относятся к событию Входящий звонок, поэтому для отправки параметров нужно выбирать моменты, которые относятся к этому событию.

Отделить звонки вы можете ориентируясь на значение параметра Тип подмены:
- dynamic
- static
- callback

В данном файле описаны все параметры которые можно передавать событием "Входящий звонок"

Передача параметров пользователя

Для события Входящий звонок характерна передача параметров пользователя. Это может быть переменная в глобальной области видимости или статический параметр для идентификации приложения, переданный в URL-запроса.

1. Передача параметра custom

Чтобы передать параметр custom, нужно настроить отслеживаемые сущности на странице настроек коллтрекинга.

Допустим на сайте есть некая переменная url, укажем это в значении и введём понятное имя.

После создания и настройки сущности нужно перейти к добавлению в webhook.

В меню навигации выберите Интеграция -> Webhooks 2.0 и нажмите на Добавить событие.
В списке доступных параметров, выберите вашу сущность, она уже появится среди списка.

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"
}

Нашли ответ на свой вопрос?