Beszélgetés eszközök

Áttekintés

A Beszélgetés eszköz kategória teljes hozzáférést biztosít az élő chat inboxodhoz. Olvashatod az üzenet előzményeket, kereshetsz beszélgetések tartalmában, hozzárendelhetsz vagy áthelyezhetsz chateket ügyintézők között, és üzeneteket küldhetsz (beleértve a privát belső jegyzeteket).

Szükséges jogosultság:Inbox

Adatvédelmi megjegyzés: A külső hívók (OAuth hitelesítés) csak a NYILVÁNOS üzeneteket láthatják. A privát ügyintézői jegyzeteket a külső hozzáférés elől elrejtjük — kimaradnak a keresési találatokból és a beszélgetés utolsó üzenetének előnézetéből is. A Copilot az irányítópulton és az API-kulcsos kapcsolatok megtekinthetik és létrehozhatják a privát jegyzeteket; az OAuth-kapcsolatok nem.

A widgetenkénti hozzáférés itt is érvényes. Ha a fiókod csak bizonyos widgetekre korlátozódik, az oldalon szereplő minden eszköz tiszteletben tartja ezt a korlátot — csak azoknak a widgeteknek a beszélgetéseit olvashatod, keresheted, rendelheted át és válaszolhatod meg, amelyekhez hozzáférésed van, pontosan úgy, mint a Beérkezett üzenetekben. A tulajdonosokra és adminokra ez nem vonatkozik, a hanghívások pedig láthatók maradnak, mivel nem tartoznak widgethez.

get_conversation_messages

Üzenetek lekérése egy adott beszélgetésből időrendi sorrendben.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`chatId`	string	Igen	A beszélgetés azonosító, amelyből az üzeneteket olvasod.
`offset`	number	Nem	Lapozási eltolás. Alapértelmezés: 0.
`limit`	number	Nem	Lekérendő üzenetek száma. Alapértelmezés: 40, max: 200.

Hogyan működik

Az üzenetek időrendi sorrendben kerülnek visszaadásra (legrégebbi először).
Minden üzenet tartalmazza a tartalmát, időbélyegét, feladó információit, és hogy nyilvános üzenet vagy privát ügyintézői jegyzet.
Az AI chatbot üzenetek egyértelműen azonosítva vannak, megkönnyítve a diagnose_ai_response-nak átadandó üzenetek megtalálását.
Visszaadja az összes üzenetszámot a lapozáshoz.
A beszélgetésnek a szervezetedhez kell tartoznia, és egy olyan widgethez, amelyhez hozzáférésed van.

Példa promptok

Mutasd meg az üzeneteket ebben a beszélgetésben. (a chat azonosítása után list_records-szal vagy search_conversations-szel)
Mit mondott az ügyfél a legutóbbi chatben?
Olvasd el az utolsó 100 üzenetet az X beszélgetésből.
Mutasd meg a régebbi üzeneteket ebben a chatben — 2. oldal.
Keresd meg az AI chatbot válaszait ebben a beszélgetésben. (a chatbot_id-vel rendelkező üzeneteket keresi)

search_conversations

Keresés a szervezeted beszélgetéseiben üzenet tartalom, az érintett személy, a hozzárendelt ügyintéző vagy beszélgetés azonosító alapján.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`query`	string	Igen	Keresési szöveg (1–200 karakter).
`searchType`	string	Nem	Mit keressen. `"message"` (alapértelmezés), `"visitor"`, `"agent"` vagy `"chat_id"`.
`limit`	number	Nem	Maximum eredmények. Alapértelmezés: 25, max: 100.

Keresési típusok

Típus	Mire illeszkedik
`message`	Teljes szöveges keresés az üzenetek tartalmában. Ez az alapértelmezés.
`visitor`	A személy neve, e-mail címe, felhasználóneve, telefonszáma vagy látogató azonosítója.
`agent`	A hozzárendelt ügyintéző e-mail címe vagy felhasználóneve.
`chat_id`	Beszélgetés azonosító előtag szerint — hasznos, ha csak az azonosító egy része van meg.

Nem kell eltalálnod a megfelelő típust. Ha az alapértelmezett message típussal keresel, de a szöveged úgy néz ki, mint egy beszélgetés azonosító eleje, automatikusan azonosítóként illeszkedik — és ha az nem talál semmit, visszaesik az üzenetek tartalmában való keresésre.

Hogyan működik

Az eredmények a legutóbbi frissítés szerint rendezve érkeznek, így a legrelevánsabb friss beszélgetések jönnek elöl.
Minden válasz tartalmazza a total (összesen hány beszélgetés illeszkedett) és a returned (hány szerepel ebben az oldalban) értéket, így tudod, hogy mindent látsz-e.
Csak valódi beszélgetésekben keres. Az üres rekordok, amelyeket a widget minden új látogatóhoz létrehoz, soha nem kerülnek vissza.
A külső hívók (OAuth) csak nyilvános üzenetekben keresnek — a privát ügyintézői jegyzetek kizárásra kerülnek.
Egyező beszélgetéseket ad vissza (nem egyedi üzeneteket), mindegyiknél a látogató nevével és e-mail címével, az utolsó üzenettel, a csatornával, az állapottal és az időbélyegekkel — ezután a get_conversation_messages-szel olvashatod a teljes beszélgetést.

Példa promptok

Keress beszélgetéseket a visszatérítésekről.
Keress chateket, ahol valaki a „számlázási probléma”-t említette.
Keresd meg az összes beszélgetést a [email protected] címmel. (a searchType: "visitor" beállítást használja)
Melyik beszélgetéseket kezeli Sarah? (a searchType: "agent" beállítást használja)
Keress egy abc123-mal kezdődő azonosítójú beszélgetést.
Keress beszélgetéseket jelszó visszaállítási problémákról.

assign_conversation

Beszélgetés hozzárendelése egy adott ügyintézőhöz, áthelyezés ügyintézők között, vagy hozzárendelés megszüntetése.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`chatId`	string	Igen	A hozzárendelendő beszélgetés.
`agentId`	string vagy null	Igen	Az ügyintéző felhasználó azonosítója. Adj meg `null`-t a hozzárendelés megszüntetéséhez.

Hogyan működik

Hozzárendelés/áthelyezés:

A célzott ügyintézőnek a szervezeted tagjának kell lennie.
Egy rendszerüzenet kerül hozzáadásra a beszélgetéshez az áthelyezés jelzésére.
A beszélgetés hozzárendelt ügyintézője frissül.

Hozzárendelés megszüntetése:

Eltávolítja a hozzárendelt ügyintézőt a beszélgetésből.
A beszélgetés a „Hozzá nem rendelt” inbox kategóriába kerül.

Példa promptok

Rendeld hozzám ezt a beszélgetést.
Helyezd át a chatet János ügyintézőhöz. (először meg kellene találni János felhasználó azonosítóját)
Szüntesd meg ennek a beszélgetésnek a hozzárendelését, hogy bárki felvehesse.
Helyezd át az összes hozzá nem rendelt chatet az inboxomba. (listázza a hozzá nem rendelt chateket, majd egyenként hozzárendeli)
Helyezd át ezt a beszélgetést a szupport csapatvezetőhöz.

send_conversation_message

Szöveges üzenet küldése egy beszélgetésben az aktuális ügyintézőként.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`chatId`	string	Igen	A beszélgetés, amelyben az üzenetet küldöd.
`message`	string	Igen	A küldendő üzenet szövege.
`visibility`	string	Nem	`"PUBLIC"` (alapértelmezés) — a látogató számára látható. `"PRIVATE"` — belső ügyintézői jegyzet, csak ügyintézők számára látható.
`sendAsEmail`	boolean	Nem	Az üzenet e-mailként is elküldésre kerül a látogatónak. Alapértelmezés: `false`.

Hogyan működik

Felhasználói munkamenetet igényel (munkamenet vagy OAuth).
Nyilvános üzenetek valós időben kerülnek kézbesítésre a látogatónak a chat widgeten keresztül.
Privát jegyzetek csak más ügyintézők számára láthatók az irányítópulton — a látogató soha nem látja őket.
E-mail kézbesítés: sendAsEmail: true esetén az üzenet e-mailként is elküldésre kerül a látogató e-mail-címére (ha ismert).
A külső hívók nem hozhatnak létre privát jegyzeteket.

Példa promptok

Válaszolj az ügyfélnek: „Köszönjük, hogy felvetted velünk a kapcsolatot! Azonnal utánanézek.”
Küldj üzenetet az X beszélgetésben: „A visszatérítésed feldolgozásra került, és 3-5 munkanapon belül megjelenik.”
Adj hozzá egy privát jegyzetet ehhez a beszélgetéshez: „Az ügyfél vállalati csomagot használ, prioritásként kezelendő.”
Válaszolj a látogatónak és küldd el e-mailként is.
Küldj egy privát jegyzetet: „Egyeztettem a számlázási csapattal — visszatérítés jóváhagyva.”

Általános munkafolyamat minták

Inbox szelektálás

Hozzá nem rendelt beszélgetések listázása → list_records a table: "chats", category: "unassigned" beállítással
Legutóbbi üzenetek olvasása → get_conversation_messages
Hozzárendelés a megfelelő ügyintézőhöz → assign_conversation

Példa prompt: Mutasd meg az összes hozzá nem rendelt beszélgetést, olvasd el a legutóbbi üzeneteket mindegyikben, és rendeld hozzám a számlázással kapcsolatosakat.

Keresés és válaszolás

Téma keresése → search_conversations
Beszélgetés olvasása → get_conversation_messages
Válasz küldése → send_conversation_message

Példa prompt: Keress beszélgetéseket a „visszatérítés”-ről, mutasd a legutóbbit, és küldj egy választ, hogy a visszatérítés feldolgozásra került.

Egy ügyfél előzményeinek követése

Keress meg mindent egy személytől → search_conversations a searchType: "visitor" beállítással
Olvasd el az egyes beszélgetéseket → get_conversation_messages

Példa prompt: Keresd meg az összes beszélgetést, amit a [email protected] címmel folytattunk, és foglald össze, milyen ügyekben keresett minket.

Vizsgálat és dokumentálás

Probléma keresése → search_conversations
Beszélgetés olvasása → get_conversation_messages
AI hiba diagnosztizálása → diagnose_ai_response (a Chatbot eszközökből)
Tudáshiány pótlása → manage_chatbot_document (a Chatbot eszközökből)

Példa prompt: Keress beszélgetéseket, ahol a chatbot nem tudott válaszolni, diagnosztizáld a problémát, és hozz létre egy dokumentumot a tudáshiány pótlásához.