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. APIs Konektor aksi ini hanya mendukung eksekusi tugas dan memerlukan Amazon Quick Pro tier atau lebih tinggi.

## Apa yang dapat Anda lakukan
<a name="salesforce-integration-capabilities"></a>

Dengan integrasi Salesforce, Anda dapat melakukan tindakan dalam organisasi Salesforce Anda melalui konektor tindakan.

**Konektor aksi**  
Buat, perbarui, dan kueri objek Salesforce seperti prospek, akun, kontak, dan peluang.

**catatan**  
Integrasi Salesforce tidak mendukung akses data atau pembuatan basis pengetahuan. Ini dirancang khusus untuk eksekusi tugas dan interaksi API dengan objek Salesforce.

## Sebelum Anda mulai
<a name="salesforce-integration-prerequisites"></a>

Sebelum Anda mengatur integrasi Salesforce, pastikan Anda memiliki yang berikut:
+ Organisasi Salesforce dengan izin yang sesuai.
+ Aplikasi terhubung Salesforce atau kredenal akses API.
+ Penulis Cepat Amazon atau lebih tinggi.
+ Akses administratif untuk mengkonfigurasi OAuth aplikasi (jika menggunakan otentikasi pengguna).

## Langkah 1: Siapkan aplikasi terhubung Salesforce
<a name="salesforce-connected-app-setup"></a>

**catatan**  
Buat aplikasi yang terhubung di Salesforce. Jangan membuat aplikasi klien eksternal. Aplikasi klien eksternal tidak kompatibel dengan integrasi ini.

Buat aplikasi yang terhubung di Salesforce untuk mengaktifkan OAuth otentikasi dengan Amazon Quick.

1. Masuk ke akun Salesforce Anda dan arahkan ke halaman Pengaturan menggunakan ikon Pengaturan di kanan atas.

1. Di bilah Pencarian Cepat, masukkan**Apps**, lalu ikuti langkah-langkah ini:
   + Pilih **Aplikasi Klien Eksternal**
   + Pilih **Pengaturan**
   + Di bawah Pengaturan, buat aplikasi baru yang terhubung

1. Pilih **Aplikasi Terhubung Baru**.

1. Pilih **Buat aplikasi yang terhubung**.

1. Di bagian Informasi Dasar, masukkan informasi yang diperlukan berikut ini:
   + **Nama Aplikasi Terhubung - Nama** deskriptif untuk aplikasi Anda yang terhubung.
   + **Nama API - Nama** API unik untuk aplikasi Anda.
   + **Email Kontak** - Alamat email kontak Anda.

1. Di bagian OAuth Pengaturan, pilih kotak centang berikut:
   + **Aktifkan OAuth Pengaturan**
   +  **Memerlukan Kunci Bukti untuk Ekstensi Pertukaran Kode (PKCE) untuk Alur Otorisasi yang Didukung** *(disarankan)* 

      Aktifkan opsi ini untuk menambahkan lapisan keamanan tambahan ke aliran Kode Otorisasi.
   + **Memerlukan Rahasia untuk Alur Server Web**
   + **Memerlukan Rahasia untuk Refresh Token Flow**
   + **Aktifkan Alur Kredensial Klien**
   + **Aktifkan Kode Otorisasi dan Alur Kredensi**
   + **Aktifkan Aliran Pertukaran Token**
   + **Memerlukan Rahasia untuk Aliran Pertukaran Token**

1. Tambahkan OAuth cakupan yang diperlukan berikut:
   + `api`- Akses Salesforce APIs
   + `refresh_token`- Pertahankan akses saat pengguna offline
   + `offline_access`- Lakukan permintaan kapan saja
   + `full`- Akses penuh ke semua data
   + `web`- Akses berbasis web
   + `visualforce`- Akses halaman Visualforce
   + `custom_permissions`- Akses izin khusus
   + `chatter_api`- Akses Chatter API
   + `wave_api`- Akses API Analytics
   + `eclair_api`- Akses API Analisis Einstein
   + `pardot_api`- Akses Pardot API
   + `id`- Akses informasi identitas
   + `email`- Akses alamat email
   + `profile`- Akses informasi profil dasar
   + `address`- Akses informasi alamat
   + `phone`- Akses nomor telepon
   + `open_id`- Akses OpenID Connect

1. Masukkan URL callback dalam format: `<quicksuite-url>/sn/oauthcallback`

1. Pilih **Simpan**.

## Langkah 2: Konfigurasikan detail konsumen dan eksekusi pengguna
<a name="salesforce-consumer-details"></a>

Konfigurasikan detail konsumen dan siapkan pengguna eksekusi untuk alur kredensional klien.

1. Dari halaman Kelola Aplikasi Terhubung, pilih **Kelola Detail Konsumen**. Anda mungkin perlu memverifikasi identitas Anda.

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

1. Pilih **Terapkan**.

1. Pilih **Token Akses Awal**, lalu pilih **OK**.

1. Konfigurasikan pengguna eksekusi:

   1. Dari halaman detail aplikasi yang terhubung, pilih **Edit** di bawah kolom Tindakan.

   1. Di bawah OAuth Kebijakan > Refresh Token Policy, pilih **Segera kedaluwarsa token refresh**.

   1. Di bawah Client Credentials Flow, untuk Run As, pilih pengguna untuk menetapkan alur kredensial klien.

   1. Pilih **Simpan**.

## Langkah 3: Siapkan konektor aksi Salesforce
<a name="salesforce-integration-setup"></a>

Setelah menyiapkan kredensil aplikasi yang terhubung dengan Salesforce, buat konektor tindakan Salesforce di Amazon Quick.

Integrasi Salesforce hanya mendukung eksekusi tindakan - akses data dan pembuatan basis pengetahuan tidak tersedia untuk sistem Salesforce.

1. Di konsol Amazon Quick, pilih **Integrasi.**

1. Pilih **Salesforce** dari opsi integrasi, dan klik tombol Tambah (plus “\$1”).

1. Isi detail integrasi:
   + **Nama - Nama** deskriptif untuk konektor tindakan Salesforce Anda.
   + **Deskripsi** (Opsional) - Tujuan konektor tindakan.

1. Pilih jenis koneksi Anda:
   + **Otentikasi OAuth berbasis otentikasi pengguna** untuk akses pengguna individu.
   + **Otentikasi layanan** - Service-to-service otentikasi untuk akses aplikasi.

1. Isi pengaturan koneksi berdasarkan metode otentikasi yang Anda pilih (baik pengguna atau layanan):

   1. Untuk **autentikasi Pengguna (OAuth)**, konfigurasikan bidang berikut:
     + **URL dasar - URL** contoh Salesforce (misalnya, https://your-domain.salesforce.com).
     + **ID Klien** - Kunci konsumen aplikasi terhubung Salesforce.
     + **Rahasia Klien - Rahasia** konsumen aplikasi terhubung Salesforce.
     + **URL Token** - Titik akhir OAuth token Salesforce.
     + **URL Auth - Titik** akhir otorisasi Salesforce OAuth .
     + **URL pengalihan** - URI OAuth pengalihan yang dikonfigurasi di aplikasi Anda yang terhubung.

1. Pilih **Buat dan lanjutkan**.

1. Pilih pengguna untuk berbagi integrasi dengan.

1. Klik **Berikutnya**.

## Langkah 4: Kaitkan konektor tindakan ke grup otomatisasi
<a name="salesforce-automation-group-setup"></a>

Untuk menggunakan tindakan Salesforce dalam otomatisasi, Anda harus mengaitkan konektor tindakan dengan grup otomatisasi Anda.

1. Arahkan ke pengaturan grup otomatisasi Anda.

1. Kaitkan konektor tindakan Salesforce dengan grup otomatisasi yang akan menggunakan tindakan ini.

1. Buat otomatisasi baru untuk grup otomatisasi untuk mengakses tindakan Salesforce di alur kerja Anda.

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

Setelah membuat integrasi Salesforce, Anda dapat meninjau tindakan yang tersedia untuk berinteraksi dengan objek Salesforce. Tindakan Salesforce umum meliputi:
+ 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.
+ Kelola kasus, tugas, dan aktivitas.
+ Akses laporan dan dasbor.

## Bagikan integrasi
<a name="salesforce-integration-sharing"></a>

Anda dapat berbagi konektor tindakan Salesforce dengan pengguna lain di organisasi Anda. Ikuti langkah-langkah ini:

1. Setelah Anda membuat integrasi, pilih **Bagikan integrasi**.

1. Pilih pengguna atau grup untuk berbagi integrasi dengan.

1. Tetapkan izin yang sesuai untuk akses bersama.

1. Konfirmasikan pengaturan berbagi.

Pengguna bersama dapat menggunakan integrasi Salesforce untuk melakukan tindakan dalam organisasi Salesforce yang terhubung, tunduk pada izin yang dikonfigurasi dalam pengaturan otentikasi asli.

## Kelola konektor aksi Salesforce
<a name="salesforce-integration-management"></a>

Setelah membuat konektor tindakan Salesforce, Anda dapat mengelolanya menggunakan opsi ini:
+ **Edit konektor tindakan** - Perbarui pengaturan otentikasi atau konfigurasi instance Salesforce.
+ **Konektor aksi berbagi** - Buat konektor tindakan tersedia untuk pengguna lain di organisasi Anda.
+ **Memantau penggunaan** - Lihat aktivitas konektor tindakan dan metrik penggunaan API.
+ **Tinjauan tindakan** - Lihat daftar lengkap tindakan Salesforce yang tersedia.
+ **Hapus konektor tindakan** - Lepaskan konektor tindakan dan cabut otentikasi terkait.