Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyiapkan notifikasi real-time untuk AWS Partner Central dan AWS Marketplace acara
Topik berikut menjelaskan cara mengatur EventBridge notifikasi real-time untuk AWS Partner Pusat dan AWS Marketplace acara. Anda dapat mengatur notifikasi di Salesforce dengan mengonfigurasi aplikasi yang terhubung, atau Anda dapat menggunakan templat. AWS CloudFormation
**Topics**
+ [Mengonfigurasi aplikasi yang terhubung dengan Salesforce](#configuring-salesforce-connected-app)
+ [Menggunakan AWS CloudFormation tumpukan untuk mengatur notifikasi](#configuring-aws-components)
## Mengonfigurasi aplikasi yang terhubung dengan Salesforce
Langkah-langkah berikut menjelaskan cara mengonfigurasi aplikasi yang terhubung di Salesforce. Anda harus membuat aplikasi yang terhubung untuk menggunakan OAuth otentikasi untuk koneksi tujuan. Untuk informasi lebih lanjut, lihat[Membuat komponen notifikasi secara manual](#manual-creation-of-aws-components), nanti dalam panduan ini.
1. Masuk ke organisasi Salesforce Anda sebagai administrator sistem.
1. Dari **Pengaturan**, di kotak **Pencarian Cepat**, masukkan**apps**, lalu pilih **Manajer Aplikasi**.
1. Pada halaman **Lightning Experience App Manager**, pilih **Aplikasi Terhubung Baru**, pilih **Buat Aplikasi Terhubung**, lalu pilih **Lanjutkan**.
Halaman **Aplikasi Terhubung Baru** muncul.
1. Lakukan hal-hal berikut:
1. Di kotak **Nama Aplikasi Terhubung**, masukkan nama untuk aplikasi.
1. Di kotak **Email Kontak**, masukkan alamat email Anda.
1. (Opsional) Lengkapi bidang yang tersisa seperti yang dijelaskan dalam [Konfigurasi Pengaturan Aplikasi Terhubung Dasar](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm), dalam dokumentasi Salesforce.
1. Pilih kotak centang **Aktifkan OAuth Pengaturan**, lalu lakukan hal berikut:
1. Pilih kotak centang **Aktifkan untuk Aliran Perangkat**. Anda dapat mengabaikan URL callback yang dihasilkan.
1. Di bawah ** OAuth Cakupan yang Tersedia**, pilih **Kelola data pengguna melalui APIs** dan gunakan tombol **Tambah** untuk memindahkan cakupan ke daftar cakupan yang dipilih.
1. Pilih kotak centang berikut:
+ **Memerlukan Kunci Bukti untuk Ekstensi Pertukaran Kode (PKCE) untuk Alur Otorisasi yang Didukung**
+ **Memerlukan Rahasia untuk Alur Server Web**
+ **Memerlukan Rahasia untuk Refresh Token Flow**
+ **Aktifkan Alur Kredensial Klien**
1. **Pada pesan yang muncul setelah Anda memilih **Aktifkan Aliran Kredensial Klien**, pilih OK.**
1. Gulir ke bagian bawah halaman dan pilih **Simpan**.
1. Pilih **Lanjutkan**, lalu pilih **Kelola Detail Konsumen**.
Halaman **Verifikasi Identitas Anda** muncul, dan sistem mengirimkan kode verifikasi ke alamat email kontak Anda.
1. Masukkan kode verifikasi di kotak **Kode Verifikasi** dan pilih **Verifikasi**.
Halaman untuk aplikasi Anda yang terhubung akan muncul.
1. Di bawah **Rincian Konsumen**, pilih tombol **Salin** untuk kunci konsumen dan rahasia pelanggan.
1. Dari **Pengaturan**, di kotak Pencarian **Cepat,** masukkan **Aplikasi**, pilih **Kelola Aplikasi Terhubung**, lalu pilih aplikasi yang terhubung yang baru saja Anda buat.
1. Pilih **Edit Kebijakan**, lalu lakukan hal berikut:
1. Dari daftar **Pengguna yang Diizinkan**, pilih **Semua pengguna dapat melakukan otorisasi sendiri**.
1. Dari daftar **Relaksasi IP**, pilih **Terapkan pembatasan IP**.
1. Dari daftar **Run** As, pilih *pengguna eksekusi*, pengguna yang Anda tetapkan alur kredensi klien. Salesforce mengharuskan pengguna eksekusi untuk mengembalikan token akses atas nama pengguna.
1. Pilih **Simpan**.
## Menggunakan AWS CloudFormation tumpukan untuk mengatur notifikasi
Topik berikut menjelaskan sekarang untuk menggunakan AWS CloudFormation templat untuk mengatur EventBridge pemberitahuan waktu nyata. Langkah-langkah hanya berlaku untuk versi 3.0 dan yang lebih baru dari konektor AWS Partner CRM.
Untuk konektor AWS Partner CRM versi 3.0 dan yang lebih baru, Anda dapat menggunakan CloudFormation templat untuk mengonfigurasi AWS Komponen untuk EventBridge Integrasi Amazon, atau Anda dapat membuat komponen secara manual. Untuk menggunakan CloudFormation, unduh templat dari:
**Topics**
+ [Menemukan URL domain Anda](#find-domain-url)
+ [Menggunakan CloudFormation tumpukan](#downloading-templates)
+ [Membuat komponen notifikasi secara manual](#manual-creation-of-aws-components)
+ [Contoh aturan](#example-rules)
### Menemukan URL domain Anda
CloudFormation Template menggunakan URL domain Anda sebagai salah satu parameter yang diperlukan.
**Untuk menemukan URL**
1. Masuk ke Salesforce.
1. Di bagian **Pengaturan**, di kotak **Pencarian Cepat**, masukkan**my domain**.
1. Di panel kiri, di bawah **Pengaturan Perusahaan**, pilih tautan **Domain Saya**.
1. Salin alamat di kotak **URL Domain Saya Saat Ini**.
**catatan**
Anda harus menggunakan awalan https://ketika Anda memasukkan URL dalam template. CloudFormation
### Menggunakan CloudFormation tumpukan
Langkah-langkah dalam topik berikut menjelaskan cara membuat dan menyebarkan CloudFormation tumpukan yang mengatur notifikasi waktu nyata.
1. Unduh templat berikut:
**catatan**
Anda menerapkan setiap template secara terpisah, dan Anda mengikuti langkah yang sama untuk keduanya.
+ Integrasi API Pusat Mitra: [https://servicecatalogconnector.s3.amazonaws.com/APIDestinationcft\$1pcapi.json](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_PCAPI.json)
+ AWS Marketplace Integrasi (Opsional): [https://servicecatalogconnector.s3.amazonaws.com/APIDestinationAWSMPCFT\$1](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_AWSMP.json) .json
1. Di AWS Konsol, masuk ke akun AWS Marketplace penjual Anda dan pastikan itu berjalan di **Virginia N.** EventBridge hanya beroperasi di wilayah tersebut.
1. Masih di konsol, cari**cloudformation**, lalu buka CloudFormation konsol.
1. Pada halaman **Stacks**, pilih **Create stack**.
1. Pilih Pilih **template yang ada** dan **Unggah file template** tombol radio.
1. Pilih **Pilih file** untuk membuka templat yang diunduh, lalu pilih **Berikutnya**.
1. Pada halaman **Tentukan detail tumpukan**, masukkan yang berikut ini:
+ **Nama tumpukan** — masukkan nama untuk tumpukan.
+ **ID Klien** — Masukkan kunci konsumen yang Anda catat saat membuat aplikasi yang terhubung.
+ **Rahasia Klien** — Masukkan rahasia konsumen yang Anda catat saat membuat aplikasi yang terhubung.
+ **URL Domain** — Gunakan format berikut: **https://*domain\$1URL*.**
Setelah selesai, silakan pilih **Berikutnya**.
1. **Pada halaman **Configure stack options**, gulir ke akhir, pilih kotak centang **Saya mengakui yang AWS CloudFormation mungkin membuat sumber daya IAM**, lalu pilih Berikutnya.**
1. Pilih **Kirim**.
Jika berhasil diterapkan, template akan membuat API Destination, Connection, Event Rules, dan Dead Letter Queue.
### Membuat komponen notifikasi secara manual
Langkah-langkah berikut menjelaskan cara membuat komponen untuk EventBridge notifikasi secara manual.
**Topics**
+ [Membuat tujuan dan koneksi EventBridge API Amazon](#manual-destination-connection)
+ [Membuat EventBridge Aturan dan menghubungkannya ke tujuan API](#create-connect-ev-rule)
+ [Membuat acara set perubahan](#change-set-events)
+ [Membuat Penawaran Acara yang dirilis](#offer-released-events)
+ [Menciptakan acara peluang](#opportunity-events)
+ [Jenis acara](#types-of-events)
+ [Contoh peristiwa](#example-event)
#### Membuat tujuan dan koneksi EventBridge API Amazon
Untuk membuat tujuan API dan koneksi EventBridge, buat tujuan API yang menggunakan koneksi baru. Dalam hal ini, tujuan API adalah panggilan REST API ke Salesforce untuk mempublikasikan kembali peristiwa. Koneksi berisi informasi otentikasi untuk panggilan API. Koneksi menerima beberapa metode otorisasi.
**Prasyarat**
Untuk menggunakan OAuth otorisasi untuk koneksi tujuan API, buat aplikasi yang terhubung di Salesforce. Untuk melakukannya, ikuti langkah-langkah dalam [Mengkonfigurasi Aplikasi Terhubung untuk Alur Kredensial Klien OAuth 2.0](https://help.salesforce.com/s/articleView?id=sf.connected_app_client_credentials_setup.htm), dalam dokumentasi Salesforce. Anda menggunakan kunci konsumen dan rahasia dari aplikasi yang terhubung untuk koneksi tujuan API.
Untuk membuat tujuan API di EventBridge konsol:
+ Ikuti langkah-langkah dalam [Membuat tujuan API](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html#eb-api-destination-create) di *Panduan EventBridge Pengguna Amazon*.
+ Siapkan konfigurasi yang khusus untuk Salesforce.
Di Salesforce, pada halaman **Domain Saya**, di bawah **Pengaturan**, catat nama domain organisasi Anda. Anda menggunakannya untuk mengatur tujuan API dan koneksi di EventBridge konsol. Langkah-langkah berikut menjelaskan caranya.
**Untuk membuat tujuan dan koneksi**
1. Buka EventBridge konsol di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/), dan di panel navigasi kiri, pilih **tujuan API**.
1. Gulir ke bawah **ke tabel tujuan API** dan pilih **Buat tujuan API**.
Halaman **tujuan Create API** akan muncul.
1. Masukkan informasi berikut:
1. **Nama** untuk tujuan API. Anda dapat menggunakan hingga 64 huruf besar atau kecil, angka, titik (.), tanda hubung (-), atau garis bawah (\$1) karakter.
Nama harus unik untuk akun Anda di Wilayah saat ini.
1. (Opsional) Masukkan **Deskripsi** tujuan API.
1. Untuk **titik akhir tujuan API**, gunakan URL ini:**https://*my-salesforce-domain-name*.my.salesforce.com/services/data/v58.0/sobjects/*event-api-name***.
1. Untuk **metode HTTP**, pilih **POST**.
1. Di bawah **Konfigurasi koneksi**, pilih **Buat koneksi baru**, lalu lakukan hal berikut:
1. Masukkan nama dan deskripsi opsional.
1. Untuk **tipe Tujuan**, pilih **Lainnya**.
1. Pilih **OAuth Client Client Client.**
1. Untuk titik akhir **Otorisasi, terima titik akhir** yang telah diisi sebelumnya.
—ATAU—
jika Anda menggunakan organisasi produksi, ganti titik akhir yang diisi dengan URL ini:
**https://*my-salesforce-domain-name*.my.salesforce.com/services/oauth2/token**
1. Untuk **metode HTTP**, pilih **POST**.
1. Untuk **ID Klien**, masukkan kunci konsumen dari aplikasi yang terhubung di Salesforce.
1. Untuk **rahasia Klien**, masukkan rahasia konsumen dari aplikasi yang terhubung di Salesforce.
1. Tambahkan OAuth nilai-nilai berikut:
+ **Parameter**: Bidang tubuh
+ **Kunci**: grant\$1type
+ **Nilai**: client\$1credentials
1. Pilih **Buat**.
**catatan**
Jika organisasi Salesforce Anda menggunakan autentikasi multi-faktor untuk akses API, pengguna harus menyelesaikan tantangan otentikasi kedua untuk mengakses Salesforce. APIs Untuk informasi selengkapnya, lihat [Menetapkan Persyaratan Masuk Otentikasi Multi-Faktor untuk Akses API di dokumentasi](https://help.salesforce.com/s/articleView?id=sf.security_require_2fa_api.htm&language=en_US&type=5) Salesforce.
Setelah membuat tujuan API, Anda dapat membuat aturan yang menggunakan target sebagai tujuan.
#### Membuat EventBridge Aturan dan menghubungkannya ke tujuan API
EventBridge aturan merutekan peristiwa dari bus acara ke tujuan API, yang menghasilkan panggilan REST untuk mempublikasikan acara kembali ke Salesforce.
Untuk informasi selengkapnya tentang EventBridge aturan, lihat [Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) di *Panduan EventBridge Pengguna Amazon*.
#### Membuat acara set perubahan
Langkah-langkah berikut menjelaskan cara membuat peristiwa set perubahan.
1. Di [Amazon EventBridge](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets), pilih **Aturan**.
1. Dari daftar, pilih bus acara yang diinginkan.
1. Di bagian **Aturan**, pilih **Buat aturan**.
1. Masukkan nama untuk aturan, lalu pilih **Berikutnya**.
1. Di bawah **Pola acara**, pilih **Pola kustom (editor JSON)** dan masukkan filter berikut. Anda dapat menggunakan kombinasi jenis detail apa pun.
```
{
"source": [
"aws.marketplacecatalog"
],
"detail-type": [
"Change Set Succeeded",
"Change Set Failed",
"Change Set Cancelled"
]
}
```
Untuk informasi selengkapnya tentang pencocokan pola peristiwa, lihat [Pemfilteran konten dalam pola EventBridge peristiwa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) dalam AWS dokumentasi.
1. Pilih **Berikutnya**.
1. Di **Pilih target**, di bawah **Target 1**, pilih **tujuan EventBridge API**.
1. Dari daftar, pilih tujuan API yang baru saja Anda buat.
1. Perluas **Pengaturan tambahan**.
1. Di bawah **Konfigurasi Input Target**, pilih **Transformator Input** dan **Konfigurasi Transformator Input**. Ini memastikan bahwa hanya bidang acara Salesforce dari bagian detail acara asli yang dikirim.
Jalur Input harus:
```
{
"Name": "$.detail-type",
"awsapn__Account_Number__c": "$.account",
"awsapn__EntityId__c": "$.detail.ChangeSetId"
}
```
Template harus:
```
{
"Name": Name,
"awsapn__Account_Number__c": awsapn__Account_Number__c,
"awsapn__EntityId__c": awsapn__EntityId__c
}
```
1. Pilih **Berikutnya**, lalu **Berikutnya**.
1. Tinjau aturan, lalu pilih **Buat aturan**.
**catatan**
Untuk memecahkan masalah tujuan API, Anda dapat menggunakan konsol Amazon SQS untuk menambahkan antrean huruf mati ke target. Antrian menerima pesan yang tidak dapat dikirim, ditambah kesalahan. Dari konsol Amazon SQS, Anda dapat melakukan polling pesan dalam antrian untuk kesalahan. *Untuk informasi selengkapnya, lihat [Menggunakan antrian huruf mati untuk memproses peristiwa yang tidak terkirim di EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html), serta [Menerima serta menghapus pesan di Amazon SQS di Panduan Pengguna Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html).*
#### Membuat Penawaran Acara yang dirilis
Langkah-langkah berikut menjelaskan cara membuat acara Offer Release.
1. Di EventBridge konsol [Amazon](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets), Pilih **Aturan**.
1. Pilih bus acara yang diinginkan dari daftar.
1. Di bagian **Aturan**, pilih **Buat aturan**.
1. Masukkan nama untuk aturan Anda, lalu pilih **Berikutnya**.
1. Di bawah **Pola acara**, pilih **Pola kustom (editor JSON)**, lalu masukkan filter berikut:
```
{
"source": [
"aws.marketplacecatalog"
],
"detail-type": [
"Offer Released"
]
}
```
Untuk informasi selengkapnya tentang pencocokan pola peristiwa, lihat [Pemfilteran konten dalam pola EventBridge peristiwa Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) di Panduan EventBridge Pengguna Amazon.
1. Pilih **Berikutnya**.
1. Di **Pilih target**, di bawah **Target 1**, pilih **tujuan EventBridge API**, lalu buka daftar dan pilih tujuan API yang baru saja Anda buat.
1. Perluas **Pengaturan tambahan**.
1. Di bawah **Konfigurasi Input Target** Pilih **Transformator Input**, dan pilih **Konfigurasi Input Tansformer**. Langkah ini mencegah bidang acara Amazon tingkat atas dikirim ke Salesforce. Hanya bagian yang berisi bidang acara Salesforce dari bagian detail acara asli yang dikirim.
Gunakan jalur input berikut:
```
{
"Name":"$.detail-type",
"awsapn__Account_Number__c":"$.account",
"awsapn__EntityId__c":"$.detail.offer.id",
"awsapn__Manufacturer_Account_Id__c":"$.detail.manufacturer.accountId",
"awsapn__Product_Id__c":"$.detail.product.id",
"awsapn__Seller_Account_Id__c":"$.detail.sellerOfRecord.accountId"
}
```
Gunakan template berikut:
```
{
"Name": Name,
"awsapn__Account_Number__c": awsapn__Account_Number__c,
"awsapn__EntityId__c": awsapn__EntityId__c,
"awsapn__Seller_Account_Id__c": awsapn__Seller_Account_Id__c,
"awsapn__Manufacturer_Account_Id__c": awsapn__Manufacturer_Account_Id__c,
"awsapn__Product_Id__c": awsapn__Product_Id__c
}
```
1. Pilih **Next** dan **Next**.
1. Tinjau aturan, lalu pilih **Buat aturan**.
**catatan**
Untuk membantu memecahkan masalah eksekusi tujuan API, tambahkan antrean surat mati Amazon SQS ke target. Antrian menerima pesan yang tidak dapat dikirimkan bersama dengan kesalahan. Anda kemudian dapat melakukan polling pesan untuk melihat kesalahan. Untuk informasi selengkapnya, lihat [Kebijakan percobaan ulang acara dan menggunakan antrian huruf mati](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html) serta [Menerima dan menghapus pesan (](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html)konsol) dalam dokumentasi. AWS
#### Menciptakan acara peluang
Acara peluang memberikan pemberitahuan waktu nyata tentang perubahan status atau detail peluang
Anda juga dapat membuat dan mengelola EventBridge aturan secara terprogram menggunakan. [AWS SDKs](https://docs.aws.amazon.com/partner-central/latest/selling-api/opportunity-events.html#aws-eventbridge)
#### Jenis acara
Daftar berikut menjelaskan jenis acara yang dihasilkan saat mitra bekerja dengan peluang. Tautan membawa Anda ke dokumentasi API untuk setiap acara.
+ [Peluang Dibuat:](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-created) — Dipicu ketika peluang baru dibuat.
+ [Peluang Diperbarui](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-updated) - Dipicu saat peluang diperbarui.
+ [Undangan Keterlibatan Dibuat](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-created) - Dipicu saat peluang dibuat.
+ [Undangan Keterlibatan Diterima](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-accepted) - Dipicu ketika mitra menerima AWS Undangan Keterlibatan, menegaskan minat mereka untuk berkolaborasi dengan AWS kesempatan tersebut.
+ [Undangan Keterlibatan Ditolak](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-rejected) - Dipicu ketika kesempatan ditolak.
#### Contoh peristiwa
```
{
"version": "1",
"id": ""d1example-0c9c-4655-15bf-c5exampleb08",
"source": "aws.partnercentral-selling",
"detail-type": "Opportunity Created",
"time": ""2023-10-28T13:31:05Z",
"region": ""us-east-1",
"account": ""123456789123",
"detail": {
"schemaVersion": "1",
"catalog": "AWS",
"opportunity": {
"identifier": ""O1234567",
"url": "Partner Central Opportunity Page URL"
}
}
}
```
### Contoh aturan
Tabel berikut mencantumkan contoh EventBridge aturan yang dapat Anda gunakan dengan peristiwa yang tercantum di bagian sebelumnya. Aturan merutekan peristiwa dari bus acara ke tujuan API, yang menghasilkan panggilan REST untuk mempublikasikan peristiwa kembali ke Salesforce.
| Tipe peristiwa | Contoh |
| --- | --- |
| **Peluang Diciptakan** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Opportunity Created"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Kesempatan Diperbarui** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Opportunity Updated"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Undangan Keterlibatan Dibuat** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Created"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Undangan Keterlibatan Diterima** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Accepted"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Undangan Pertunangan Ditolak** | {
"source": ["aws.partnercentral-selling"],
"detail-type": ["Engagement Invitation Rejected"],
"detail": {
"catalog": ["AWS"]
}
} |
| **Semua acara** | {
"source": ["aws.partnercentral-selling"],
"detail": {
"catalog": ["AWS"]
}
} |