Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Integrasi Salesforce
<a name="salesforce-integration"></a>

Dengan konektor tindakan Salesforce di Amazon Quick, Anda dapat melakukan tindakan dalam organisasi Salesforce, termasuk mengelola catatan, menanyakan data, dan berinteraksi dengan Salesforce API. Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).

**catatan**  
Pada rilis Salesforce Spring '26 (Februari 2026), pembuatan Aplikasi Terhubung baru dinonaktifkan secara default di semua organisasi Salesforce. Panduan ini menggunakan Aplikasi Klien Eksternal (ECA) Salesforce, yang sepenuhnya kompatibel dengan konektor Amazon Quick Salesforce.

## Prasyarat
<a name="salesforce-integration-prerequisites"></a>

Sebelum Anda mengatur integrasi Salesforce, pastikan Anda memiliki yang berikut:
+ Organisasi Salesforce dengan akses Administrator Sistem.
+ Peran Penulis Cepat Amazon atau lebih tinggi.
+ URL instans Cepat Amazon Anda (misalnya,`https://us-east-1.quicksight.aws.amazon.com`).

## Langkah 1: Buat Aplikasi Klien Eksternal di Salesforce
<a name="salesforce-eca-setup"></a>

Buat Aplikasi Klien Eksternal (ECA) di Salesforce untuk mengaktifkan otentikasi OAuth dengan Amazon Quick.

### Arahkan ke Manajer Aplikasi Klien Eksternal
<a name="salesforce-eca-navigate"></a>

1. Masuk ke organisasi Salesforce Anda dan pilih **Pengaturan** (ikon roda gigi di kanan atas).

1. Di panel navigasi, perluas **Alat Platform** > **Aplikasi > Aplikasi** **Klien Eksternal > Manajer Aplikasi Klien** **Eksternal**.

1. Pilih **Aplikasi Klien Eksternal Baru**.

### Isi informasi dasar
<a name="salesforce-eca-basic-info"></a>

Masukkan informasi dasar berikut untuk Aplikasi Klien Eksternal Anda:


**Informasi dasar Aplikasi Klien Eksternal**  

| Bidang | Nilai | 
| --- | --- | 
| Nama Aplikasi Klien Eksternal | Nama deskriptif (misalnya, “Amazon Quick Integration”) | 
| Nama API | Auto-generated dari nama aplikasi | 
| Email Kontak | Alamat email admin Anda | 
| Negara Distribusi | Lokal (default) | 

## Langkah 2: Konfigurasikan pengaturan OAuth
<a name="salesforce-oauth-setup"></a>

### Aktifkan OAuth
<a name="salesforce-enable-oauth"></a>

Di bagian **API (Aktifkan Pengaturan OAuth)**, pilih **Aktifkan OAuth untuk memperluas panel konfigurasi** OAuth.

### Tetapkan URL panggilan balik
<a name="salesforce-callback-url"></a>

Masukkan URL callback Amazon Quick OAuth di kolom URL **Callback**:

`{{<your-quick-instance-url>}}/sn/oauthcallback`

Misalnya: `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`

### Tambahkan cakupan OAuth
<a name="salesforce-oauth-scopes"></a>

**Pindahkan cakupan berikut dari Cakupan OAuth **yang Tersedia ke Lingkup OAuth** yang Dipilih:**
+ Akses layanan URL identitas (id, profil, email, alamat, telepon)
+ Mengelola data pengguna melalui API (api)
+ Mengelola data pengguna melalui browser Web (web)
+ Akses penuh (penuh)
+ Akses aplikasi Visualforce (visualforce)
+ Lakukan permintaan kapan saja (refresh\_token, offline\_access)
+ Akses pengenal pengguna unik (openid)
+ Akses izin khusus (custom\_permissions)
+ Akses sumber daya Connect REST API (chatter\_api)
+ Akses sumber daya API REST Analytics (wave\_api)
+ Akses Analytics REST API Charts Sumber daya geodata (eclair\_api)
+ Kelola layanan Pardot (pardot\_api)

### Aktifkan aliran OAuth
<a name="salesforce-oauth-flows"></a>

Pilih opsi aliran berikut:
+ **Aktifkan Alur Kredensial Klien**
+ **Aktifkan Kode Otorisasi dan Alur Kredensil**
+ **Aktifkan Aliran Pertukaran Token**

### Aktifkan pengaturan keamanan
<a name="salesforce-security-settings"></a>

Pilih opsi keamanan berikut:
+ **Memerlukan Kunci Bukti untuk Pertukaran Kode (PKCE)**
+ **Memerlukan Rahasia untuk Alur Server Web** (dipilih secara default)
+ **Memerlukan Rahasia untuk Refresh Token Flow** (dipilih secara default)

Pilih **Buat** untuk menyimpan Aplikasi Klien Eksternal.

## Langkah 3: Dapatkan kredensi konsumen
<a name="salesforce-consumer-details"></a>

1. Setelah pembuatan, Anda berada di halaman detail ECA.

1. Arahkan ke tab **Pengaturan** atau pilih **Kelola Detail Konsumen**.

1. Anda mungkin perlu memverifikasi identitas Anda (kode verifikasi email).

1. Salin **Kunci Konsumen** (ID Klien) dan **Rahasia Konsumen** (Rahasia Klien).

**penting**  
Simpan kredensi ini dengan aman. Anda membutuhkannya saat mengonfigurasi konektor di Amazon Quick.

## Langkah 4: Konfigurasikan konektor Salesforce di Amazon Quick
<a name="salesforce-integration-setup"></a>

### Arahkan ke Konektor
<a name="salesforce-navigate-connectors"></a>

1. Buka Amazon Quick dan pilih **Konektor**.

1. Pilih tab **Buat untuk tim Anda**.

1. Temukan dan pilih **Salesforce**.

1. Jika diminta bahwa konektor sudah ada, pilih **Tidak, buat baru**.

### Isi detail koneksi
<a name="salesforce-connection-details"></a>

Masukkan detail koneksi berikut:


**Detail koneksi konektor Salesforce**  

| Bidang | Nilai | 
| --- | --- | 
| Nama | Nama deskriptif (misalnya, “Salesforce ECA”) | 
| Jaringan | Jaringan publik | 
| Jenis Auth | Aplikasi OAuth kustom | 
| URL dasar | https://{{<your-domain>}}.my.salesforce.com/services/data/v60.0 | 
| ID Klien | Kunci Konsumen dari Langkah 3 | 
| Rahasia Klien | Rahasia Konsumen dari Langkah 3 | 
| URL Token | https://{{<your-domain>}}.my.salesforce.com/services/oauth2/token | 
| URL Otorisasi | https://{{<your-domain>}}.my.salesforce.com/services/oauth2/authorize | 
| URL pengalihan | Pre-filled (jangan berubah) | 

Pilih **Berikutnya** untuk melanjutkan.

## Langkah 5: Verifikasi dan publikasikan
<a name="salesforce-verify-publish"></a>

1. Pada halaman **Tinjauan**, verifikasi tindakan Salesforce yang tersedia (hingga 42 tindakan).

1. Pilih **Berikutnya** untuk melanjutkan ke berbagi pengguna.

1. Pilih pengguna atau grup yang seharusnya memiliki akses ke konektor ini.

1. Pilih **Publikasikan** untuk mempublikasikan konektor.

Setelah mempublikasikan konektor, Anda dapat menggunakan tindakan Salesforce di Amazon Quick chat, flow, dan otomatisasi.

## Tindakan yang tersedia
<a name="salesforce-integration-actions"></a>

Setelah Anda mengatur konektor, tindakan Salesforce berikut tersedia:
+ Buat, baca, perbarui, dan hapus (CRUD) operasi pada objek standar dan kustom.
+ Kueri data Salesforce menggunakan SOQL (Salesforce Object Query Language).
+ Kelola prospek, akun, kontak, dan peluang.
+ Jalankan metode Apex dan logika kustom.
+ Mengelola kasus, tugas, dan kegiatan.
+ Akses laporan dan dasbor.

**catatan**  
Integrasi Salesforce hanya mendukung eksekusi tindakan. Akses data dan pembuatan basis pengetahuan tidak tersedia untuk sistem Salesforce.

## Pemecahan masalah
<a name="salesforce-integration-troubleshooting"></a>

Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).
+ **Kesalahan “URL tidak lagi ada”** - Pastikan Anda menggunakan domain Salesforce yang benar di URL Token dan URL Otorisasi. Jangan gunakan endpoint lama.
+ **Validasi OAuth gagal** — Verifikasi bahwa PKCE diaktifkan di ECA dan URL Callback sama persis dengan URL instans Cepat Amazon Anda dengan ditambahkan. `/sn/oauthcallback`
+ **Kesalahan cakupan hilang** **- Kembali ke konfigurasi ECA di Salesforce dan pastikan semua cakupan OAuth yang diperlukan ada dalam daftar yang **Dipilih**, tidak masih tersedia.**
+ **Opsi “Aplikasi Terhubung” berwarna abu-abu** — Ini diharapkan setelah Salesforce Spring '26. Gunakan Aplikasi Klien Eksternal sebagai gantinya. ECA adalah pengganti yang didukung.