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

# Integrasi Shopify
<a name="shopify-integration"></a>

Dengan konektor aksi Shopify, Anda dapat mengelola produk, pesanan, pelanggan, dan operasi toko langsung di Amazon Quick melalui bahasa alami.

Shopify menggunakan otentikasi aplikasi OAuth Kustom. Untuk informasi selengkapnya tentang metode otentikasi yang didukung Amazon Quick, lihat[Metode autentikasi](quick-action-auth.md).

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

Pastikan Anda memiliki yang berikut ini sebelum Anda mengatur integrasi.
+ Toko Shopify aktif dengan akses admin.
+ Aplikasi khusus yang terdaftar di admin Shopify Anda atau di portal Mitra Shopify, dengan cakupan akses Admin API yang Anda butuhkan.
+ Untuk persyaratan berlangganan Amazon Quick, lihat[Siapkan integrasi di konsol](integration-console-setup-process.md).

## Mengkonfigurasi Shopify
<a name="shopify-source-setup"></a>

Untuk otentikasi aplikasi Custom OAuth, buat aplikasi khusus di admin toko Shopify Anda atau di portal Shopify Partners di situs web [Shopify](https://partners.shopify.com/). Konfigurasikan cakupan akses Admin API yang cocok dengan operasi yang ingin Anda gunakan, dan tambahkan URL callback Amazon Quick `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback` sebagai URL pengalihan yang diizinkan. Ganti {{{region}}} dengan AWS Wilayah Anda (misalnya,`us-east-1`). Untuk petunjuk langkah demi langkah, lihat [Otentikasi dan otorisasi](https://shopify.dev/docs/apps/build/authentication-authorization) di dokumentasi pengembang Shopify. Rekam ID Klien (kunci API) dan Rahasia Klien (kunci rahasia API) - Anda memerlukannya saat mengonfigurasi Amazon Quick.

## Menyiapkan konektor di Amazon Quick
<a name="shopify-quicksuite-setup"></a>

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

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

1. Temukan dan pilih **Shopify**.

1. Masukkan **Nama** untuk konektor Anda. Secara opsional, pilih **\+ Tambahkan Deskripsi** untuk menambahkan deskripsi.

1. Untuk **jenis Koneksi**, pilih **Jaringan publik**.

1. Untuk **Konfigurasi OAuth**, pilih **aplikasi OAuth Kustom** dan konfigurasikan bidang berikut:
   + **URL Dasar — URL dasar** MCP Shopify untuk toko Anda.
   + **ID Klien** - ID Klien (kunci API) dari aplikasi khusus Shopify Anda.
   + **Klien OAuth Publik** (Opsional) - Pilih opsi ini jika aplikasi khusus Shopify Anda dikonfigurasi sebagai klien publik (tidak ada rahasia klien).
   + **Rahasia klien** - Rahasia Klien (kunci rahasia API) dari aplikasi khusus Shopify Anda.
   + **URL Token** — Titik akhir token Shopify OAuth untuk toko Anda.
   + **URL Otorisasi - Titik akhir otorisasi** Shopify OAuth untuk toko Anda.
   + **Redirect URL** — Pre-filled dengan URL callback Amazon Quick.

1. Pilih **Berikutnya**.

1. Jendela otorisasi Shopify terbuka. Tinjau izin yang diminta dan pilih **Instal aplikasi** atau tombol yang setara.

1. Pada halaman **Ulasan**, tinjau tindakan yang tersedia untuk konektor. Pilih **Berikutnya**.

1. Pada halaman **Publikasikan**, pilih siapa yang dapat mengakses konektor. Anda dapat mengaktifkan akses untuk semua orang di organisasi Anda atau mencari tim atau grup tertentu.

1. Pilih **Terbitkan**.

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

Setelah Anda mengatur konektor, tindakan yang diekspos oleh Shopify tersedia. Untuk melihat rangkaian tindakan saat ini untuk konektor Anda, buka tampilan **Tindakan yang tersedia** konektor di konsol Amazon Quick.

## Mengelola dan memecahkan masalah
<a name="shopify-troubleshooting"></a>

Untuk mengedit, membagikan, atau menghapus konektor Anda, lihat[Mengelola integrasi yang ada](integration-workflows.md#managing-existing-integrations).

### Masalah otentikasi
<a name="shopify-troubleshooting-auth"></a>
+ **Sign-in gagal** - Verifikasi bahwa Anda dapat masuk ke admin toko Shopify Anda secara langsung. Konfirmasikan bahwa URL pengalihan yang diizinkan di aplikasi khusus Shopify Anda cocok dengan URL panggilan balik Cepat Amazon.
+ **Kredensi klien tidak valid** - Verifikasi bahwa ID Klien (kunci API) dan Rahasia Klien (kunci rahasia API) cocok dengan nilai di aplikasi khusus Shopify Anda.
+ **Izin tidak memadai** - Verifikasi bahwa cakupan akses Admin API yang dikonfigurasi pada aplikasi khusus Shopify Anda cocok dengan operasi yang ingin Anda gunakan.