Webhooky
Kategorie Eventů
Sezení
Níže uvedený diagram popisuje veškeré události v rámci životního cyklu sezení od jeho vzniku až po ukončení. K přesměrování sezení na jiného operátora nemusí dojít a je uvedeno pouze pro úplnost.
Událost | Čas |
---|---|
SessionCreated | "2024-05-02T08:58:58:888364+02:00" |
SessionStarted | "2024-05-02T08:58:58:888364+02:00" |
SessionOperatorJoined | "2024-05-02T08:59:18:467643+02:00" |
SessionForwarded (volitelně) | "2024-05-02T09:02:26:568252+02:00" |
SessionEnded | "2024-05-02T09:13:07:965191+02:00" |
SessionOperatorLeft | "2024-05-02T09:13:07:965191+02:00" |
SessionOperatorConcluded | "2024-05-02T09:15:50:838056+02:00" |
SessionCreated
V tenantu byla vytvořeno nové sezení a událost se zaloguje ještě před přijetím sezení ze strany operátora či chatbota.
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
channel | string | |
source | string |
SessionStarted
Sezení začalo (např. klient vstoupil do fronty a hledá se pro něho volný operátor). Toto se týká všech kanálů v mluvii. S klientem může v sezení také komunikovat chatbot.
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
channel | string | |
source | string | |
started | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
SessionOperatorJoined
Děje se v momentě připojení operátora do sezení. Např. hned na začátku (po SessionCreated). Platí, že pro každého operátora v sezení se zaloguje vlastní událost.
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
userId | number | 2710 |
channel | string | |
source | string | |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
SessionForwarded
Sezení bylo přesměrováno. V tomto případě nejsou k dispozici žádné detaily jako je tomu v případě SessionActivitySessionForwarded.
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
channel | string | |
source | string | |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
userId | number | 2710 |
operatorGroupId | number | 7299 |
V odpovědi se může objevit "userId", "operatorGroupId", nebo "chatbotId" podle toho, na jaký cíl operátor přepojuje.
SessionEnded
Sezení bylo ukončeno.
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
channel | string | |
source | string | |
started | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
ended | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
SessionOperatorLeft
Jakmile operátor ukončí sezení (klikne na tlačítko "Ukončit"). Následně se dostane do ACW stavu.
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
userId | number | 2710 |
channel | string | |
source | string | |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
Pokud je v sezení aktivních více operátorů, pouze u jednoho z nich se zaloguje SessionOperatorLeft. Pro ostatní se zaloguje event SessionOperatorConcluded.
SessionOperatorConcluded
Děje se v momentě, kdy je automaticky/manuálně ukončeno ACW. Pak také v případě, kdy je sezení přesměrováno z operátora na další cíl (operátora/skupinu/chatbota/externí tel. číslo).
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
userId | number | 2710 |
channel | string | |
source | string | |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
Aktivity v Sezení
SessionActivityAutoActivity
Událost se loguje s každou automatickou zprávou v sezení. Může se jednat např. o automatickou zprávu zaslanou z důvodu neaktivity klienta či zaneprázdněním operátora, který odbavuje více interakcí najednou.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7215873 |
activityId | number | 50878507 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | AutoActivity |
text | string | "Jsme stále ve spojení?" |
SessionActivityAvResponse
Spustí se při reakci uživatele na pokus o AV spojení.
Vlastnost | Hodnota | Příklad |
---|---|---|
sessionId | number | 7361303 |
operatorId | number | 2710 |
response | Přijato |
Pokud klient přijme pozvánku do A/V hovoru, vrátí Public API hodnotu "Accepted" a v opačném případě "RejectedUser".
SessionActivityAvRequest
Událost zachycuje okamžik, kdy operátor povyšuje webchat na Audio/Video hovor. Operátor v rozhraní kliká na záložku "Volat", vstupuje do A/V místnosti a přizve klienta.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7215873 |
userId | number | 4555 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
SessionActivityAvTerminated
Děje se v případě, že operátor ukončí A/V hovor a dále pokračuje jen v textové komunikaci. Operátor kliká na tlačítko "Odpojit klienta" nebo křížkem v rohu A/V bladu.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7215873 |
userId | number | 4555 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
SessionActivityCallScript
Děje se vždy při navolávání každého kontaktu v rámci kampaně, kde je CallScript nastaven. CallScript nemusí být potvrzen operátorem.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7215873 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | CallScript |
callscript | array | struktura formuláře |
Webhook je doručen v okamžiku přijetí kampaňového sezení klientem.
SessionActivityCallScriptSubmission
V sezení je operátorem potvrzen nastavený CallScript. CallScript se využívá pouze u telefonních kampaní.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7215873 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | CallScriptSubmission |
client | string | Guest |
Webhook je doručen, jakmile skončí ACW sezení.
SessionActivityCobrowsingStarted
V sezení byl zahájen cobrowsing a klient odsouhlasil žádost od operátora.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7215873 |
activityId | number | 49717950 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | SessionActivityCobrowsingStarted |
client | string | Guest |
SessionActivityExternalMessage
Může se jednat o úvodní zprávu nastavenou na úrovni Facebook stránky, nebo o zprávy odesílané klientovi mimo aplikaci mluvii (přes Facebook Messenger).
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7215873 |
activityId | number | 49717950 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | ExternalMessage |
text | string | odpověď z Facebooku |
SessionActivityHeroCard
Během sezení byla odeslána HeroCard.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7215873 |
activityId | number | 49717950 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | HeroCard |
heroCard | array | struktura HeroCard |
client | string | User |
Parametr "client" může nabývat hodnot (User, Chatbot). V závislosti na tom je vyplněna také hodnota parametru "userId", nebo "chatbotId".
SessionActivityHeroCardSubmission
Zaloguje se při potvrzení/zrušení (submitted/cancelled) HeroCard.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
originalFormID | number | 3371 |
result | submitted | |
submittedByClient | bool | true |
params | string | |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
Parametr originalFormID označuje id existující HeroCard v mluvii.
V params jsou uloženy parametry použité v dané HeroCard společně se zadanými hodnotami (např. "oo1_guest_email", "oo1_guest_ident", "oo1_guest_phone").
Existují i případy, kdy HeroCard potvrdí operátor místo klienta. V takovém případě se uloží do parametru "submittedByClient" hodnota false.
SessionActivityChatToMail
Vyskytuje se v momentě, kdy klient zadá ve Výstupním formuláři e-mail a zašle si přepis, případně zašle přepis operátor.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | ChatToMail |
client | string | Guest |
Do parametru "client" se uloží hodnota Guest, pokud si přepis sezení pošle sám klient. Nebo se použíje hodnota User a parametr „userID", které je vyplněné pouze v případě, že iniciátorem akce je operátor.
SessionActivityLastFarewellMessage
Zaloguje se v případě, že je sezení automaticky ukončeno po 24 hodinách čekání ve frontě. Toto se týká zejména WhatsAppu. Můžete tuto událost sledovat i u Facebook Messenger sezení.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | LastFarewellMessage |
text | string | Omlouváme se, ale váš požadavek ... |
SessionActivityPreviewUrl
V sezení se objeví zpráva obsahující URL link.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | PreviewUrl |
client | string | User |
previewUrl | - | - |
.../title | string | Seznam - najdu tam, co neznám |
.../imageUrl | string | https://www.seznam.cz/media/... |
.../contentType | number | 1 |
.../originalUrl | string | https://www.seznam.cz/ |
.../originalActivityId | number | 114253 |
userId | number | 2004014 |
V závislosti na tom, která strana link odeslala se u parametru "Client" zaloguje hodnota "guest", "user" nebo "chatbot"., který se vykreslí (v obou případech se mění akorát parametry „Client“ (guest, user)). Pokud URL pošle operátor, vyplní se navíc userId.
SessionActivityOnHold
Operátor v průběhu tel. hovoru přidrží probíhající hovor (tlačítko "Přidržet hovor").
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | OnHold |
client | string | User |
userId | number | 2710 |
SessionActivityOperatorInviteCanceled
Operátor přizval jiného operátora do sezení a ještě před jeho připojením pozvánku zrušil. UserId označuje operátora, který pozvánku zrušil.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | OperatorInviteCanceled |
client | string | User |
userId | number | 2710 |
SessionActivityOperatorInvited
Operátor přizval jiného operátora do sezení. UserId označuje operátora, který poslal pozvánku.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | OperatorInvited |
client | string | User |
toOperatorUserId | number | 4301 |
toOperatorFullName | string | Jan Novák |
note | string | Prosím, připoj se. |
userId | number | 2710 |
SessionActivityOperatorInviteRejected
Operátor přizval jiného operátora do sezení a ten pozvání odmítl. UserId označuje operátora, který pozvánku odmítl.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | OperatorInviteRejected |
client | string | User |
userId | number | 2710 |
SessionActivityResumeGuest
Událost úzce souvisí s jinou údálostí (SessionActivityOnHold), která této předchází. Tentokrát operátor kliká na tlačítko "Pokračovat v hovoru".
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | ResumeGuest |
client | string | User |
userId | number | 2710 |
SessionActivitySessionEnded
Zaloguje se pokaždé, kdy skončí sezení.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | SessionEnded |
client | string | Guest |
userId | number | 2710 |
terminationReason | string |
Sezení může být ukončeno ze strany klienta či operátora (podle toho se do parametru client uloží hodnota "guest", "user"). Pokud je sezení ukončeno ze strany operátora, ukládá se jeho ID do parametru "userId".
SessionActivitySessionForwarded
Děje se při přepojování sezení ze strany operátora (userId) či chatbota (chatbotId). Pokud operátor (chatbot) přepojují na operátora, použije se parametr "toOperatorUserId" či "toOperatorFullName".
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | SessionForwarded |
client | string | User |
toOperatorUserId | number | 2710 |
toGroupId | number | 7229 |
Jestliže je sezení přepojené na skupinu operátorů, použije se parametr "toGroupId" či "toGroupName". Zajímavostí je, že při přepojení na chatbota se také použijí stejné parametry.
SessionActivitySharedFile
V rámci sezení je sdílený soubor (ze strany operátora či klienta).
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | SharedFile |
client | string | User |
userId | number | 2710 |
File | - | - |
.../id | number | 2635914 |
.../operatorOwner | number | 2710 |
.../departmentOwner | number | 62 |
.../name | string | obrazek |
Operátor může sdílet vlastní či společný (v tenantu) nahraný soubor. To poznáte podle parametrů "operatorOwner" a "departmentOwner". Pokud operátor nasdílí soubor ze svého dísku, oba zmíněné parametry budou prázdné.
Sdílet soubor může také klient, pokud ho k tomu vyzve operátor. V takovém případě se v parametru "client" objeví hodnota "Guest".
SessionActivitySharedScreen
Jde o sdílení obrazovky buď ze strany klienta, nebo operátora.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | SharedScreen |
client | string | User |
userId | number | 2710 |
Parametr "client" nabývá hodnot Guest, nebo User. Pokud sdílí obrazovku operátor, uloží se také jeho id do parametru userId.
SessionActivityWelcomeMessage
V rámci sezení se objevila uvítací zpráva.
Parametr | Hodnota | Příklad |
---|---|---|
sessionId | number | 7273902 |
activityId | number | 50108494 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
type | string | WelcomeMessage |
text | string | Dobrý den, vítejte na chatu. |
userId | number | 2710 |
SessionCallParamsUpdated
Zaloguje se při každé změně parametru sezení a nezáleží na tom, kdo změnu provádí (operátor, chatbot, nebo supervizor po skončení sezení).
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
E-maily
EmailThreadCreated
Webhook je doručen při vytvoření noveho emailového vlákna. Buď jej zahájí client, nebo operátor.
Vlastnost | Hodnota | Příklad |
---|---|---|
id | number | 742633 |
created | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
tenantId | number | 62 |
Tato událost se zaloguje i v případě forwardu e-mailu (přeposlání na jinou e-mailovou adresu) ze strany operátora.
EmailThreadOperatorJoined
Webhook je doručen, jakmile operátor přijme e-mailovou zprávu ze společné fronty.
Vlastnost | Hodnota | Příklad |
---|---|---|
id | number | 742633 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
userId | number | 2710 |
tenantId | number | 62 |
EmailThreadOperatorLeft
Spustí se při odpojení operátora od e-mail vlákna (operátor odpoví na e-mail, vrátí jej do fronty ke zpracování, nebo e-mail ignoruje).
Vlastnost | Hodnota | Příklad |
---|---|---|
id | number | 742633 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
userId | number | 2710 |
tenantId | number | 62 |
EmailThreadForwarded
Spustí se při přesměrování e-mailového vlákna.
Vlastnost | Hodnota | Příklad |
---|---|---|
id | number | 742633 |
time | datetime | yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ |
userId | number | 2710 |
operatorGroupId | number | 388 |
tenantId | number | 62 |
Společně s tímto eventem se zaloguje také EmailThreadOperatorLeft (původní operátor se odpojí).
EmailThreadParamsUpdated
Spustí se při přidání parametru k e-mailovému vláknu operátorem, nebo pomocí Public API.
Vlastnost | Hodnota | Příklad |
---|---|---|
id | number | 742633 |
tenantId | number | 62 |
Ostatní
ApplicationSettingChanged
Zaloguje se při jakékoli změně nastavení tenantu (tenant/Aplikace/Všeobecné).
Parametr | Hodnota | Příklad |
---|---|---|
name | string | |
companyId | number | 1 |
departmentId | number | 62 |
Pro každou změnu provedenou v nastavení tenantu, vrátí Public API 18 odpovědí.
GuestIdentityUpdated
Spustí se po editaci informací u klienta. id (níže) označuje id záznamu v Adresáři kontaktů.
Vlastnost | Hodnota | Příklad |
---|---|---|
id | number | 345229 |
tenantId | number | 62 |
SessionRecordingPostProcessingCompleted
Zpracování Audio/Video nahrávky po skončení sezení bylo dokončeno.
Parametr | Hodnota | Příklad |
---|---|---|
id | number | 7293902 |
tenantId | number | 62 |
UserStatusChanged
Spustí se při změně stavu operátora.
Vlastnost | Hodnota | Příklad |
---|---|---|
userId | number | 2710 |
status | ONLINE | |
availabilityStatus | DEFAULT | |
availabilityStatusReason | string | null |
Výčtové typy
HeroCardSubmissionResult
Hodnota | Popis |
---|---|
Submitted | Údaje potvrzeny |
Cancelled | Vyplnění hero karty zrušeno |
GetMediaResult
Hodnota | Popis |
---|---|
Success | Úspěšný přenos |
NoCameraOnlyMic | Pouze mikrofon |
NoDevices | Žádná zařízení pro přenos audio/video |
UserDenied | Uživatel nepovolil audio/video zařízení |
SessionAVRequestState
Hodnota | Popis |
---|---|
Requested | Vyžádáno |
Accepted | Přijato |
RejectedUser | Odmítnuto uživatelem |
RejectedNoMic | Uživatel nemá mikrofon |
Zdroj sezení
Hodnota | Popis |
---|---|
Default | WebChat |
Callback | Callback |
Invitation | Pozvánka |
IncomingCall | Příchozí hovor |
OutgoingCall | Odchozí hovor |
Campaign | Kampaň |
API | Public API |
VK | VKontakte |
Apple | Apple Messages for Business |
Kanál sezení
Hodnota | Popis |
---|---|
AV | Audio video přenos |
Chat | Textový kanál |
Phone | Telefonní hovor |
Stav operátora
Hodnota | Popis |
---|---|
OFFLINE | Odhlášený |
ONLINE | Dostupný |
AWAY | Nedostupný |
Stav dostupnosti
Hodnota | Popis |
---|---|
DEFAULT | Online |
AWAY | Pryč |
ON_CALL | AV nebo telefonní hovor |
Důvod ukončení
Hodnota | Popis |
---|---|
GuestLeft | Klient se odpojil |
OperatorLeft | Operátor se odpojil |
ChatbotLeft | Chatbot se odpojil |
Všeobecné nastavení
Hodnota | Popis |
---|---|
GuestPreview | Náhled čekajícího klienta |
PhoneNumberBlockMinutes | Délka blokace stejného čísla u CMB widgetu |
widgetStateWhenAway | Stav balíčku při stavu pryč |
emailTranscriptFrom | Adresát odpovědi na přepis konverzace |
emailTranscriptFromVisibility | Odpovědi na přepis konverzace (e-mail operátora či e-mail společnosti) |
allowOfflinePhoneCalls | Povolit offline callback |
deleteSessionFiles | Smazat soubory po ukončení sezení |
guestInfinityChat | Historie chatu u klienta |
operatorCanBan | Banování klientů operátorem |
recordSession | Nahrávání AV sezení |
autoAnonymizeSessions | Automatická anonymizace starých sezení (ve dnech |
guestUploadFiles | Odesílání souborů na straně klienta |
guestDisconnectedTime | Délka odpojení klienta (v minutách) |
operatorCanChooseCallerId | Výběr odchozího telefonního čísla u operátora |
showRoutedOperators | Zobrazovat přiřazené operátory |
emailRoutingRequestThrottlingPrecedence | Řazení a přiřazování e-mailů |
Last updated