Lettura dalle entità Kustomer - AWS Glue
Dettagli dell'entità e del campo del clienteInterrogazioni di partizionamento

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Lettura dalle entità Kustomer

Prerequisito

Un oggetto Kustomer da cui desideri leggere. Avrai bisogno del nome dell'oggetto, ad esempio Brands o Cards. La tabella seguente mostra le entità supportate.

Entità supportate per l'origine:

Entità Può essere filtrato Limite di supporto Supporta Order by Supporta Select * Supporta il partizionamento
Marche No Sì No Sì No
Schede No Sì No Sì No
Impostazioni chat No No No Sì No
Aziende Sì Sì Sì Sì Sì
Conversazioni Sì Sì Sì Sì Sì
Clienti Sì Sì Sì Sì Sì
Ricerche dei clienti bloccate No Sì No Sì No
Posizione delle ricerche dei clienti No No No Sì No
Ganci di posta elettronica No Sì No Sì No
Ganci Web No Sì No Sì No
Articoli KB No Sì No Sì No
Categorie KB No Sì No Sì No
Moduli KB No Sì No Sì No
Percorsi KB No Sì No Sì No
Tag KB No Sì No Sì No
Modelli KB No Sì No Sì No
Temi KB No Sì No Sì No
Classi No Sì No Sì No
KViews No Sì No Sì No
Messaggi Sì Sì Sì Sì Sì
Note Sì Sì Sì Sì Sì
Notifiche No Sì No Sì No

Esempio:

Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "brands",
        "API_VERSION": "v1"
    }

Dettagli dell'entità e del campo del cliente

Per ulteriori informazioni sulle entità e sui dettagli dei campi, consulta:

API per clienti v1

Entità Campo Tipo di dati Operatori supportati
Marche id Stringa N/A
nome Stringa N/A
URL dell'icona Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
Data modificata DateTime N/D
default Booleano N/D
Schede id Stringa N/A
nome Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
At modificato DateTime N/D
description Stringa N/A
url Stringa N/A
contesti Elenco N/D
Impostazioni della chat id Stringa N/A
Versione delle impostazioni Numero intero N/D
Tipo di widget Stringa N/A
version Numero intero N/D
Nome del team Stringa N/A
saluto Stringa N/A
risposta automatica Stringa N/A
embedIconUrl Stringa N/A
embedIconColor Stringa N/A
fallbackEmailSubject Stringa N/A
fallbackEmailIntroduction Stringa N/A
enabled Booleano N/D
outboundChatEnabled Booleano N/D
updatedAt DateTime N/D
modificato in DateTime N/D
Messaggio OFFHOURS Stringa N/A
offhoursImageUrl Stringa N/A
Chat chiudibile Booleano N/D
Nessuna cronologia Booleano N/D
Disattiva gli allegati Booleano N/D
Controllo del volume Struct N/D
singleSessonChat Booleano N/D
showTypingIndicatorWeb Booleano N/D
Aziende id Stringa N/A
nome Stringa =,! =, CONTIENE
createdAt DateTime N/D
updatedAt DateTime N/D
At modificato DateTime =,! =, >, >=, <, <=, TRA
tags Elenco N/D
domains Elenco N/D
email Elenco N/D
telefoni Elenco N/D
whatsapps Elenco N/D
social Elenco N/D
URL Elenco N/D
posizioni Elenco N/D
roleGroupVersions Elenco N/D
riv Numero intero N/D
Conversazioni id Stringa N/A
nome Stringa =,! =, CONTIENE
anteprima Stringa N/A
canali Elenco N/D
status Stringa =,! =, CONTIENE
Conteggio messaggi Numero intero =, !=, >, >=, <, <=
Conteggio note Numero intero =, !=, >, >=, <, <=
soddisfazione Numero intero =, !=, >, >=, <, <=
Livello di soddisfazione Struct N/D
createdAt DateTime =,! =, >, >=, <, <=, TRA
updatedAt DateTime =,! =, >, >=, <, <=, TRA
Modificato in DateTime =,! =, >, >=, <, <=, TRA
lastActivityAt DateTime N/D
spam Booleano N/D
conclusa Booleano =, !=
È terminato a DateTime =,! =, >, >=, <, <=, TRA
Motivo terminato Stringa CONTAINS
endedByType Stringa N/A
Importato in Stringa N/A
tags Elenco N/D
Tag suggeriti Elenco N/D
sentiment Stringa N/A
previsioni Elenco N/D
Scelte rapide consigliate Elenco N/D
firstMessageIn Struct N/D
firstMessageOut Struct N/D
lastMessageIn Struct N/D
lastMessageOut Struct N/D
lastMessageAt DateTime =,! =, >, >=, <, <=, TRA
lastMessageUnrespondedPer Struct N/D
lastMessageUnrespondedToSinceLastDone Struct N/D
Utenti assegnati Elenco N/D
Squadre assegnate Elenco N/D
Prima risposta Struct N/D
firstResponseSinceLastDone Struct N/D
Ultima risposta Struct N/D
Primo fatto Struct N/D
Fatto per ultimo Struct N/D
direzione Stringa =,! =, CONTIENE
lastMessageDirection Stringa N/A
outboundMessageCount Numero intero N/D
inboundMessageCount Numero intero N/D
rev Numero intero N/D
priority Numero intero =, !=, >, >=, <, <=
roleGroupVersions Elenco N/D
Accedi a Override Elenco N/D
assistente Struct N/D
fase Stringa N/A
Competenze Elenco N/D
matchedTimeBasedRegole Elenco N/D
Clienti id Stringa N/A
nome Stringa =,! =, CONTIENE
displayName Stringa N/A
Colore del display Stringa N/A
Icona di visualizzazione Stringa N/A
ID esterno Stringa =,! =, CONTIENE
ID esterni Elenco N/D
sharedExternalIds Elenco N/D
email Elenco N/D
Email condivise Elenco N/D
telefoni Elenco N/D
Telefoni condivisi Elenco N/D
whatsapp Elenco N/D
Facebook Kids Elenco N/D
ID Instagram Elenco N/D
social Elenco N/D
Social condivisi Elenco N/D
URL Elenco N/D
posizioni Elenco N/D
utenti attivi Elenco N/D
osservatori Elenco N/D
Ubicazione recente Struct N/D
locale Stringa =,! =, CONTIENE
timezone Stringa N/A
gender Stringa =,! =, CONTIENE
createdAt DateTime =,! =, >, >=, <, <=, TRA
updatedAt DateTime =,! =, >, >=, <, <=, TRA
Modificato in DateTime =,! =, >, >=, <, <=, TRA
lastActivityAt DateTime N/D
deleted (eliminato) Booleano N/D
Ultima conversazione Struct N/D
La conversazione conta Struct N/D
anteprima Struct N/D
tags Elenco N/D
stato progressivo Stringa =,! =, CONTIENE
verified Booleano N/D
rev Numero intero N/D
Articoli recenti Elenco N/D
Lang predefinita Stringa =,! =, CONTIENE
Livello di soddisfazione Struct N/D
roleGroupVersions Elenco N/D
Accedi a Override Elenco N/D
Nome dell'azienda Stringa N/A
firstName Stringa N/A
lastName Stringa N/A
Ricerche tra i clienti bloccate id Stringa N/A
cerca Stringa N/A
createdAt DateTime N/D
Posizioni di ricerca dei clienti id Stringa N/A
posizioni Elenco N/D
bambini Elenco N/D
createdAt DateTime N/D
updatedAt DateTime N/D
Modificato in DateTime N/D
rev Numero intero N/D
E-mail Hooks id Stringa N/A
description Stringa N/A
debug Booleano N/D
e-mail Stringa N/A
eventName Stringa N/A
titolo Stringa N/A
hash Stringa N/A
key Stringa N/A
createdAt DateTime N/D
Data modificata DateTime N/D
updatedAt DateTime N/D
Ganci Web id Stringa N/A
description Stringa N/A
eventName Stringa N/A
hash Stringa N/A
url Stringa N/A
createdAt DateTime N/D
At modificato DateTime N/D
updatedAt DateTime N/D
titolo Stringa N/A
version Numero intero N/D
debug Booleano N/D
Articoli KB id Stringa N/A
hash Stringa N/A
titolo Stringa N/A
source Stringa N/A
status Stringa N/A
scope Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
deleted (eliminato) Booleano N/D
Cancellato in DateTime N/D
Data modificata DateTime N/D
Pubblicato in DateTime N/D
tags Elenco N/D
categorie Elenco N/D
Basi di conoscenza Elenco N/D
MetaTitolo Stringa N/A
Metadescrizione Stringa N/A
MetaParole chiave Elenco N/D
Versioni LANG Struct N/D
Lang più recenti Struct N/D
Categorie KB id Stringa N/A
hash Stringa N/A
createdAt DateTime N/D
Data modificata DateTime N/D
updatedAt DateTime N/D
pubblicato Booleano N/D
posizioni Elenco N/D
Categoria Posizioni Elenco N/D
root Booleano N/D
lange Struct N/D
Moduli KB id Stringa N/A
nome Stringa N/A
pallottola Stringa N/A
hash Stringa N/A
body Stringa N/A
disposizione Elenco N/D
Layout V2 Elenco N/D
Componenti V2 Struct N/D
condizioni Struct N/D
avanzato Booleano N/D
createdAt DateTime N/D
updatedAt DateTime N/D
Pubblicato in DateTime N/D
Modificato in Stringa N/A
pubblicato Booleano N/D
snippet Elenco N/D
recaptcha Booleano N/D
classe Stringa N/A
canale Stringa N/A
deviazione Booleano N/D
formHookEnabled Booleano N/D
Risposta da Stringa N/A
wcag Booleano N/D
Percorsi KB id Stringa N/A
url Stringa N/A
Tipo di routable Stringa N/A
ID instradabile Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
At modificato DateTime N/D
Tag KB id Stringa N/A
nome Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
Data modificata DateTime N/D
Modelli KB id Stringa N/A
titolo Stringa N/A
description Stringa N/A
beta Booleano N/D
manifest Struct N/D
Frammenti di JSX Elenco N/D
images Elenco N/D
version Stringa N/A
createdAt DateTime N/D
updatedAt DateTime N/D
Temi KB id Stringa N/A
nome Stringa N/A
attiva Booleano N/D
default Booleano N/D
lastfileUpdatedAt DateTime N/D
personalizzato Booleano N/D
status Stringa N/A
templateVersionId Stringa N/A
Titolo del modello Stringa N/A
Versione del modello Stringa N/A
manifest Struct N/D
ConfigSnippet Elenco N/D
Frammenti di codice JSX Elenco N/D
createdAt DateTime N/D
updatedAt DateTime N/D
At modificato DateTime N/D
rev Numero intero N/D
Classi id Stringa N/A
nome Stringa N/A
icon Stringa N/A
color Stringa N/A
App disattivata Booleano N/D
status Stringa N/A
updatedAt DateTime N/D
createdAt DateTime N/D
s3 DataUrl Stringa N/A
KViews id Stringa N/A
risorsa Stringa N/A
modello Stringa N/A
context Stringa N/A
meta Struct N/D
App disattivata Booleano N/D
enabled Booleano N/D
avanzato Booleano N/D
disposizione Elenco N/D
componenti Struct N/D
condizioni Struct N/D
riv Numero intero N/D
createdAt DateTime N/D
At modificato DateTime N/D
updatedAt DateTime N/D
Notifiche id Stringa N/A
nome Stringa N/A
status Stringa N/A
evento Struct N/D
createdAt DateTime N/D
updatedAt DateTime N/D
Messaggi id Stringa N/A
ID esterno Stringa N/A
canale Stringa =,! =, CONTIENE
app Stringa N/A
formato Numero intero =, !=, >, >=, <, <=
direzione Stringa =,! =, CONTIENE
anteprima Stringa N/A
subject Stringa N/A
meta Struct N/D
status Stringa =,! =, CONTIENE
Tipo di direzione Stringa =,! =, CONTIENE
Squadre assegnate Elenco N/D
Utenti assegnati Elenco N/D
Errore in DateTime =,! =, >, >=, <, <=, TRA
auto Booleano =, !=
Inviato a DateTime =,! =, >, >=, <, <=, TRA
createdAt DateTime =,! =, >, >=, <, <=, TRA
updatedAt DateTime N/D
Modificato in DateTime N/D
redatto Booleano N/D
createdByTeams Elenco N/D
riv Numero intero N/D
reazioni Elenco N/D
rilevamenti di intenti Elenco N/D
Note id Stringa N/A
body Stringa CONTAINS
createdAt DateTime =,! =, >, >=, <, <=, TRA
updatedAt DateTime =,! =, >, >=, <, <=, TRA
Modificato in DateTime =,! =, >, >=, <, <=, TRA
createdByTeams Elenco N/D

Interrogazioni di partizionamento

Partizionamento basato sul campo

Puoi fornire le opzioni Spark aggiuntive e, NUM_PARTITIONS se vuoi PARTITION_FIELD LOWER_BOUNDUPPER_BOUND, utilizzare la concorrenza in Spark. Con questi parametri, la query originale verrebbe suddivisa in un NUM_PARTITIONS numero di sottoquery che possono essere eseguite contemporaneamente dalle attività Spark.

  • PARTITION_FIELD: il nome del campo da utilizzare per partizionare la query.

  • LOWER_BOUND: un valore limite inferiore inclusivo del campo di partizione scelto.

    Per il DateTime campo, accettiamo il valore in formato ISO.

    Esempio di valore valido:

    "2023-01-15T11:18:39.205Z"

  • UPPER_BOUND: un valore limite superiore esclusivo del campo di partizione scelto.

  • NUM_PARTITIONS: il numero di partizioni.

I dettagli del supporto del campo di partizionamento per entità sono riportati nella tabella seguente:

Nome dell'entità Campi di partizionamento Tipo di dati
Aziende Data modificata DateTime
Conversazioni CreatedAt, updatedAt, ModifiedAt, EndedAt, lastMessageAt DateTime
MessageCount, NoteCount BigInteger
priority Numero intero
Clienti CreatedAt, UpdatedAt, Modificato in DateTime
Messaggi ErrorAt, Inviato a, CreatedAt DateTime
formato BigInteger
Note CreatedAt, UpdatedAt, Modificato in DateTime

Esempio:

Kustomer_read = glueContext.create_dynamic_frame.from_options(
    connection_type="kustomer",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "conversation",
        "API_VERSION": "v1",
        "PARTITION_FIELD": "createdAt"
        "LOWER_BOUND": "2023-01-15T11:18:39.205Z"
        "UPPER_BOUND": "2023-02-15T11:18:39.205Z"
        "NUM_PARTITIONS": "2"
    }