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
Topik
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, lihatMembuat komponen notifikasi secara manual, nanti dalam panduan ini.
Masuk ke organisasi Salesforce Anda sebagai administrator sistem.
Dari Pengaturan, di kotak Pencarian Cepat, masukkan
apps
, lalu pilih Manajer Aplikasi.-
Pada halaman Lightning Experience App Manager, pilih Aplikasi Terhubung Baru, pilih Buat Aplikasi Terhubung, lalu pilih Lanjutkan.
Halaman Aplikasi Terhubung Baru muncul.
Lakukan hal-hal berikut:
Di kotak Nama Aplikasi Terhubung, masukkan nama untuk aplikasi.
Di kotak Email Kontak, masukkan alamat email Anda.
(Opsional) Lengkapi bidang yang tersisa seperti yang dijelaskan dalam Konfigurasi Pengaturan Aplikasi Terhubung Dasar
, dalam dokumentasi Salesforce.
-
Pilih kotak centang Aktifkan OAuth Pengaturan, lalu lakukan hal berikut:
Pilih kotak centang Aktifkan untuk Aliran Perangkat. Anda dapat mengabaikan URL callback yang dihasilkan.
Di bawah OAuth Cakupan yang Tersedia, pilih Kelola data pengguna melalui APIs dan gunakan tombol Tambah untuk memindahkan cakupan ke daftar cakupan yang dipilih.
-
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
Pada pesan yang muncul setelah Anda memilih Aktifkan Aliran Kredensial Klien, pilih OK.
Gulir ke bagian bawah halaman dan pilih Simpan.
-
Pilih Lanjutkan, lalu pilih Kelola Detail Konsumen.
Halaman Verifikasi Identitas Anda muncul, dan sistem mengirimkan kode verifikasi ke alamat email kontak Anda.
-
Masukkan kode verifikasi di kotak Kode Verifikasi dan pilih Verifikasi.
Halaman untuk aplikasi Anda yang terhubung akan muncul.
Di bawah Rincian Konsumen, pilih tombol Salin untuk kunci konsumen dan rahasia pelanggan.
-
Dari Pengaturan, di kotak Pencarian Cepat, masukkan Aplikasi, pilih Kelola Aplikasi Terhubung, lalu pilih aplikasi yang terhubung yang baru saja Anda buat.
-
Pilih Edit Kebijakan, lalu lakukan hal berikut:
Dari daftar Pengguna yang Diizinkan, pilih Semua pengguna dapat melakukan otorisasi sendiri.
Dari daftar Relaksasi IP, pilih Terapkan pembatasan IP.
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.
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 AWS CloudFormation templat untuk mengonfigurasi AWS Komponen untuk EventBridge Integrasi Amazon, atau Anda dapat membuat komponen secara manual. Untuk menggunakan AWS CloudFormation, unduh templat dari:
Topik
Menemukan URL domain Anda
AWS CloudFormation Template menggunakan URL domain Anda sebagai salah satu parameter yang diperlukan.
Untuk menemukan URL
Masuk ke Salesforce.
Di bagian Pengaturan, di kotak Pencarian Cepat, masukkan
my domain
.Di panel kiri, di bawah Pengaturan Perusahaan, pilih tautan Domain Saya.
Salin alamat di kotak URL Domain Saya Saat Ini.
catatan
Anda harus menggunakan awalan https://ketika Anda memasukkan URL dalam template. AWS CloudFormation
Menggunakan AWS CloudFormation tumpukan
Langkah-langkah dalam topik berikut menjelaskan cara membuat dan menyebarkan AWS CloudFormation tumpukan yang mengatur notifikasi waktu nyata.
-
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_pcapi.json
-
AWS Marketplace Integrasi (Opsional): https://servicecatalogconnector.s3.amazonaws.com/APIDestinationAWSMPCFT_
.json
-
Di AWS Konsol, masuk ke akun AWS Marketplace penjual Anda dan pastikan itu berjalan di Virginia N. EventBridge hanya beroperasi di wilayah tersebut.
Masih di konsol, cari
cloudformation
, lalu buka AWS CloudFormation konsol.Pada halaman Stacks, pilih Create stack.
Pilih Pilih template yang ada dan Unggah file template tombol radio.
Pilih Pilih file untuk membuka templat yang diunduh, lalu pilih Berikutnya.
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_URL
.
Setelah selesai, silakan pilih Berikutnya.
Pada halaman Configure stack options, gulir ke akhir, pilih kotak centang Saya mengakui yang AWS CloudFormation mungkin membuat sumber daya IAM, lalu pilih Berikutnya.
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.
Topik
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
Untuk membuat tujuan API di EventBridge konsol:
Ikuti langkah-langkah dalam Membuat tujuan API 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
Buka EventBridge konsol di https://console.aws.amazon.com/events/
, dan di panel navigasi kiri, pilih tujuan API. -
Gulir ke bawah ke tabel tujuan API dan pilih Buat tujuan API.
Halaman tujuan Create API akan muncul.
Masukkan informasi berikut:
Nama untuk tujuan API. Anda dapat menggunakan hingga 64 huruf besar atau kecil, angka, titik (.), tanda hubung (-), atau garis bawah (_) karakter.
Nama harus unik untuk akun Anda di Wilayah saat ini.
(Opsional) Masukkan Deskripsi tujuan API.
Untuk titik akhir tujuan API, gunakan URL ini:
https://
.my-salesforce-domain-name
.my.salesforce.com/services/data/v58.0/sobjects/event-api-name
Untuk metode HTTP, pilih POST.
-
Di bawah Konfigurasi koneksi, pilih Buat koneksi baru, lalu lakukan hal berikut:
Masukkan nama dan deskripsi opsional.
Untuk tipe Tujuan, pilih Lainnya.
Pilih OAuth Client Client Client.
-
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 Untuk metode HTTP, pilih POST.
Untuk ID Klien, masukkan kunci konsumen dari aplikasi yang terhubung di Salesforce.
Untuk rahasia Klien, masukkan rahasia konsumen dari aplikasi yang terhubung di Salesforce.
Tambahkan OAuth nilai-nilai berikut:
Parameter: Bidang tubuh
Kunci: grant_type
Nilai: client_credentials
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
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 di Panduan EventBridge Pengguna Amazon.
Membuat acara set perubahan
Langkah-langkah berikut menjelaskan cara membuat peristiwa set perubahan.
-
Di Amazon EventBridge, pilih Aturan.
-
Dari daftar, pilih bus acara yang diinginkan.
-
Di bagian Aturan, pilih Buat aturan.
-
Masukkan nama untuk aturan, lalu pilih Berikutnya.
-
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 dalam AWS dokumentasi.
-
Pilih Berikutnya.
-
Di Pilih target, di bawah Target 1, pilih tujuan EventBridge API.
-
Dari daftar, pilih tujuan API yang baru saja Anda buat.
-
Perluas Pengaturan tambahan.
-
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
} -
Pilih Berikutnya, lalu Berikutnya.
-
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, serta Menerima serta menghapus pesan di Amazon SQS di Panduan Pengguna Amazon SQS.
Membuat Penawaran Acara yang dirilis
Langkah-langkah berikut menjelaskan cara membuat acara Offer Release.
-
Di EventBridge konsol Amazon, Pilih Aturan.
-
Pilih bus acara yang diinginkan dari daftar.
-
Di bagian Aturan, pilih Buat aturan.
-
Masukkan nama untuk aturan Anda, lalu pilih Berikutnya.
-
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 di Panduan EventBridge Pengguna Amazon.
-
Pilih Berikutnya.
-
Di Pilih target, di bawah Target 1, pilih tujuan EventBridge API, lalu buka daftar dan pilih tujuan API yang baru saja Anda buat.
-
Perluas Pengaturan tambahan.
-
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
} -
Pilih Next dan Next.
-
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 serta Menerima dan menghapus pesan (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
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: — Dipicu ketika peluang baru dibuat.
-
Peluang Diperbarui - Dipicu saat peluang diperbarui.
Undangan Keterlibatan Dibuat - Dipicu saat peluang dibuat.
Undangan Keterlibatan Diterima — Dipicu ketika mitra menerima AWS Undangan Keterlibatan, menegaskan minat mereka untuk berkolaborasi dengan AWS kesempatan tersebut.
Undangan Keterlibatan Ditolak - 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.
Jenis peristiwa |
Contoh |
---|---|
Peluang Diciptakan |
|
Kesempatan Diperbarui |
|
Undangan Keterlibatan Dibuat |
|
Undangan Keterlibatan Diterima |
|
Undangan Pertunangan Ditolak |
|
Semua acara |
|