Lecture à partir d’entités Intercom

Prérequis

Un objet Intercom à partir duquel vous souhaitez lire. Reportez-vous au tableau des entités prises en charge ci-dessous pour vérifier les entités disponibles.

Entités prises en charge

Entité	API_Version	Peut être filtré	Limit prise en charge	Order by prise en charge	Select prise en charge*	Partitionnement pris en charge
Admins	v2.5	Non	Non	Non	Oui	Non
Companies	v2.5	Non	Oui	Non	Oui	Non
Conversations	v2.5	Oui	Oui	Oui	Oui	Oui
Attributs des données	v2.5	Non	Non	Non	Oui	Non
Contacts	v2.5	Oui	Oui	Oui	Oui	Oui
Segments	v2.5	Non	Non	Non	Oui	Non
Balises	v2.5	Non	Non	Non	Oui	Non
Equipes	v2.5	Non	Non	Non	Oui	Non

Exemple


Intercom_read = glueContext.create_dynamic_frame.from_options(
    connection_type="Intercom",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "company",
        "API_VERSION": "V2.5"
    }
)

Détails des entités et des champs Intercom

Entité	Champ	Type de données	Opérateurs pris en charge
Admins	type	Chaîne	NA
Admins	id	Chaîne	NA
Admins	avatar	Struct	NA
Admins	name	Chaîne	NA
Admins	e-mail	Chaîne	NA
Admins	away_mode_enabled	Booléen	NA
Admins	away_mode_reassign	Booléen	NA
Admins	has_inbox_seat	Booléen	NA
Admins	teams_ids	Liste	NA
Admins	job_title	Chaîne	NA
Companies	type	Chaîne	NA
Companies	id	Chaîne	NA
Companies	app_id	Chaîne	NA
Companies	created_at	DateTime	NA
Companies	remote_created_at	DateTime	NA
Companies	updated_at	DateTime	NA
Companies	last_request_at	DateTime	NA
Companies	plan	Struct	NA
Companies	company_id	Chaîne	NA
Companies	name	Chaîne	NA
Companies	custom_attributes	Struct	NA
Companies	session_count	Entier	NA
Companies	monthly_spend	Entier	NA
Companies	user_count	Entier	NA
Companies	industry	Chaîne	NA
Companies	size	Entier	NA
Companies	website	Chaîne	NA
Companies	balises	Struct	NA
Companies	segments	Struct	NA
Contacts	id	Chaîne	EQUAL_TO.NOT_EQUAL_TO
Contacts	type	Chaîne	NA
Contacts	workspace_id	Chaîne	NA
Contacts	external_id	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	rôle	Chaîne	EQUAL_TO.NOT_EQUAL_TO
Contacts	e-mail	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	phone	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	name	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	avatar	Chaîne	NA
Contacts	owner_id	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	social_profiles	Struct	NA
Contacts	has_hard_bounced	Booléen	EQUAL_TO
Contacts	marked_email_as_spam	Booléen	EQUAL_TO
Contacts	unsubscribed_from_emails	Booléen	EQUAL_TO
Contacts	created_at	DateTime	EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	updated_at	DateTime	EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	signed_up_at	DateTime	EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	last_seen_at	DateTime	EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	last_replied_at	DateTime	EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	last_contacted_at	DateTime	EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	last_email_opened_at	DateTime	EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	last_email_clicked_at	DateTime	EQUAL_TO, GREATER_THAN, LESS_THAN
Contacts	language_override	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	browser	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	browser_version	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	browser_language	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	os	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	location	Struct	NA
Contacts	location_country	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	location_region	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	location_city	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	android_app_name	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	android_app_version	Chaîne	NA
Contacts	android_device	Chaîne	NA
Contacts	android_os_version	Chaîne	NA
Contacts	android_sdk_version	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	android_last_seen_at	Date	NA
Contacts	ios_app_name	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	ios_app_version	Chaîne	NA
Contacts	ios_device	Chaîne	NA
Contacts	ios_os_version	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	ios_sdk_version	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Contacts	ios_last_seen_at	DateTime	NA
Contacts	custom_attributes	Struct	NA
Contacts	balises	Struct	NA
Contacts	notes	Struct	NA
Contacts	companies	Struct	NA
Contacts	unsubscribed_from_sms	Booléen	NA
Contacts	sms_consent	Booléen	NA
Contacts	opted_out_subscription_types	Struct	NA
Contacts	referrer	Chaîne	NA
Contacts	utm_campaign	Chaîne	NA
Contacts	utm_content	Chaîne	NA
Contacts	utm_medium	Chaîne	NA
Contacts	utm_source	Chaîne	NA
Contacts	utm_term	Chaîne	NA
Conversations	type	Chaîne	NA
Conversations	id	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	created_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	updated_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	source	Struct	NA
Conversations	source_id	Chaîne	EQUAL_TO, NOT_EQUAL_TO
Conversations	source_type	Chaîne	EQUAL_TO, NOT_EQUAL_TO,
Conversations	source_delivered_as	Chaîne	EQUAL_TO, NOT_EQUAL_TO,
Conversations	source_subject	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	source_body	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	source_author_id	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	source_author_type	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	source_author_name	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	source_author_email	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	source_url	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	contacts	Struct	NA
Conversations	teammates	Struct	NA
Conversations	title	Chaîne	NA
Conversations	admin_assignee_id	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	team_assignee_id	Entier	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	custom_attributes	Struct	NA
Conversations	ouvrir	Booléen	EQUAL_TO
Conversations	state	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	lire	Booléen	EQUAL_TO
Conversations	waiting_since	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	snoozed_until	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	balises	Struct	NA
Conversations	first_contact_reply	Struct	NA
Conversations	priority	Chaîne	EQUAL_TO, NOT_EQUAL_TO
Conversations	topics	Struct	NA
Conversations	sla_applied	Struct	NA
Conversations	conversation_rating	Struct	NA
Conversations	conversation_rating_requested_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	conversation_rating_replied_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	conversation_rating_score	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	conversation_rating_remark	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	conversation_rating_contact_id	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	conversation_rating_admin_id	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	statistics	Struct	NA
Conversations	statistics_time_to_assignment	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_time_to_admin_reply	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_time_to_first_close	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_time_to_last_close	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_median_time_to_reply	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_first_contact_reply_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_first_assignment_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_first_admin_reply_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_first_close_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_last_assignment_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_last_assignment_admin_reply_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_last_contact_reply_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_last_admin_reply_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_last_close_at	DateTime	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_last_closed_by_id	Chaîne	CONTAINS, EQUAL_TO, NOT_EQUAL_TO
Conversations	statistics_count_reopens	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_count_assignments	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	statistics_count_conversation_parts	Entier	EQUAL_TO, NOT_EQUAL_TO, GREATER_THAN, LESS_THAN
Conversations	conversation_parts	Liste	NA
Attributs des données	id	Entier	NA
Attributs des données	type	Chaîne	NA
Attributs des données	modèle	Chaîne	NA
Attributs des données	name	Chaîne	NA
Attributs des données	full_name	Chaîne	NA
Attributs des données	étiquette	Chaîne	NA
Attributs des données	description	Chaîne	NA
Attributs des données	data_type	Chaîne	NA
Attributs des données	options	Liste	NA
Attributs des données	api_writable	Booléen	NA
Attributs des données	ui_writable	Booléen	NA
Attributs des données	personnalisé	Booléen	NA
Attributs des données	archived	Booléen	NA
Attributs des données	created_at	Booléen	NA
Attributs des données	updated_at	DateTime	NA
Attributs des données	admin_id	Chaîne	NA
Segments	type	Chaîne	NA
Segments	id	Chaîne	NA
Segments	name	Chaîne	NA
Segments	created_at	DateTime	NA
Segments	updated_at	DateTime	NA
Segments	person_type	Chaîne	NA
Segments	count	Entier	NA
Balises	type	Chaîne	NA
Balises	id	Chaîne	NA
Balises	name	Chaîne	NA
Equipes	type	Chaîne	NA
Equipes	id	Chaîne	NA
Equipes	name	Chaîne	NA
Equipes	admin_ids	Liste	NA

Requêtes de partitionnement

Les options Spark supplémentaires PARTITION_FIELD, LOWER_BOUND, UPPER_BOUND et NUM_PARTITIONS peuvent être indiquées si vous souhaitez utiliser la simultanéité dans Spark. Avec ces paramètres, la requête d’origine serait divisée en NUM_PARTITIONS nombres de sous-requêtes pouvant être exécutées simultanément par les tâches Spark.

PARTITION_FIELD : le nom du champ à utiliser pour partitionner la requête.
LOWER_BOUND : une valeur limite inférieure inclusive du champ de partition choisi.

Pour le champ Date, nous acceptons le format de date Spark utilisé dans les requêtes SQL Spark. Exemples de valeurs valides : "2024-02-06".
UPPER_BOUND : une valeur limite supérieure exclusive du champ de partition choisi.
NUM_PARTITIONS : nombre de partitions.

Les détails relatifs à la prise en charge des champs de partitionnement par entité sont présentés dans le tableau suivant.

Nom de l’entité	Champ de partitionnement	Type de données
Contacts	created_at, updated_at,last_seen_at	DateTime
Conversations	id	Entier
Conversations	created_at, updated_at	DateTime

Exemple


Intercom_read = glueContext.create_dynamic_frame.from_options(
    connection_type="Intercom",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "conversation",
        "API_VERSION": "V2.5",
        "PARTITION_FIELD": "created_at"
        "LOWER_BOUND": "2022-07-13T07:55:27.065Z"
        "UPPER_BOUND": "2022-08-12T07:55:27.065Z"
        "NUM_PARTITIONS": "2"
    }
)

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Configuration de connexions Intercom

Options de connexion Intercom