Adathozzáférési eszközök

Áttekintés

Az adathozzáférési eszközök minden munkafolyamat alapját képezik. Mielőtt frissíthetnél egy widgetet, szerkeszthetnél egy chatbotot vagy ellenőrizhetnéd a kampány statisztikákat, általában először meg kell találnod az erőforrást. Ez a két eszköz csak olvasási hozzáférést biztosít a szervezeted minden erőforrás típusához.

list_records

Listázza egy adott erőforrás típus rekordjait a szervezetedben. Minden rekordhoz összefoglaló nézetet ad vissza (nem teljes részleteket — arra a get_record való).

Paraméterek

Elérhető erőforrás típusok

Táblák és hibajegyek

Csak valódi beszélgetések

Ugyanez a logika érvényes a látogatókra is. A visitors listázása azokat az embereket adja vissza, akik ténylegesen beszélgettek veled, a legutóbbi beszélgetésük szerint rendezve. Állítsd be az includeAnonymous: true értéket, ha valóban a nyers oldalforgalomra van szükséged — ez a helyes választás közönség- és analitikai kérdésekhez, és utolsó aktivitás szerint rendez.

Mit kapsz vissza

A beszélgetések a legutóbbi frissítés szerint rendezve érkeznek, és minden válasz két számlálót is tartalmaz:

• total — összesen hány beszélgetés felel meg a szűrőidnek
• returned — hány szerepel ebben az oldalban

Minden beszélgetés rekord tartalmazza a látogató nevét, e-mail címét és országát, az utolsó üzenet szövegét, a csatornát, amelyen érkezett, a widget nevét, az e-mail tárgyát (e-mail beszélgetéseknél), a létrehozási és frissítési időbélyeget, valamint a hozzárendelt ügyintézőt — így ritkán van szükséged további lekérésre csak azért, hogy kiderítsd, kivel folyik a beszélgetés.

Új aktivitás figyelése

Ha úgy szeretnéd szemmel tartani a beérkezett üzeneteket, hogy ne kelljen minden alkalommal az egész listát újraolvasnod, jegyezd meg a legfrissebb updated_at értéket, amit láttál, és add vissza updatedSince paraméterként a következő híváskor. Csak azt kapod meg, ami ténylegesen változott.

A különbség drámai egy forgalmas szervezetnél: a teljes beszélgetéslista több tízezer rekord is lehet, míg ugyanaz a hívás egy órával ezelőttre állított updatedSince értékkel jellemzően csak néhányat ad vissza.

Hogyan működik

• A rekordok létrehozási dátum szerint rendezve kerülnek visszaadásra (legújabb először), kivéve a beszélgetéseket (utolsó frissítés szerint), a műszakokat (kezdési idő szerint), a termékforrásokat (legrégebbi először), a termékeket (utolsó módosítás szerint), valamint a saját sorrenddel rendelkező típusokat — tudásbázis kategóriák, dokumentáció kategóriák és oldalak, beszélgetésindítók és műszaktípusok —, amelyek abban a sorrendben érkeznek, ahogy a vezérlőpult mutatja őket.
• Az outreach típus az összes elérési terjesztési elemet altípusonként csoportosítva adja vissza (szalagcímek, üzenetek, felmérések, bemutatók, hírek).
• A lapozás a from paraméterrel a beszélgetéseknél, látogatóknál, hibajegyeknél, műszakoknál, feliratkozóknál, termékforrásoknál, termékszabályoknál és termékeknél támogatott. A többi típusnál egyszerűen a limit paraméter kerül alkalmazásra.
• Ha a fiókod csak bizonyos widgetekre korlátozódik, csak azoknak a widgeteknek a beszélgetéseit látod — ugyanaz a korlátozás, ami a Beérkezett üzenetekben is érvényes. A tulajdonosokra és adminokra ez nem vonatkozik, a hanghívások pedig mindig láthatók, mivel nem tartoznak widgethez.

Példa promptok

• „Mutasd meg az összes widgetemet.”
• „Listázd a chatbotjaimat.”
• „Jelenleg milyen hozzá nem rendelt beszélgetések vannak?”
• „Mutasd meg a 9 óta érkezett beszélgetéseket.” (az updatedSince paramétert használja)
• „Mutasd csak az Instagram beszélgetéseimet.” (a channels paramétert használja)
• „Mutasd meg a Szupport Bot chatbotomban lévő dokumentumokat.” (először megtalálja a chatbotot, majd listázza a dokumentumokat)
• „Listázd az összes közzétett cikket a Támogatás tudásbázisomban.” (megtalálja a KB-t, majd publishedOnly: true-val listázza a cikkeket)
• „Mutasd meg a hírlevél névjegycsoportjaimat és az egyes csoportok feliratkozóinak számát.”
• „Keresd meg a [email protected] feliratkozót.” (az email szűrőt használja)
• „Listázd a VIP csoportom tagjait.” (megkeresi a csoportot, majd a groupId-vel listáz)
• „Mutasd a leiratkozott névjegyeket.” (a state szűrőt használja)
• „Milyen kampányokat küldtem nemrég?”
• „Listázd az összes elérési terjesztési elemet — szalagcímeket, felméréseket, bemutatókat, mindent.”
• „Mutasd meg a legutóbbi 100 beszélgetésemet.”

get_record

Egyes rekordot kér le azonosító szerint teljes részletekkel. Több információt ad vissza, mint a list_records — például teljes konfigurációs objektumokat, tartalom mezőket és kapcsolódó adatokat.

Paraméterek

Elérhető erőforrás típusok

Ugyanazok a típusok, mint a list_records-nál, és ezenkívül az egyedi elemek lekéréséhez meghatározott elérési terjesztés altípusok:

Két mező a beszélgetéseknél külön említést érdemel:

• has_messages — megmutatja, hogy ez egy valódi beszélgetés-e, vagy az egyik üres rekord, amelyet a widget hoz létre egy új látogatóhoz. A list_records-tól eltérően az azonosító szerinti lekérés mindkét esetben visszaadja a beszélgetést, így ebből tudod meg, melyiket kaptad.
• channel — hogyan érkezett a beszélgetés: widget, e-mail, Facebook, Instagram vagy hanghívás.

Hogyan működik

• A rekordnak a szervezetedhez kell tartoznia. Más szervezetek rekordjaihoz való hozzáférési kísérletek sikertelenek lesznek.
• A beszélgetésekre a widgetenkénti hozzáférés is érvényes — ha a fiókod csak bizonyos widgetekre korlátozódik, egy másik widget beszélgetésének lekérése ugyanúgy sikertelen lesz, mint a Beérkezett üzenetekben.
• Az erőforrás teljes részleteit adja vissza, teljes képet adva a konfigurációjáról és tartalmáról.

Példa promptok

• „Mutasd meg az alapértelmezett widgetem teljes részleteit.” (először listázza a widgeteket, majd lekéri az alapértelmezettet)
• „Mi az AI konfiguráció a Szupport Botomon?” (listázza a chatbotokat, majd lekéri az adott egyet)
• „Mutasd meg a visszatérítési szabályzat dokumentum tartalmát.” (listázza a dokumentumokat, majd lekéri a teljes tartalmat)
• „Hadd lássam az Első lépések cikk teljes HTML-jét.” (megtalálja a cikket, majd lekéri a tartalmát)
• „Mik az aktiválási szabályok az akciós szalagcímemen?” (listázza az elérési terjesztési elemeket, majd lekéri a szalagcím részleteit)
• „Mutasd meg a márciusi kampány e-mail tartalmát és címzettjeit.” (lekéri a kampányt teljes küldési részletekkel)

Általános munkafolyamat minták

Felfedezés majd cselekvés

A legtöbb munkafolyamat adathozzáférési eszközökkel kezdődik:

1. Listázd az erőforrásokat, hogy megtudd, mi létezik → list_records
2. Vizsgáld meg az adott erőforrást az állapotának megértéséhez → get_record
3. Módosítsd a megfelelő kezelő eszközzel → manage_widget, manage_chatbot stb.

Tömeges áttekintés

Használd a list_records-t magasabb limit-tel egyszerre sok erőforrás áttekintéséhez:

• „Mutasd meg mind a 200 hírlevél névjegyemet.”
• „Listázd az utolsó 100 beszélgetésemet.”

Aktivitás figyelése

Nézz rá újra és újra a beérkezett üzenetekre anélkül, hogy mindent újraolvasnál:

1. Listázd a beszélgetéseket egyszer → list_records a table: "chats" paraméterrel
2. Jegyezd meg a legfrissebb updated_at értéket az eredményekben
3. A következő ellenőrzésnél add át updatedSince paraméterként → csak a megváltozott beszélgetések érkeznek vissza

• „Nézd meg időnként, hogy érkeztek-e új beszélgetések, és számolj be róluk.”

Kereszthivatkozás

Kombináld a különböző táblákból való listázást a kapcsolatok megértéséhez:

• „Listázd a widgetjeimet és chatbotjaimat, majd mondd meg, melyik chatbot melyik widgethez van kapcsolva.”
• „Mutasd meg az összes tudásbázisomat és cikkeik számát.”