Webhook - Skierowanie połączenia do agenta
Webhook PhoneCallAttempted informuje o skierowaniu połączenia do agenta w systemie Welyo. Zdarzenie jest generowane w momencie przekazania połączenia do obsługi przez konkretnego agenta.
W panelu Welyo zdarzenie to odpowiada operacji: Skierowanie połączenia do agenta
Webhook może być wykorzystywany m.in. do:
- rejestrowania prób połączeń kierowanych do agentów w systemach zewnętrznych,
- synchronizacji danych o ruchu połączeń z systemami CRM,
- uruchamiania automatycznych procesów w momencie przekazania połączenia agentowi.
Struktura zdarzenia
Webhook zawiera podstawowe informacje o zdarzeniu oraz dane dotyczące połączenia skierowanego do agenta.
Parametry główne
| Pole | Opis |
|---|---|
| eventName | Nazwa zdarzenia webhooka informująca o skierowaniu połączenia do agenta |
| 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 PhoneCallAttempted
| Pole | Opis |
|---|---|
| campaignId | Identyfikator kampanii powiązanej z połączeniem |
| callsId | Identyfikator połączenia |
| userId | Identyfikator agenta, do którego skierowano połączenie |
| recordsId | Identyfikator rekordu powiązanego z połączeniem; jeśli brak rekordu, zwracana jest wartość null |
| number | Numer telefonu powiązany z połączeniem |
| field | Pole znaczące rekordu; jeśli brak rekordu, zwracany jest pusty ciąg znaków |
Przykładowy webhook
{
"eventName": "PhoneCallAttempted",
"fccInstance": "vcc1a",
"customerId": 12345,
"version": 1,
"createdAt": "2020-08-25T08:46:41+02:00",
"data": {
"campaignId": 321,
"callsId": 1832476,
"userId": 604,
"recordsId": null,
"number": "222289289",
"field": ""
}
}