> ## 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.

# Notifikasi pesan formulir

> Pelajari fitur notifikasi pesan formulir di YiDA — dari pesan terjadwal, DingTalk To-Do, hingga pengiriman via layanan pihak ketiga di seluruh Edisi Basic, Professional, dan Dedicated.

| **Fitur**                                       | **Edisi Gratis** | **Edisi Basic** | **Edisi Professional** | **Edisi Dedicated** |
| ----------------------------------------------- | ---------------- | --------------- | ---------------------- | ------------------- |
| Notifikasi pesan terjadwal                      | Tidak didukung   | Didukung        | Didukung               | Didukung            |
| Pesan DingTalk To-Do                            | Tidak didukung   | Didukung        | Didukung               | Didukung            |
| Kirim notifikasi pesan via layanan pihak ketiga | Tidak didukung   | Didukung        | Didukung               | Didukung            |

## 1. Pendahuluan

### 1.1 Ikhtisar fitur

<Note>
  Cakupan berlaku: Berlaku untuk **notifikasi pesan level halaman** pada **formulir biasa** dan **formulir alur kerja** (mendukung desainer alur kerja baru yang disederhanakan; tidak kompatibel dengan desainer alur kerja lanjutan versi lama). **Notifikasi pesan level platform** dan langkah notifikasi pesan pada **integrasi & otomatisasi / desainer alur kerja** belum mendukung kemampuan berikut.
</Note>

Untuk detail perbandingan peningkatan fitur, buka **Catatan Rilis**.

**Buat notifikasi dan templat**

Tersedia tujuh templat notifikasi pesan cepat. Klik **Gunakan templat ini** untuk mengaktifkannya dengan satu klik.

**Ikhtisar templat kartu:**

**Catatan: Gambar dalam pesan tidak boleh melebihi 2 MB dan tidak memiliki batasan dimensi.**

<table>
  <tr>
    <td>Notifikasi Kerja</td>
    <td>**Pesan teks biasa**<br />Cocok untuk Pesan teks biasa yang hanya berupa notifikasi dan tidak memerlukan tindakan.</td>
    <td>Untuk mengirim DingTalk To-Do, aktifkan Pengaturan lanjutan.<br />Formulir biasa<br />Formulir alur kerja</td>
  </tr>

  <tr>
    <td rowSpan={4}>Pesan grup / Pesan Langsung</td>
    <td>**Kartu detail gambar-teks**<br />Cocok untuk tampilan kartu gambar-teks dari Bidang formulir, dengan tautan untuk melihat detail pesan.</td>
    <td rowSpan={3}>**Saat mengirim ke Obrolan grup, grup tersebut harus berupa Obrolan Seluruh Staf atau Grup Internal.**</td>
  </tr>

  <tr>
    <td>**Kartu gambar-teks**<br />Cocok untuk Pesan kartu gambar-teks yang tidak memerlukan tindakan.</td>
  </tr>

  <tr>
    <td>**Kartu detail teks biasa**<br />Cocok untuk tampilan Kartu teks dari Bidang formulir, dengan tautan untuk melihat detail pesan.</td>
  </tr>

  <tr>
    <td>**Kartu komentar gambar-teks**<br />Cocok untuk tampilan Kartu teks biasa dari formulir, dengan dukungan Komentar pada detail formulir.</td>
    <td>Klik **Komentar** untuk langsung menuju area Komentar pada halaman detail formulir saat ini. Komentar yang dikirim akan disimpan di database.</td>
  </tr>

  <tr>
    <td rowSpan={2}>Sematan grup</td>
    <td>**Kartu sematan gambar-teks**<br />Cocok untuk Pesan kartu sematan gambar-teks yang tidak memerlukan tindakan.</td>
    <td rowSpan={2}>Setelah disematkan di grup, **sematan bertahan selama 1 hari**.</td>
  </tr>

  <tr>
    <td>**Kartu detail sematan teks biasa**<br />Cocok untuk Pesan kartu sematan teks biasa dari formulir, dengan tautan untuk melihat detail pesan.</td>
  </tr>
</table>

**Tipe penerima**

Tiga opsi Pengguna, Peran, dan Bidang digabungkan menjadi satu titik masuk. "Beri tahu berdasarkan Partisipan" diubah menjadi Bidang sistem.

### 1.2 Kasus penggunaan

**Notifikasi pesan** adalah prompt yang dikirim ke Pengguna atau Obrolan grup tertentu saat formulir dikirim atau diedit, saat alur kerja dimulai atau selesai, atau setelah tindakan diambil pada Langkah alur kerja lainnya.

**Catatan**:

* Notifikasi pesan formulir hanya dapat mengirim Pesan teks biasa (yaitu, Notifikasi Kerja DingTalk). Tidak dapat mengirim item DingTalk To-Do.

## 2. Panduan operasional

Contoh berikut menunjukkan cara mengirim notifikasi grup setelah formulir dikirim, agar Anda dapat merasakan fitur **notifikasi pesan** yang baru.

### 2.1 Langkah 1: Buat notifikasi pesan

**Jalur**: Klik formulir target / formulir alur kerja >> **Pengaturan** >> **Pengaturan halaman** >> **Notifikasi pesan** untuk masuk ke halaman pengaturan notifikasi pesan.

Buat notifikasi pesan.

### 2.2 Langkah 2: Pilih templat pesan

**Langkah:**

1. Pilih templat **Kartu detail gambar-teks** >> **Gunakan templat ini**. (Lihat Gambar 2.2-1)

Gambar 2.2-1 Memilih templat pesan

2. Konfigurasikan templat notifikasi pesan. (Lihat Gambar 2.2-2)

Gambar 2.2-2 Mengonfigurasi templat notifikasi pesan

### 2.3 Panduan konfigurasi

Setelah merasakan langsung fitur notifikasi pesan yang baru, mari kita telusuri setiap opsinya secara lebih rinci.

#### 2.3.1 Kondisi pemicu

Tersedia lima kondisi pemicu:

* Dibuat: Kirim notifikasi pesan saat entri formulir atau formulir alur kerja berhasil dikirim.
* Diedit: Kirim notifikasi pesan saat entri formulir yang telah dikirim berhasil diedit.
* Dihapus: Kirim notifikasi pesan saat entri formulir yang telah dikirim berhasil dihapus.
* Dikomentari: Kirim notifikasi pesan saat entri formulir yang telah dikirim berhasil dikomentari.
* Dikirim berdasarkan Bidang Tanggal formulir: Kirim notifikasi pesan berdasarkan nilai Komponen Tanggal pada formulir.

Kondisi pemicu.

#### 2.3.2 Penerima

Tipe penerima meliputi:

Pengguna / Peran / Bidang: Tentukan Pengguna atau Peran di Organisasi, atau Pengguna yang dipilih pada komponen anggota formulir (hanya Peran YiDA yang didukung untuk Peran).

Via layanan pihak ketiga: Pilih layanan pihak ketiga yang dikonfigurasi di bawah Manajemen platform > Registri layanan.

Grup saat ini: Obrolan grup tempat aplikasi saat ini diaktifkan.

**Catatan**:

* Penerima adalah gabungan dari semua Pengguna yang dikonfigurasi di atas. Jika orang yang sama muncul di beberapa kondisi, mereka hanya menerima notifikasi satu kali.
* Satu pesan dapat dikirim ke maksimal 100 penerima.

Tipe penerima.

#### 2.3.3 Konfigurasi konten

Konfigurasi Konten mengacu pada Judul pesan dan isi pesan notifikasi. Ada dua opsi:

**Kustom**: Anda dapat memasukkan nilai tetap untuk Judul dan Konten pesan secara manual, atau memilih Bidang dari formulir.

Konten notifikasi kustom.

**Gunakan templat notifikasi**: Pilih templat notifikasi yang telah dibuat sebelumnya di halaman manajemen Templat. Jika tidak ada Templat, klik **Manajemen templat** untuk membuatnya. Untuk detailnya, lihat [Notifikasi pesan](/id/yida/platform-admin/fkfhud).

Menggunakan templat notifikasi.

#### 2.3.4 Pesan terjadwal

Pesan terjadwal umumnya digunakan untuk Pengingat terjadwal berulang yang dikustomisasi. Interval dapat diatur mulai dari sekecil satu hari hingga sebesar satu tahun.

**Kasus penggunaan umum: pengingat hari jadi kerja karyawan, pengingat pemesanan rapat, pengingat makan di kafetaria.**

Terkonfigurasi berdasarkan Bidang Tanggal formulir.

**Catatan**: Aturan pengiriman hanya perlu dikonfigurasi jika kondisi pemicunya adalah **Dikirim berdasarkan Bidang Tanggal formulir**. Kondisi pemicu lainnya tidak memerlukannya.

Atur aturan pengingat tanggal.

Anda dapat menyesuaikan aturan Pengingat terjadwal, baik sebagai pengingat berulang maupun pengingat satu kali.

<Note>
  Saat ini hanya Bidang Komponen Tanggal pada formulir utama yang didukung sebagai kondisi pemicu notifikasi pesan. Bidang Komponen Tanggal pada subformulir dan formulir terkait belum didukung.
</Note>

**Contoh:**

① Jika waktu saat ini adalah pukul 10:00 pagi dan waktu mulai pengingat adalah pukul 9:00 pagi pada hari yang sama, ketika pengingat diatur hanya berbunyi sekali, tidak akan ada pengingat yang terpicu karena waktu saat ini sudah melewati waktu pengingat.

② Jika waktu saat ini adalah pukul 10:00 pagi pada 20 April 2021 dan waktu pengingat adalah pukul 9:00 pagi pada hari yang sama, ketika pengingat diatur berbunyi Harian, karena waktu saat ini sudah melewati waktu pengingat, pengingat berikutnya akan terpicu pada pukul 9:00 pagi pada 21 April 2021. (Ini bergantung pada waktu pengingat yang lebih awal daripada waktu berakhir.) Jika waktu berakhir pengingat adalah 20 April 2021, tidak ada pengingat yang akan terpicu pada pukul 9:00 pagi pada 21 April 2021.

**Tipe pengulangan**

| **Tipe pengulangan**                                                            | **Waktu mulai pengingat** | **Waktu berakhir pengingat** | **Deskripsi**                                                                                                                                                                                                                       |
| ------------------------------------------------------------------------------- | ------------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pengingat satu kali                                                             | 2021/4/20 15:00           | ——                           | Kirim pengingat sekali pada pukul 15:00 tanggal 20 April 2021.                                                                                                                                                                      |
| Pengingat Harian                                                                | 2021/4/20 15:00           | 2021/4/21 23:59              | Kirim pengingat pada pukul 15:00 tanggal 20 April 2021, dan kemudian setiap hari setelahnya (berikutnya pada pukul 15:00 tanggal 21 April 2021, dan seterusnya), hingga 2021-4-21 23:59:59.                                         |
| Pengingat Mingguan                                                              | 2021/4/20 15:00           | 2021/4/30 23:59              | Kirim pengingat pada pukul 15:00 tanggal 20 April 2021, dan kemudian setiap minggu setelahnya (berikutnya pada pukul 15:00 tanggal 27 April 2021, dan seterusnya), hingga 2021-4-30 23:59:59.                                       |
| Pengingat Setiap 2 minggu                                                       | 2021/4/20 15:00           | 2021/5/5 23:59               | Kirim pengingat pada pukul 15:00 tanggal 20 April 2021, dan kemudian setiap dua minggu setelahnya (berikutnya pada pukul 15:00 tanggal 4 Mei 2021, dan seterusnya), hingga 2021-5-5 23:59:59.                                       |
| Pengingat Bulanan                                                               | 2021/4/20 15:00           | 2021/6/20 23:59              | Kirim pengingat pada pukul 15:00 tanggal 20 April 2021, dan kemudian setiap bulan setelahnya (berikutnya pada pukul 15:00 tanggal 20 Mei 2021, dan seterusnya), hingga 2021-6-20 23:59:59.                                          |
| Pengingat Tahunan                                                               | 2021/4/20 15:00           | 2022/4/20 23:59              | Kirim pengingat pada pukul 15:00 tanggal 20 April 2021, dan kemudian setiap tahun setelahnya (berikutnya pada pukul 15:00 tanggal 20 April 2022, dan seterusnya), hingga 2022-4-20 23:59:59.                                        |
| Pengulangan kustom -<br />per minggu (setiap N minggu pada hari kerja tertentu) | 2021/4/20 15:00           | 2021/12/31 23:59             | Saat mengonfigurasi pengingat berulang kustom, Anda dapat menentukan satu atau beberapa hari dalam seminggu. Misalnya, atur pengingat hanya pada hari kerja Senin hingga Jumat, tanpa pengingat di akhir pekan.                     |
| Pengulangan kustom -<br />per bulan (setiap N bulan pada tanggal tertentu)      | <br />                    | 2021/12/31 23:59             | Pilih satu atau beberapa tanggal spesifik dalam sebulan untuk memicu pengingat. (Misalnya, jika Anda mengatur pengingat pada tanggal 31 setiap bulan, tidak ada pengingat yang dikirim untuk bulan yang tidak memiliki tanggal 31.) |

#### 2.3.5 Validitas notifikasi

(1) Aturan berlaku segera setelah dikonfigurasi dan diterapkan pada data formulir historis (terbatas pada 50.000 catatan terbaru).

(2) Jika Komponen Tanggal yang digunakan dalam notifikasi pesan dihapus dari formulir atau formulir alur kerja, tugas notifikasi pesan yang telah dikonfigurasi sebelumnya tetap berlaku. Untuk membatalkan pengiriman pesan, hapus konfigurasi notifikasi pesan yang bersangkutan.

### 2.4 Demonstrasi hasil

Gambar 2.3-1 Demonstrasi hasil notifikasi pesan.

### 2.5 Catatan

DingTalk memberlakukan pembatasan tambahan pada notifikasi pesan, termasuk:

1. DingTalk memfilter pesan dengan Konten dan Judul yang identik. Setiap Pengguna hanya menerima notifikasi pesan berulang satu kali per hari.

**Solusi**: Pada templat notifikasi pesan, sertakan Konten Bidang formulir yang berubah pada setiap notifikasi. Sintaks referensinya adalah `$!{form field unique identifier}`.

1. DingTalk membatasi jumlah Notifikasi Kerja yang diterima setiap Pengguna per hari. Di YiDA, batasnya adalah 2.000 pesan per Pengguna per hari. Lihat **Batas pesan DingTalk** untuk detailnya.
2. Jika Pengingat terjadwal dikonfigurasi tetapi tanggal berakhir tidak diisi saat formulir dikirim, notifikasi pesan tidak akan terpicu.
3. Saat Pesan kartu dikirim ke pesan grup atau sematan grup, perhatikan tiga poin berikut:

* Bot asisten YiDA dapat mengirim hingga 20 pesan per grup per menit.
* Setelah disematkan di grup, sematan bertahan selama 1 hari.
* Saat Pesan kartu formulir alur kerja dikirim ke grup (pesan grup atau sematan grup), pengiriman DingTalk To-Do secara bersamaan tidak didukung.

## 3. FAQ

<AccordionGroup>
  <Accordion id="q1" title="3.1 Bagaimana cara mengirim pesan ke grup saat ini?">
    (1) Buka Obrolan Seluruh Staf, Obrolan Departemen, atau Grup Internal tempat YiDA diaktifkan >> **Lainnya** >> **YiDA**.

    (2) Pilih aplikasi yang ingin Anda kirimi notifikasi, lalu aktifkan.
  </Accordion>

  <Accordion id="q2" title="3.2 Saya mengonfigurasi notifikasi sematan grup, tetapi mengapa tidak ditampilkan tersemat?">
    Kartu tersemat dalam grup hanya ditampilkan selama 1 hari. Setelah 1 hari, kartu tidak lagi tersemat.
  </Accordion>

  <Accordion id="q3" title="3.3 Apakah peningkatan pesan cepat akan memengaruhi notifikasi pesan yang sudah ada?">
    Tidak. Notifikasi Kerja secara otomatis dikonversi menjadi Notifikasi Kerja, dan item Tugas secara otomatis dikonversi menjadi item DingTalk To-Do.
  </Accordion>

  <Accordion id="q4" title="3.4 Mengapa sistem menampilkan peringatan bahwa panjang pesan tidak boleh melebihi 50 karakter?">
    Judul pesan mendukung maksimum 50 karakter.
  </Accordion>

  <Accordion id="q5" title="3.5 Mengapa sistem menampilkan bahwa Pengaturan lanjutan diaktifkan dan tidak dapat dinonaktifkan?">
    Setelah Anda mengaktifkan **Pengaturan lanjutan** dan mengklik **Konfirmasi** untuk menyimpan, opsi tersebut tidak dapat dinonaktifkan.
  </Accordion>

  <Accordion id="q6" title="3.6 Bagaimana cara mengatur notifikasi ke DingTalk To-Do saat menggunakan kartu templat?">
    Jika formulir alur kerja Anda perlu mengirim notifikasi ke DingTalk To-Do, saat menggunakan kartu templat, aktifkan **Pengaturan lanjutan** lalu pilih **DingTalk To-Do**.

    **Catatan:**

    * Hanya templat Notifikasi Kerja pertama yang dapat dikonfigurasi untuk mengirim DingTalk To-Do.
    * Setelah Anda mengaktifkan **Pengaturan lanjutan** dan mengklik **Konfirmasi** untuk menyimpan, opsi tersebut tidak dapat dinonaktifkan.
  </Accordion>

  <Accordion id="q7" title="3.7 Mengapa saya tidak dapat memilih Obrolan grup dari Organisasi lain saat memilih grup tertentu?">
    Pesan grup hanya dapat dikirim ke Obrolan Seluruh Staf dan Grup Internal dalam Organisasi yang sama. Tipe grup lainnya tidak didukung.

    Anda dapat melihat tipe grup pada lokasi yang ditunjukkan pada Tangkapan Layar di bawah.
  </Accordion>

  <Accordion id="q8" title="3.8 Bagaimana cara menghapus aplikasi grup?">
    Klik Obrolan grup >> **Lainnya** >> plugin yang ditambahkan oleh Anggota grup >> ikon minus di sebelah Nama aplikasi.

    Catatan: Jika Anda mengonfigurasi notifikasi pesan ke grup saat ini, Anda juga dapat membatalkan pengiriman pesan dengan menghapus aplikasi grup.
  </Accordion>

  <Accordion id="q9" title="3.9 Apakah data yang diimpor secara massal dapat memicu notifikasi pesan?">
    Ya. Saat mengimpor, pilih opsi untuk memicu aturan validasi, aturan bisnis terkait, dan callback layanan pihak ketiga secara bersamaan.

    **Catatan: Ini adalah fitur berbayar.**
  </Accordion>

  <Accordion id="q10" title="3.10 Mengapa notifikasi pesan dan aturan Tugas yang dikonfigurasi pada formulir alur kerja tidak berlaku?">
    Pastikan Anda telah menerbitkan Versi baru alur kerja setelah mengonfigurasi aturan.
  </Accordion>
</AccordionGroup>

### 3.11 Aturan pesan terjadwal berdasarkan Tanggal formulir telah mencapai waktu pemicunya tetapi tidak ada notifikasi yang dikirim

Setelah aturan pesan terjadwal disimpan, aturan tersebut hanya berlaku untuk data yang baru dikirim atau baru diedit. Data historis yang tidak diedit ulang tidak akan memicu aturan tersebut.
