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:

• Marchi

• Carte

• Impostazioni della chat

• Aziende

• Conversazioni

• Clienti

• Ricerche dei clienti bloccate

• Posizioni di ricerca dei clienti

• Hooks Email

• Hooks Web

• Articoli KB

• Categorie KB

• Moduli KB

• Percorsi KB

• Tag KB

• Modelli KB

• Temi KB

• Classi

• Kviews

• Messaggi

• Note

• Notifiche

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"
    }