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

# Berbagi kesempatan
<a name="custom-opportunity-sharing"></a>

## Bagaimana AWS berbagi peluang
<a name="how-aws-shares-opportunities"></a>

1. **Ekspor tambahan**: Amazon Web Services (AWS) mengekspor peluang baru (dan pembaruan) yang dirujuk oleh AWS, setiap jam.

1. **Pembuatan file**: AWS menghasilkan file peluang yang mematuhi format tertentu. Untuk spesifikasi file terperinci, lihat [definisi bidang Peluang](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Fields.csv).

1. **Unggahan file**: File peluang diunggah ke `opportunity-outbound` folder.

## Mengkonsumsi peluang dari AWS
<a name="consuming-opportunities-from-aws"></a>

Untuk memanfaatkan peluang secara efektif AWS, Anda perlu membangun integrasi khusus dengan fungsionalitas ini.

1. **Pengambilan file**:
   + Gunakan pekerjaan terjadwal untuk memindai `opportunity-outbound` folder secara teratur, pada interval yang Anda pilih.
   + Ambil file peluang untuk diproses.

1. **Transformasi dan pemetaan data**:
   + Setelah Anda membaca konten setiap file, ubah dan petakan data ke catatan peluang dalam sistem manajemen hubungan pelanggan (CRM) Anda.
   + Untuk panduan tentang pemetaan lapangan, lihat. [Pemetaan lapangan](custom-field-mapping.md)

1.  **Identifikasi peluang**:
   + Identifikasi secara unik setiap peluang menggunakan salah satu atau`partnerCrmOpportunityId`. `apnCrmUniqueIdentifier`
   + Jika `partnerCrmOpportunityId` kosong dan `apnCrmUniqueIdentifier` hadir, peluangnya adalah rujukan baru dari AWS Partner Network (APN) Customer Engagement (ACE).
   + Jika kedua pengidentifikasi hadir, catatan diperlakukan sebagai pembaruan dari ACE.

1. **Penyerapan peluang**: Menelan peluang baru atau memperbarui peluang yang ada dalam sistem CRM.

1. **Manajemen file**:
   + Setelah Anda berhasil memproses setiap peluang dan data file lengkap, hapus file dari folder keluar.
   + Setiap file secara otomatis diarsipkan dalam `opportunity-outbound-archive` folder.

**Integrasi dan referensi kode**:
+  Untuk membaca file yang diunggah ke bucket Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3), Anda dapat menggunakan AWS Lambda atau membaca langsung dari sistem CRM Anda.
+ Gunakan kode contoh di bawah ini untuk Lambda dan Salesforce REST API untuk memvalidasi dan memperbarui catatan CRM.
  + **Lambda untuk memvalidasi file**[: ace\$1read\$1s3.py.](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/ace_read_s3.py)
  + **API REST Salesforce: [API\$1CAPEX\$1SAMPLE\$1REST\$1](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Apex_Sample_REST_API_Code.cls)** ode.cls.
+ Jika Anda menggunakan sistem CRM selain Salesforce, Anda harus memberikan kode khusus untuk sistem Anda untuk memperbarui data Anda.

## Berbagi pembaruan untuk peluang dengan AWS
<a name="sharing-updates-to-opportunities-with-aws"></a>

1. **Identifikasi peluang**: Temukan peluang dengan pembaruan untuk dibagikan AWS.

1. **Transformasi data**: Ubah data ke dalam AWS format, seperti yang diuraikan dalam[Definisi bidang](resources.md#custom-field-definitions).

1.  **Pembuatan file**: 
   + Hasilkan file peluang dalam format JSON.
   + Tambahkan stempel waktu ke setiap file, pastikan semua nama file unik dan ikuti formatnya:. `{name}_MMDDYYYY24HHMMSS.json`

1.  **Otentikasi dan unggah**: 
   + Otentikasi ke bucket ACE Amazon S3.
   + Unggah file ke `opportunity-inbound` folder. Semua file yang dibagikan AWS secara otomatis diarsipkan di `opportunity-inbound-archive` folder.
   + Saat mengunggah file ke S3, pastikan Anda menyediakan akses penuh ke pemilik bucket:

     ```
     aws s3 cp example.jpg s3://awsexamplebucket --acl bucket-owner-full-control
     ```

      Lihat hasil sampel menjalankan perintah ini di [Opportunity Results Success Sample.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/opportunity-samples/Opportunity-Results-Success-Sample.json).

1. **Pengolahan file**: 
   + Setelah diterima, AWS secara otomatis memproses file.
   + Hasil pemrosesan diunggah ke `lead-inbound-processed-results` folder di bucket Amazon S3. Ini termasuk status keberhasilan dan kesalahan, serta pesan kesalahan apa pun untuk setiap peluang.
   + Hasil yang diproses ini juga diarsipkan di `opportunity-inbound-processed-results-archive` folder.
   + Untuk informasi lebih lanjut, lihat[Tanya Jawab Teknis — Prospek dan Peluang](technical-faq-leads-and-opps.md).

1. **Penanganan respons**:
   + Anda harus mengembangkan logika untuk mengkonsumsi tanggapan ini, meninjau catatan yang salah, memperbaiki kesalahan, dan mengirim ulang data ke ACE.
   + Anda dapat menemukan kesalahan sampel di bagian FAQ dan Pemecahan Masalah.
   + Untuk mengunggah file ke Amazon S3 dari CRM:
     + Referensi versi AWS tanda tangan.
     + Gunakan permintaan HTTPS untuk mengunggah file.
   + Untuk referensi, gunakan file berikut untuk mengunggah file ke bucket Amazon S3: 
     + **[Untuk mengautentikasi bucket S3: S3\$1Authentication.cls](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/S3_Authentication.cls)**
     + **Untuk mengunggah file ke ember S3**[: Sample\$1 .cls AceOutboundBatch](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/code-snippets/Sample_AceOutboundBatch.cls)
   + **CATATAN:** File tidak boleh melebihi 1 MB, dan file duplikat tidak akan diproses.