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

get_conversation_messages

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

Paraméterek

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.

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 az összes beszélgetésben a szervezetedben üzenet tartalom vagy chat azonosító alapján.

Paraméterek

Hogyan működik

• Üzenet tartalomban keres az összes szervezeti beszélgetésben.
• 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) — ezután a get_conversation_messages-szel olvashatod a konkrét üzeneteket.

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.
• Keress beszélgetéseket, amelyek egy adott terméknevet említenek.
• 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

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

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

1. Hozzá nem rendelt beszélgetések listázása → list_records a table: "chats", category: "unassigned" beállítással
2. Legutóbbi üzenetek olvasása → get_conversation_messages
3. 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

1. Téma keresése → search_conversations
2. Beszélgetés olvasása → get_conversation_messages
3. 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.

Vizsgálat és dokumentálás

1. Probléma keresése → search_conversations
2. Beszélgetés olvasása → get_conversation_messages
3. AI hiba diagnosztizálása → diagnose_ai_response (a Chatbot eszközökből)
4. 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.