Webhook - Powiadomienie o nieodebranym połączeniu
Webhook UnansweredByAgentCall informuje o sytuacji, w której połączenie nie zostało odebrane przez żadnego agenta w systemie Welyo. Zdarzenie jest generowane po zakończeniu próby obsługi połączenia przychodzącego w kampanii.
W panelu Welyo zdarzenie to odpowiada operacji: Powiadomienie o nieodebranym połączeniu
Webhook może być wykorzystywany m.in. do:
- rejestrowania nieodebranych połączeń w systemach CRM,
- uruchamiania automatycznych procesów, np. oddzwonienia do klienta,
- analizy dostępności agentów i skuteczności obsługi połączeń.
W zdarzeniu zwracana jest lista agentów oraz kolejek, do których kierowane było połączenie. Agenci są uwzględniani w liście nawet wtedy, gdy wystąpił status FAILED podczas próby zestawienia połączenia (np. gdy agent zgłosił gotowość w kampanii, ale jego aplikacja do odbierania połączeń została zamknięta).
Jeżeli agent był zajęty i połączenie nie mogło zostać fizycznie skierowane do niego, jego login nie pojawi się w liście dst . Jeśli wszyscy agenci byli zajęci lub niedostępni, listy dst i queues mogą być puste.
Struktura zdarzenia
Webhook zawiera podstawowe informacje o zdarzeniu oraz dane dotyczące nieodebranego połączenia.
Parametry główne
| Pole | Opis |
|---|---|
| eventName | Nazwa zdarzenia webhooka informująca o nieodebranym połączeniu |
| fccInstance | Identyfikator instancji systemu(nazwa środowiska) |
| customerId | Identyfikator klienta w systemie Welyo |
| version | Wersja struktury webhooka |
| createdAt | Data i czas wygenerowania zdarzenia |
| data | Obiekt zawierający szczegółowe dane dotyczące zdarzenia |
Struktura pola data dla zdarzenia UnansweredByAgentCall
| Pole | Opis |
|---|---|
| recordsId | Identyfikator rekordu powiązanego z połączeniem |
| callsId | Identyfikator połączenia |
| campaignId | Identyfikator kampanii |
| endTime | Data i czas zakończenia połączenia |
| src | Numer źródłowy połączenia |
| dst | Lista loginów agentów, do których kierowane było połączenie, ale nie zostało odebrane |
| queues | Lista nazw kolejek, przez które przechodziło połączenie |
Przykładowy webhook
{
"eventName": "UnansweredByAgentCall",
"fccInstance": "vcc1a",
"customerId": 12345,
"version": 2,
"createdAt": "2020-06-09T09:26:15+02:00",
"data": {
"callsId": "1832473",
"campaignId": "321",
"recordsId": 21052305,
"endTime": "2020-08-25T08:37:31+02:00",
"src": "222289289",
"dst": ["login_Agent_A", "login_Agent_B"],
"queues": ["Kolejka_A", "Kolejka_B"]
}
}