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

# Berbagi memimpin
<a name="custom-lead-sharing"></a>

## Bagaimana AWS saham memimpin
<a name="how-aws-shares-leads"></a>

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

1. **Pembuatan file**: AWS menghasilkan file lead yang mengikuti format tertentu. Untuk spesifikasi file rinci, lihat[Definisi bidang](resources.md#custom-field-definitions).

1. **Unggahan file**: File utama diunggah ke `lead-outbound` folder.

## Mengkonsumsi lead dari AWS
<a name="consuming-leads-from-aws"></a>

Untuk menggunakan lead secara efektif AWS, buat integrasi kustom dengan fungsionalitas berikut.

1. **Pengambilan file**:
   + Pindai `lead-outbound` folder secara teratur menggunakan pekerjaan terjadwal pada interval yang Anda pilih.
   + Ambil file lead untuk diproses.

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

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

1. **Konsumsi timbal**:
   + Menelan prospek baru atau memperbarui prospek yang ada dalam sistem CRM.

1. **Manajemen file**:
   + Setelah Anda berhasil memproses setiap prospek dan data file lengkap, hapus file dari folder keluar.
   + Setiap file secara otomatis diarsipkan dalam `lead-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 tentang prospek dengan AWS
<a name="sharing-updates-on-leads-with-aws"></a>

1. **Identifikasi prospek**: Temukan prospek 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 lead 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 `lead-inbound` folder. Semua file yang dibagikan AWS secara otomatis diarsipkan di `lead-inbound-archive` folder.
   + Saat Anda 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 [“Results Sample file.json](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/lead-samples/Lead-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 untuk setiap prospek.
   + Hasil yang diproses ini juga diarsipkan di `lead-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.