Documentació oficial per extreure dades en brut de la base de dades
Aquest document té com a objectiu proporcionar accés i descripció de les principals estructures de dades disponibles per a l’empresa, facilitant la integració adequada, gestió i anàlisi d’informació relacionada amb les interaccions i agents participants. A més de descriure l’estructura de cada taula, inclou recomanacions i advertències sobre el tractament responsable de dades personals que poden trobar-se als registres, destacant la importància de complir amb les normatives actuals de privadesa i seguretat de la informació. Us suggerim revisar atentament cada definició de camp i les notes sobre el tractament de dades personals abans d’iniciar qualsevol procés d’integració o anàlisi, per garantir l’ús segur i adequat de la base de dades proporcionada.Accedir a les Dades a ClickHouse mitjançant HTTP i Eines BI
Aquesta secció explica com connectar-se a la base de dades ClickHouse de Botslovers, ja sigui mitjançant accés HTTP directe (per exemple, utilitzantcurl) o mitjançant eines gràfiques i d’Intel·ligència Empresarial com DBeaver, Power BI o Tableau.
Accés mitjançant HTTP (exemple amb curl)
Podeu accedir a les dades executant consultes SQL directament contra la base de dades ClickHouse mitjançant la seva interfície HTTP. Exemple bàsic: Per recuperar els primers 10 registres de la taulamessages_<company>:
user i password per les vostres credencials personals.
El paràmetre
query ha d’estar codificat en URL.FORMAT al final de la consulta:
Exemple JSON:
Accés des d’Eines BI o Clients de Base de Dades (DBeaver, Power BI, Tableau, etc.)
ClickHouse admet connectors JDBC i ODBC, permetent utilitzar eines gràfiques per explorar i analitzar les dades.Accés mitjançant DBeaver
- Obriu DBeaver i creeu una connexió nova.
- Seleccioneu ClickHouse com a tipus de base de dades.
- Trieu HTTP com a tipus de connexió.
- Ompliu els camps següents:
- Host:
public-clickhouse.botslovers.com - Port:
443 - Usuari: el vostre nom d’usuari
- Contrasenya: la vostra contrasenya
- SSL: activat (assegureu-vos que la casella estigui marcada)
- Host:
- Proveu la connexió i deseu.
Accés des d’Eines BI (Power BI, Tableau, etc.)
Power BI- Baixeu i instal·leu el controlador ODBC oficial de ClickHouse.
- Configureu un DSN ODBC que apunti a:
- Host:
public-clickhouse.botslovers.com - Port:
443(o8443segons la configuració, consulteu el vostre administrador) - Mode SSL: activat
- Nom d’usuari/Contrasenya: les vostres credencials
- Host:
- A Power BI, creeu una font de dades ODBC nova i seleccioneu el DSN configurat.
- Podeu utilitzar el controlador ODBC de ClickHouse com a Power BI.
- Alternativament, utilitzeu el connector natiu ClickHouse.
Seguretat i Millors Pràctiques
- Les vostres credencials són personals i no s’han de compartir.
- Consulteu el vostre administrador si teniu preguntes sobre límits d’ús o estructura de dades.
- Us recomanem evitar consultes que extreguin grans volums de dades per prevenir possibles problemes de rendiment del servei.
Taules
messages
Funciona com a repositori central on cada missatge individual generat en una conversa s’emmagatzema. Aquest document detalla els seus camps, propòsit i recomanacions específiques per gestionar dades sensibles de manera segura.
agent_activity
Taules que concentren informació rellevant sobre agents — humans o automatitzats — que participen en converses. Faciliten l’associació d’esdeveniments i mètriques a cada agent per anàlisis d’activitat individuals, càlculs d’indicadors clau (com temps de resposta, tancaments de sessió, disponibilitat d’agents) i traçabilitat d’accions a través de converses, fins i tot quan es produeixen transferències.
Descripcions de Taules
messages (Taula: messages_<company>)
Emmagatzema cada missatge intercanviat durant les converses.
agent_activity (Taula: chat_agent_log_<company>)
Registra esdeveniments que es produeixen durant la interacció dels agents amb els xats.
agent_status_logs (Taula: agent_status_logs_<company>)
Fa un seguiment de l’historial de canvis d’estat dels agents al llarg del temps, com el pas de “online” a “break”.
Tractament de Dades Personals
La taulamessages_ , especialment la columna text, manté el contingut complet de les interaccions dels clients, potencialment contenint dades personals com noms, adreces de correu electrònic, números d’ID o altres detalls sobre els productes o serveis que ofereix la vostra empresa.
És essencial processar aquestes dades d’acord amb les normatives aplicables, mantenint sempre la confidencialitat, seguretat i els drets dels subjectes de dades.