> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Panduan pengaturan notifikasi push FCM

> Siapkan FCM untuk mengaktifkan notifikasi push offline pada aplikasi DingTalk khusus Anda di perangkat Android, iOS, dan Web luar negeri melalui pendaftaran dan konfigurasi Firebase.

FCM (Firebase Cloud Messaging) adalah solusi pesan lintas platform yang mendukung platform Android, iOS, dan Web. FCM merupakan versi yang ditingkatkan dari GCM (Google Cloud Messaging).

Jika Anda ingin Aplikasi khusus Anda menerima notifikasi push offline di perangkat luar negeri, ajukan FCM dan sediakan materi yang diperlukan.

***

## Mengajukan FCM

<Steps>
  <Step title="(1) Ajukan akun Google Developer" />

  <Step title="(2) Daftar di Firebase">
    Buat proyek dan daftarkan aplikasi di Firebase. URL pendaftaran: [https://console.firebase.google.com/](https://console.firebase.google.com/)

    Setelah membuat proyek, pilih ikon Android untuk mengonfigurasikan aplikasi Android:

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/c4aad5dd-2700-4c73-8ca9-12d7982b655e.png?x-oss-process=image/crop,x_0,y_0,w_2123,h_1256/ignore-error,1" alt="Mengonfigurasikan aplikasi Android di Firebase" />
    </Frame>

    <Note>
      Harap perhatikan:

      * **Nama paket Android**: Masukkan nama paket DingTalk khusus yang benar
      * **Nama panggilan aplikasi (opsional)**: Masukkan nama aplikasi DingTalk khusus
    </Note>

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/101a77fa-1f28-41e1-a02d-54c25993bd9e.png" alt="Masukkan nama paket Android dan nama panggilan aplikasi" />
    </Frame>
  </Step>

  <Step title="(3) Unduh file konfigurasi dan unggah ke Platform Pemaketan DingTalk">
    Klik untuk mengunduh **google-services.json**. Simpan file tersebut dan kirim ke dukungan teknis DingTalk untuk konfigurasi.

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/5e35c707-9ce5-476f-ab49-5edf39df96ee.png" alt="Unduh google-services.json" />
    </Frame>
  </Step>

  <Step title="(4) Akses konsol untuk mengonfigurasikan parameter tambahan">
    Lanjutkan ke langkah terakhir dan buka konsol.

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/76639f3f-62a5-493a-8138-42f1fe8027d9.png" alt="Buka konsol" />
    </Frame>
  </Step>

  <Step title="(5) Buat kunci akun layanan">
    Navigasikan ke **Project settings > Service accounts > Generate new private key**, seperti yang ditunjukkan di bawah:

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/df3d85fa-c5a6-49ba-bbe3-55eb86b80f42.png?x-oss-process=image/crop,x_0,y_0,w_2123,h_1256/ignore-error,1" alt="Project settings, Service accounts, Generate new private key" />
    </Frame>

    <div style={{display: 'flex', gap: '12px', justifyContent: 'center', flexWrap: 'wrap', margin: '16px 0'}}>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/03d425ad-ee49-44ef-a16e-a37cbd4ea8f3.png" alt="Dialog pembuatan kunci privat" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/2479da7f-c331-4f51-826e-243b7c261aa2.png" alt="Konfirmasi pembuatan kunci privat" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />
    </div>

    Setelah mengklik **Generate key**, file JSON akan otomatis dihasilkan. Simpan file tersebut dan kirim ke dukungan teknis DingTalk:

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/adb6ae9a-4fa7-4764-87af-5dd4afd82d38.png" alt="File JSON kunci akun layanan yang dihasilkan" />
    </Frame>
  </Step>

  <Step title="(6) Buat Realtime Database">
    Klik **Create Database**:

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/ab8c9db6-2bad-4c34-9358-a9b65051a3d1.png" alt="Create Database" />
    </Frame>

    <div style={{display: 'flex', gap: '12px', justifyContent: 'center', flexWrap: 'wrap', margin: '16px 0'}}>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/a5fa837c-2683-4850-aa0a-0ad7625cac12.png" alt="Langkah penyiapan Realtime Database" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />

      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/003a8cd3-04c4-4ab8-b7a0-6290a50a54e0.png" alt="Langkah aturan Realtime Database" style={{width: '48%', minWidth: '280px', borderRadius: '8px', boxShadow: '0 2px 12px rgba(0,0,0,0.08)', margin: 0}} />
    </div>

    Klik **Enable**, lalu salin URL database sebagai materi pemaketan.

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/f417ba2c-bb63-47a4-a099-f78d598bf473.png" alt="Salin URL database" />
    </Frame>
  </Step>

  <Step title="(7) Sediakan materi di atas ke DingTalk untuk konfigurasi">
    <Check>
      * google-services.json
      * File JSON kunci akun layanan
      * URL Realtime Database
    </Check>
  </Step>

  <Step title="(8) Uji FCM melalui konsol Firebase (opsional)">
    <Note>
      **Catatan: Langkah ini opsional.**
    </Note>

    Untuk memverifikasi FCM, Anda perlu menyiapkan perangkat dengan layanan push Google (perangkat Pixel direkomendasikan). Buka konsol Firebase dan pilih **Messaging**.

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/3ab137e0-1067-4a11-a519-c10fc121a042.png" alt="Pilih Messaging di konsol Firebase" />
    </Frame>

    Ikuti petunjuk langkah demi langkah untuk mengirim notifikasi uji. **Penting: Uji hanya sebelum ditayangkan — hindari mengirim pesan ke semua pengguna untuk mencegah gangguan layanan.**

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/oJGq750ZzNR62lAK/img/9327cdf4-d064-4acb-a47d-f42cf13af335.png" alt="Kirim notifikasi uji" />
    </Frame>

    Setelah dikirim, perangkat akan menerima notifikasi uji, yang menandakan bahwa penyiapan FCM berhasil:

    <Frame>
      <img src="https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/LAJdl6zMMMDQlke1/img/fb12f2da-5680-4df3-a285-e394f73f979a.png?x-oss-process=image/crop,x_0,y_305,w_760,h_291/ignore-error,1" alt="Perangkat menerima notifikasi uji" />
    </Frame>
  </Step>
</Steps>