Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Interkom di AWS Glue Studio
Intercom adalah Engagement OS, saluran terbuka antara bisnis Anda dan pelanggan Anda — dalam produk, saat ini, dan sesuai ketentuan mereka — menciptakan dialog berkelanjutan yang memungkinkan Anda memanfaatkan setiap keterlibatan di seluruh perjalanan pelanggan.
**Topics**
+ [AWS Glue dukungan untuk Intercom](intercom-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](intercom-configuring-iam-permissions.md)
+ [Mengkonfigurasi Interkom](intercom-configuring.md)
+ [Mengkonfigurasi koneksi Interkom](intercom-configuring-connections.md)
+ [Membaca dari entitas Interkom](intercom-reading-from-entities.md)
+ [Opsi koneksi interkom](intercom-connection-options.md)
+ [Batasan](intercom-limitations.md)
+ [Membuat akun Interkom baru dan mengonfigurasi aplikasi klien](intercom-new-account-creation.md)
# AWS Glue dukungan untuk Intercom
AWS Glue mendukung Interkom sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk meminta data dari Intercom.
**Didukung sebagai target?**
Tidak.
**Versi API Interkom yang didukung**
v2.5. Untuk dukungan entitas per versi tertentu, lihat[Membaca dari entitas Interkom](intercom-reading-from-entities.md).
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan izin IAM yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Anda juga dapat menggunakan kebijakan IAM terkelola berikut untuk mengizinkan akses:
+ [ AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM,, dan Amazon EC2. Amazon CloudWatch Logs Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [ AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya saat identitas yang dilampirkan kebijakan menggunakan Konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi Interkom
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer dari Interkom, Anda harus memenuhi persyaratan ini:
## Persyaratan minimum
+ Anda memiliki akun Interkom. Untuk informasi selengkapnya, lihat [Membuat akun Interkom baru dan mengonfigurasi aplikasi klien](intercom-new-account-creation.md).
+ Akun Interkom Anda diaktifkan untuk akses API.
+ Anda harus memiliki aplikasi di bawah akun pengembang Intercom yang menyediakan kredensi klien yang AWS Glue digunakan untuk mengakses data Anda dengan aman saat melakukan panggilan yang diautentikasi ke akun Anda. Untuk informasi selengkapnya, lihat Interkom- Langkah Pembuatan Akun Baru dan Aplikasi Klien.
Jika Anda memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Interkom Anda.
# Mengkonfigurasi koneksi Interkom
Interkom mendukung jenis `AUTHORIZATION_CODE` hibah untuk OAuth 2.
Jenis hibah ini dianggap “berkaki tiga” OAuth karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Ini digunakan saat membuat koneksi melalui AWS Glue Konsol. AWS Glue Konsol akan mengarahkan pengguna ke Google Ads di mana pengguna harus masuk dan mengizinkan izin AWS Glue yang diminta untuk mengakses instance Interkom mereka.
Pengguna harus memberikan id klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue Konsol. Dalam skenario ini, mereka masih akan diarahkan ke Interkom untuk masuk dan memberi wewenang AWS Glue untuk mengakses sumber daya mereka.
Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses berumur pendek, dan dapat disegarkan secara otomatis tanpa interaksi pengguna menggunakan token penyegaran.
Untuk informasi selengkapnya tentang membuat aplikasi yang terhubung untuk OAuth alur Kode Otorisasi, lihat [API Iklan](https://developers.intercom.com/building-apps/docs/setting-up-oauth).
Untuk mengkonfigurasi koneksi Interkom:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut. Diperlukan untuk membuat rahasia untuk setiap koneksi di AWS Glue.
1. Untuk aplikasi terhubung yang dikelola pelanggan — Secret harus berisi token akses aplikasi yang terhubung, token refresh, client\$1id, dan client\$1secret.
1. Di AWS Glue Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih Interkom.
1. Menyediakan lingkungan Interkom.
1. Pilih peran IAM yang AWS Glue dapat mengasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
# Membaca dari entitas Interkom
**Prasyarat**
+ Objek Interkom yang ingin Anda baca. Lihat tabel entitas yang didukung di bawah ini untuk memeriksa entitas yang tersedia.
**Entitas yang didukung**
| Entitas | API\$1Versi | Dapat disaring | Mendukung Batas | Mendukung Order By | Mendukung Pilih\$1 | Mendukung Partisi |
| --- | --- | --- | --- | --- | --- | --- |
| Admin | v2.5 | Tidak | Tidak | Tidak | Ya | Tidak |
| Perusahaan | v2.5 | Tidak | Ya | Tidak | Ya | Tidak |
| Percakapan | v2.5 | Ya | Ya | Ya | Ya | Ya |
| Atribut Data | v2.5 | Tidak | Tidak | Tidak | Ya | Tidak |
| Kontak | v2.5 | Ya | Ya | Ya | Ya | Ya |
| Segmen | v2.5 | Tidak | Tidak | Tidak | Ya | Tidak |
| Tag | v2.5 | Tidak | Tidak | Tidak | Ya | Tidak |
| Tim | v2.5 | Tidak | Tidak | Tidak | Ya | Tidak |
**Contoh**
```
Intercom_read = glueContext.create_dynamic_frame.from_options(
connection_type="Intercom",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "company",
"API_VERSION": "V2.5"
}
)
```
**Entitas interkom dan detail bidang**
| Entitas | Field | Tipe data | Operator yang Didukung |
| --- | --- | --- | --- |
| Admin | jenis | String | TA |
| Admin | id | String | TA |
| Admin | avatar | Struct | TA |
| Admin | name | String | TA |
| Admin | Email | String | TA |
| Admin | away\$1mode\$1enabled | Boolean | TA |
| Admin | away\$1mode\$1reassign | Boolean | TA |
| Admin | has\$1inbox\$1seat | Boolean | TA |
| Admin | teams\$1id | Daftar | TA |
| Admin | job\$1title | String | TA |
| Perusahaan | jenis | String | TA |
| Perusahaan | id | String | TA |
| Perusahaan | app\$1id | String | TA |
| Perusahaan | dibuat\$1at | DateTime | TA |
| Perusahaan | remote\$1created\$1at | DateTime | TA |
| Perusahaan | updated\$1at | DateTime | TA |
| Perusahaan | last\$1request\$1at | DateTime | TA |
| Perusahaan | rencana | Struct | TA |
| Perusahaan | perusahaan\$1id | String | TA |
| Perusahaan | name | String | TA |
| Perusahaan | custom\$1attributes | Struct | TA |
| Perusahaan | session\$1count | Bilangan Bulat | TA |
| Perusahaan | bulanan\$1habiskan | Bilangan Bulat | TA |
| Perusahaan | user\$1count | Bilangan Bulat | TA |
| Perusahaan | industri | String | TA |
| Perusahaan | ukuran | Bilangan Bulat | TA |
| Perusahaan | situs web | String | TA |
| Perusahaan | tag | Struct | TA |
| Perusahaan | segmen | Struct | TA |
| Kontak | id | String | EQUAL\$1TO.NOT\$1EQUAL\$1TO |
| Kontak | jenis | String | TA |
| Kontak | workspace\$1id | String | TA |
| Kontak | external\$1id | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | peran | String | EQUAL\$1TO.NOT\$1EQUAL\$1TO |
| Kontak | Email | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | telepon | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | name | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | avatar | String | TA |
| Kontak | owner\$1id | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | social\$1profiles | Struct | TA |
| Kontak | has\$1hard\$1memantul | Boolean | SAMA\$1KE |
| Kontak | marked\$1email\$1as\$1spam | Boolean | SAMA\$1KE |
| Kontak | unsubscribed\$1from\$1emails | Boolean | SAMA\$1KE |
| Kontak | dibuat\$1at | DateTime | SAMA\$1KE, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | updated\$1at | DateTime | SAMA\$1KE, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | signed\$1up\$1at | DateTime | SAMA\$1KE, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | last\$1seen\$1at | DateTime | SAMA\$1KE, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | last\$1replied\$1at | DateTime | SAMA\$1KE, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | last\$1contacted\$1at | DateTime | SAMA\$1KE, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | last\$1email\$1opened\$1at | DateTime | SAMA\$1KE, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | last\$1email\$1clicked\$1at | DateTime | SAMA\$1KE, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Kontak | language\$1override | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | penjelajah | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | browser\$1version | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | browser\$1language | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | os | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | lokasi | Struct | TA |
| Kontak | location\$1country | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | lokasi\$1wilayah | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | lokasi\$1kota | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | android\$1app\$1name | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | android\$1app\$1version | String | TA |
| Kontak | android\$1device | String | TA |
| Kontak | android\$1os\$1version | String | TA |
| Kontak | android\$1sdk\$1version | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | android\$1last\$1seen\$1at | Date | TA |
| Kontak | ios\$1app\$1name | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | ios\$1app\$1version | String | TA |
| Kontak | ios\$1device | String | TA |
| Kontak | ios\$1os\$1version | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | ios\$1sdk\$1versi | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Kontak | ios\$1last\$1seen\$1at | DateTime | TA |
| Kontak | custom\$1attributes | Struct | TA |
| Kontak | tag | Struct | TA |
| Kontak | catatan | Struct | TA |
| Kontak | perusahaan | Struct | TA |
| Kontak | unsubscribed\$1from\$1sms | Boolean | TA |
| Kontak | sms\$1consent | Boolean | TA |
| Kontak | opted\$1out\$1subscription\$1types | Struct | TA |
| Kontak | perujuk | String | TA |
| Kontak | utm\$1kampanye | String | TA |
| Kontak | utm\$1konten | String | TA |
| Kontak | utm\$1sedang | String | TA |
| Kontak | utm\$1source | String | TA |
| Kontak | utm\$1term | String | TA |
| Percakapan | jenis | String | TA |
| Percakapan | id | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | dibuat\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | updated\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | sumber | Struct | TA |
| Percakapan | source\$1id | String | SAMA\$1KE, TIDAK\$1SAMA\$1KE |
| Percakapan | source\$1type | String | SAMA\$1KE, TIDAK\$1SAMA\$1KE, |
| Percakapan | source\$1delivered\$1as | String | SAMA\$1KE, TIDAK\$1SAMA\$1KE, |
| Percakapan | source\$1subject | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | source\$1body | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | source\$1author\$1id | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | source\$1author\$1type | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | source\$1author\$1name | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | source\$1author\$1email | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | source\$1url | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | kontak | Struct | TA |
| Percakapan | rekan satu tim | Struct | TA |
| Percakapan | title | String | TA |
| Percakapan | admin\$1assignee\$1id | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | team\$1assignee\$1id | Bilangan Bulat | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | custom\$1attributes | Struct | TA |
| Percakapan | terbuka | Boolean | SAMA\$1KE |
| Percakapan | status | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | baca | Boolean | SAMA\$1KE |
| Percakapan | menunggu\$1sejak | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | snoozed\$1until | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | tag | Struct | TA |
| Percakapan | first\$1contact\$1reply | Struct | TA |
| Percakapan | Prioritas | String | SAMA\$1KE, TIDAK\$1SAMA\$1KE |
| Percakapan | topik | Struct | TA |
| Percakapan | sla\$1diterapkan | Struct | TA |
| Percakapan | percakapan\$1rating | Struct | TA |
| Percakapan | percakapan\$1rating\$1requested\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | percakapan\$1rating\$1replied\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | percakapan\$1rating\$1score | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | percakapan\$1rating\$1komentar | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | percakapan\$1rating\$1contact\$1id | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | percakapan\$1rating\$1admin\$1id | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | statistik | Struct | TA |
| Percakapan | statistik\$1time\$1to\$1assignment | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1time\$1to\$1admin\$1reply | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1time\$1to\$1first\$1close | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1time\$1to\$1last\$1close | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1median\$1time\$1to\$1reply | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1first\$1contact\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1first\$1assignment\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1first\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1first\$1close\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1last\$1assignment\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1last\$1assignment\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1last\$1contact\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1last\$1admin\$1reply\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1last\$1close\$1at | DateTime | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1last\$1closed\$1by\$1id | String | BERISI, EQUAL\$1TO, NOT\$1EQUAL\$1TO |
| Percakapan | statistik\$1count\$1reopens | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1count\$1assignments | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | statistik\$1count\$1conversation\$1parts | Bilangan Bulat | EQUAL\$1TO, NOT\$1EQUAL\$1TO, LEBIH BESAR\$1DARI, KURANG\$1DARI |
| Percakapan | percakapan\$1parts | Daftar | TA |
| Atribut Data | id | Bilangan Bulat | TA |
| Atribut Data | jenis | String | TA |
| Atribut Data | model | String | TA |
| Atribut Data | name | String | TA |
| Atribut Data | full\$1name | String | TA |
| Atribut Data | label | String | TA |
| Atribut Data | deskripsi | String | TA |
| Atribut Data | data\$1type | String | TA |
| Atribut Data | options | Daftar | TA |
| Atribut Data | api\$1writable | Boolean | TA |
| Atribut Data | ui\$1writable | Boolean | TA |
| Atribut Data | kebiasaan | Boolean | TA |
| Atribut Data | diarsipkan | Boolean | TA |
| Atribut Data | dibuat\$1at | Boolean | TA |
| Atribut Data | updated\$1at | DateTime | TA |
| Atribut Data | admin\$1id | String | TA |
| Segmen | jenis | String | TA |
| Segmen | id | String | TA |
| Segmen | name | String | TA |
| Segmen | dibuat\$1at | DateTime | TA |
| Segmen | updated\$1at | DateTime | TA |
| Segmen | person\$1type | String | TA |
| Segmen | count | Bilangan Bulat | TA |
| Tag | jenis | String | TA |
| Tag | id | String | TA |
| Tag | name | String | TA |
| Tim | jenis | String | TA |
| Tim | id | String | TA |
| Tim | name | String | TA |
| Tim | admin\$1id | Daftar | TA |
**Mempartisi kueri**
Opsi percikan tambahan`PARTITION_FIELD`,, `LOWER_BOUND``UPPER_BOUND`, `NUM_PARTITIONS` dapat diberikan jika Anda ingin memanfaatkan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas percikan secara bersamaan.
+ `PARTITION_FIELD`: nama bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`: nilai batas bawah inklusif dari bidang partisi yang dipilih.
Untuk tanggal, kami menerima format tanggal Spark yang digunakan dalam kueri Spark SQL. Contoh nilai yang valid:`"2024-02-06"`.
+ `UPPER_BOUND`: nilai batas atas eksklusif dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`: jumlah partisi.
Detail dukungan bidang partisi berdasarkan entitas ditangkap dalam tabel berikut.
| Nama Entitas | Bidang Partisi | Tipe data |
| --- | --- | --- |
| Kontak | created\$1at, updated\$1at, last\$1seen\$1at | DateTime |
| Percakapan | id | Bilangan Bulat |
| Percakapan | created\$1at, updated\$1at | DateTime |
**Contoh**
```
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"
}
)
```
# Opsi koneksi interkom
Berikut ini adalah opsi koneksi untuk Interkom:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca. Nama Objek Anda di Interkom.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca. Intercom Rest API versi yang ingin Anda gunakan. Contoh: v2.5.
+ `SELECTED_FIELDS`(Daftar) - Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
+ `PARTITION_FIELD`(String) - Digunakan untuk Baca. Bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`(String) - Digunakan untuk Baca. Nilai batas bawah inklusif dari bidang partisi yang dipilih.
+ `UPPER_BOUND`(String) - Digunakan untuk Baca. Nilai batas atas eksklusif dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`(Integer) - Default: 1. Digunakan untuk Baca. Jumlah partisi untuk dibaca.
+ `INSTANCE_URL`(String) - URL dari contoh di mana pengguna ingin menjalankan operasi. Misalnya: [https://api.intercom.io](https://api.intercom.io).
# Batasan
Berikut ini adalah batasan untuk konektor Interkom:
+ Saat menggunakan entitas Perusahaan, ada batasan 10.000 Perusahaan yang dapat dikembalikan. Untuk informasi selengkapnya, lihat [Daftar semua API perusahaan](https://developers.intercom.com/docs/references/2.5/rest-api/companies/list-companies).
+ Saat menerapkan pesanan berdasarkan, filter wajib untuk entitas **Kontak** dan **Percakapan**.
+ MCA didukung oleh penyedia SaaS. Namun, berdasarkan batas tarif API yang disebutkan dalam dokumentasi, kami tidak akan meng-host MCA AWS Glue karena dapat memengaruhi beban kerja lain dan berpotensi menyebabkan masalah kinerja karena perselisihan sumber daya.
# Membuat akun Interkom baru dan mengonfigurasi aplikasi klien
**Membuat akun Interkom**
1. Pilih [URL Interkom](https://app.intercom.com/) dan pilih **Mulai uji coba gratis saya** di sudut kanan atas halaman.
1. Pilih **tombol Coba gratis** di sudut kanan atas halaman.
1. Pilih jenis bisnis yang Anda butuhkan.
1. Masukkan semua informasi yang diperlukan pada halaman.
1. Setelah memasukkan semua informasi, pilih **Daftar**.
**Membuat aplikasi pengembang Interkom**
Untuk mendapatkan **Client Id** dan **Client Secret**, Anda membuat akun pengembang.
1. Arahkan ke [https://app.intercom.com/](https://app.intercom.com/).
1. Masukkan ID Email dan Kata Sandi/Masuk Menggunakan Google dan masuk.
1. Pilih **profil pengguna** di sudut kiri bawah dan pilih pengaturan.
1. Pilih **Aplikasi & Integrasi**.
1. Pilih tab **Hub Pengembang** di bawah **Aplikasi & Integrasi**.
1. Pilih **aplikasi baru** dan buat aplikasi di sini.
1. Berikan nama aplikasi dan pilih **Buat** aplikasi.
1. Di dalam aplikasi, navigasikan ke bagian **Otentikasi**.
1. Pilih **edit** dan tambahkan pengalihan URIs. Tambahkan URL Pengalihan khusus wilayah Anda sebagai. `https://.console.aws.amazon.com/gluestudio/oauth` Misalnya, tambahkan`https://us-east-1.console.aws.amazon.com/gluestudio/oauth for the us-east-1 region`.
1. Dapatkan **ID Klien** dan **Rahasia Klien** yang dihasilkan di Bagian Informasi Dasar.