Усі колекції
API та Webhooks
Webhooks
Webhooks. Подія "Вхідний дзвінок"
Webhooks. Подія "Вхідний дзвінок"
Mariia Lobchenko avatar
Автор: Mariia Lobchenko
Оновлено протягом останнього тижня

Подія "Вхідний дзвінок" включає 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"

Ви отримали відповідь на своє запитання?