Wydarzenie "Połączenie przychodzące" obejmuje 5 momentów wysyłania powiadomień. Każdy moment zawiera listę dostępnych parametrów przekazywania.
Przekazując do systemu CRM informacje o odebranych połączeniach, można je porównać z umowami, które założyli menedżerowie. W ten sposób otrzymujemy dodatkowe narzędzie kontroli działu sprzedaży oraz automatyzacji pracy w systemie CRM.
Przyjrzyjmy się szczegółowo momentom wysyłania powiadomień oraz dostępnym parametrom dla każdego z momentów.
Wysyłanie wydarzeń dla połączeń Callback
Połączenia typu Callback należą do wydarzenia „Połączenie przychodzące”, dlatego przy wysyłaniu parametrów należy wybierać momenty odpowiadające właśnie temu wydarzeniu.
Rozróżnienie połączeń jest możliwe poprzez wartość parametru Typ podstawienia:
dynamic
static
callback
W tym pliku opisane są wszystkie parametry, które można przekazywać w ramach wydarzenia „Połączenie przychodzące”.
Przekazywanie parametrów użytkownika
Dla wydarzenia „Połączenie przychodzące” charakterystyczne jest przekazywanie parametrów użytkownika. Może to być zmienna w globalnym zakresie widoczności albo statyczny parametr służący do identyfikacji aplikacji, przesyłany w zapytaniu URL.
1. Przekazywanie parametru custom
Aby przekazać parametr custom, należy skonfigurować śledzone jednostki na stronie ustawień calltrackingu.
Przykładowo, jeśli na stronie istnieje zmienna url, można wskazać ją jako wartość oraz nadać jej zrozumiałą nazwę.
Po utworzeniu i skonfigurowaniu jednostki można przejść do jej dodania w webhooku.
W menu nawigacji proszę wybrać Integracja -> Webhooks 2.0, przejść do odpowiedniego webhooka i kliknąć Dodaj parametr.
Na liście dostępnych parametrów należy wybrać skonfigurowaną jednostkę – pojawi się ona od razu na liście.
2. Przekazywanie parametru statycznego
Mogą Państwo również przekazać parametr statyczny wraz z powiadomieniem. W większości przypadków używa się go wyłącznie do identyfikacji aplikacji, z której wysyłane jest powiadomienie.
Uwaga: parametr statyczny można przekazać wyłącznie metodą GET w adresie URL obsługującego.
W oknie ustawień zapytania Webhook należy przejść do pola Kierunek i dodać parametry statyczne do przekazania.
Na przykładzie przedstawiono przekazanie dwóch parametrów statycznych: source oraz service.
Uwaga: metoda wysyłania danych nie ma znaczenia, ponieważ parametry i ich wartości są zapisane w adresie URL, na który wysyłane jest powiadomienie.
Ważne: nazwa parametru musi być zapisana alfabetem łacińskim i bez spacji. W przeciwnym wypadku przekazanie danych nie będzie poprawne. Jeśli wymagana jest nazwa parametru zapisana cyrylicą i/lub ze spacjami, należy ją ująć w nawiasy klamrowe, np. {{nazwa parametru}}.
3. Przykład przetworzonych parametrów w formacie JSON, przekazanych w momencie odpowiedzi.
{
"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"