Webhooky

Kategorie Eventů

• Sezení

• Aktivity v Sezení

• E-maily

• Ostatní

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	kanál sezení
zdroj	string	zdroj sezení

Kompletní JSON:

{
  "eventType": "SessionCreated",
  "data": {
    "id": 7371450,
    "tenantId": 62,
    "channel": "Phone",
    "source": "OutgoingCall"
  }
}

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	kanál sezení
source	string	zdroj sezení
started	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ

Kompletní JSON:

{
  "eventType": "SessionStarted",
  "data": {
    "id": 7371450,
    "tenantId": 62,
    "channel": "Phone",
    "source": "OutgoingCall",
    "started": "2024-05-02T16:05:24.454661+02:00"
  }
}

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	kanál sezení
source	string	zdroj sezení
time	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ

Kompletní JSON:

{
  "eventType": "SessionOperatorJoined",
  "data": {
    "id": 7371450,
    "tenantId": 62,
    "userId": 4,
    "channel": "Phone",
    "source": "OutgoingCall",
    "time": "2024-05-02T16:05:24.454661+02:00"
  }
}

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	kanál sezení
source	string	zdroj sezení
time	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ
userId	number	2710
operatorGroupId	number	7299

Kompletní JSON

{
  "eventType": "SessionForwarded",
  "data": {
    "id": 7373420,
    "tenantId": 62,
    "channel": "Chat",
    "source": "Default",
    "time": "2024-05-03T09:41:31.257306+02:00",
    "userId": null,
    "operatorGroupId": 7299,
    "chatbotId": null
  }
}

SessionEnded

Sezení bylo ukončeno.

Parametr	Hodnota	Příklad
id	number	7293902
tenantId	number	62
channel	string	kanál sezení
source	string	zdroj sezení
started	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ
ended	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ

Kompletní JSON:

{
  "eventType": "SessionEnded",
  "data": {
    "id": 7363963,
    "tenantId": 62,
    "channel": "Chat",
    "source": "Default",
    "started": "2024-04-30T13:32:31.105138+02:00",
    "ended": "2024-05-02T15:34:12.871976+02:00"
  }
}

SessionOperatorLeft

Jakmile operátor ukončí sezení (klikne na tlačítko "Ukončit"). Následně se dostane do ACW stavu. Pokud je v sezení aktivních více operátorů, pouze u jednoho z nich se zaloguje SessionOperatorLeft. Pro ostatní se zaloguje event SessionOperatorConcluded.

Parametr	Hodnota	Příklad
id	number	7293902
tenantId	number	62
userId	number	2710
channel	string	kanál sezení
source	string	zdroj sezení
time	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ

Kompletní JSON:

{
  "eventType": "SessionOperatorLeft",
  "data": {
    "id": 7371193,
    "tenantId": 62,
    "userId": 4301,
    "channel": "AV",
    "source": "Invitation",
    "time": "2024-05-02T15:32:52.539588+02:00"
  }
}

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	kanál sezení
source	string	zdroj sezení
time	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ

Kompletní JSON:

{
  "eventType": "SessionEnded",
  "data": {
    "id": 7363963,
    "tenantId": 62,
    "channel": "Chat",
    "source": "Default",
    "started": "2024-04-30T13:32:31.105138+02:00",
    "ended": "2024-05-02T15:34:12.871976+02:00"
  }
}

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
time	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ
type	string	AutoActivity
text	string	"Jsme stále ve spojení?"

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

Struktura formuláře:

[

{"inputType": "RichText",

"label": "<p>byt</p>", "ordinal": 1

},

{"inputType": "Text",

"label": "dispozice",

"key": "Dispozice",

"required": true,

"ordinal": 2

},

{"InputType": "Radio",

"label": "centrum", "key": "somethingelse",

"required": true, "ordinal": 3,

"choiceOptions":[

{"value": "ano",

"label": "ano"},

{"value": "ne",

"label": "ne"}]

}

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

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

Struktura HeroCard může v parametru "heroCard" může vypadat následovně:

[

{"inputType": "RichText",

"label": "<p>byt</p>", "ordinal": 1

},

{"inputType": "Text",

"label": "dispozice",

"key": "Dispozice",

"required": true,

"ordinal": 2

},

{"InputType": "Radio",

"label": "centrum", "key": "somethingelse",

"required": true, "ordinal": 3,

"choiceOptions":[

{"value": "ano",

"label": "ano"},

{"value": "ne",

"label": "ne"}]

}

SessionActivityHeroCardSubmission

Zaloguje se při potvrzení/zrušení (submitted/cancelled) HeroCard.

Pokud ji vyplní uživatel, použije se hodnota true, pokud ji vyplní operátor, tak false.

Parametr	Hodnota	Příklad
sessionId	number	7273902
originalFormID	number	3371
result	HeroCardSubmissionResult	submitted
submittedByClient	bool	true
params	string
time	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ

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").

SessionActivityChatToMail

Vyskytuje se v momentě, kdy klient zadá ve Výstupním formuláři e-mail a zašle si přepis, případně operátor zašle přepis (mění se pouze parametry „Client“ (Guest, User) a „userID", které je vyplněné pouze v případě, že iniciátorem akce je 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

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.

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.

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

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í. 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.

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	Důvod ukončení

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 toOperatorUserName.

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í parametry toGroupId nebo toGroupName.

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	string	7229

SessionActivitySharedFile

SessionActivitySharedScreen

Jde o sdílení obrazovky buď ze strany klienta, nebo operátora. Parametr "client" nabývá hodnot Guest, nebo User. Pokud sdílí obrazovku operátor, uloží se také jeho id do parametru userId.

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

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

Spustí se při vytvoření noveho email vlakna buďto napise client nebo operator.

Vlastnost	Hodnota	Příklad
id	number	742633
created	datetime	yyyy-MM-dd'T'HH:mm:ss,SSSZZZZ
tenantId	number	62

EmailThreadOperatorJoined

Spustí se, když operátor vstoupí do e-mail vlákna.

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.

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

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

SessionActivityAvResponse

Spustí se při reakci uživatele na pokus o AV spojení.

Vlastnost	Hodnota	Příklad
sessionId	number	7361303
operatorId	number	2710
response	SessionAVRequestState	Přijato

SessionActivityAvMediaResult

Spustí se při navázání AV spojení.

Vlastnost	Hodnota	Příklad
sessionId	number	7361303
operatorId	number	2710
isStreamAvailable	bool
response	GetMediaResult	Success

Ostatní

ApplicationSettingChanged

Zaloguje se při jakékoli změně nastavení tenantu (tenant/Aplikace/Všeobecné).

Parametr	Hodnota	Příklad
name	string	všeobecné nastavení
companyId	number	1
departmentId	number	62

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	Stav operátora	ONLINE
availabilityStatus	Stav dostupnosti operátora	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
Facebook	Facebook
WhatsApp	WhatsApp
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ů