Webhook - Odebranie połączenia przez klienta lub agenta

Webhook PhoneCallConnected informuje o nawiązaniu połączenia pomiędzy agentem a klientem. Zdarzenie jest generowane w momencie odebrania połączenia przez jedną ze stron – klienta lub agenta.

W panelu Welyo zdarzenie to odpowiada operacji: Odebranie połączenia przez klienta lub agenta

Webhook może być wykorzystywany m.in. do:

synchronizacji informacji o rozpoczęciu rozmowy z systemami zewnętrznymi,
uruchamiania procesów biznesowych po odebraniu połączenia,
rejestrowania zdarzeń związanych z obsługą połączeń w systemach CRM lub analitycznych.

Struktura zdarzenia

Webhook zawiera podstawowe informacje o zdarzeniu oraz dane dotyczące nawiązanego połączenia.

Parametry główne

Pole	Opis
eventName	Nazwa zdarzenia webhooka informująca o nawiązaniu połączenia
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 PhoneCallConnected

Pole	Opis
campaignId	Identyfikator kampanii powiązanej z połączeniem
callsId	Identyfikator połączenia
recordsId	Identyfikator rekordu powiązanego z połączeniem; jeśli połączenie nie jest powiązane z rekordem, zwracana jest wartość null
extId	Zewnętrzny identyfikator rekordu (external_id), jeśli został przekazany
agentId	Identyfikator agenta obsługującego połączenie
src	Numer źródłowy połączenia
dst	Numer docelowy połączenia
callType	Typ połączenia (inbound - przychodzące lub outbound - wychodzące)

Przykładowy webhook

{
"eventName": "PhoneCallConnected",
"fccInstance": "vcc1a",
"customerId": 12345,
"version": 1,
"createdAt": "2020-08-25T08:37:03+02:00",
"data": {
"callsId": "1832473",
"campaignId": "321",
"agentId": 604,
"src": "222289289",
"dst": "222289289",
"recordsId": null,
"extId": null,
"callType": "inbound"
}
}