Panduan produk
Peringatan
Peringatan menghantar mesej WhatsApp yang sama ke nombor atau kumpulan mengikut jadual berulang, seperti setiap hari bekerja pada 9:00 pagi atau pada 1 haribulan setiap bulan. Gunakannya untuk peringatan bayaran, semakan pasukan atau kemas kini berkala.
Bukanya dari Tools → Recurrent Reminders di bar sisi, atau pergi ke /reminders/.
Sebelum anda bermula#
- Pelan yang termasuk peringatan. Jika tidak, penyimpanan menunjukkan "Upgrade your plan to use reminders feature".
- Nombor WhatsApp yang menunjukkan Connected di WhatsApp settings.
- Kredit dalam pelan anda. Setiap kali peringatan berjalan, ia menggunakan satu mesej.
Cipta peringatan#
Kad Create New Reminder berada di bahagian atas halaman. Jika ia dikuncupkan, klik butang anak panah pada kad untuk mengembangkannya.
Namakan
Masukkan Reminder Name (Nama peringatan), seperti
Daily Follow-up.Pilih jenis mesej
Pilih Message Type: Text Message, Image + Text Message atau File + Text Message, dan isikan Image URL atau File URL. Penerima melihat bahagian terakhir pautan fail sebagai nama fail.
Pilih nombor penghantar (pilihan)
Di bawah WhatsApp Account, pilih nombor yang bersambung, atau biarkan Select WhatsApp Account (Optional) untuk menggunakan nombor bersambung pertama anda setiap kali peringatan berjalan.
Masukkan penerima
Dalam Phone Number / Group Name, masukkan nombor dengan kod negara dan digit sahaja, seperti
919876543210, atau nama tepat kumpulan WhatsApp.Tetapkan jadual
Di bawah Schedule (Cron Expression), pilih pratetap atau Custom Cron Expression. Lihat Pilihan jadual.
Pilih zon waktu
Pilih Timezone (Zon waktu) bagi jadual anda. Pilihan terakhir anda diingati untuk kali seterusnya.
Tulis mesej dan simpan
Tulis Message Template, secara pilihan dengan pemboleh ubah, dan klik Create Reminder. Anda melihat "Reminder created successfully".
Pilihan jadual#
Jadual ialah ungkapan cron: lima nilai untuk minit, jam, hari dalam bulan, bulan dan hari dalam minggu, dipisahkan dengan ruang. Hari dalam minggu bermula dari 0 (Ahad) hingga 6 (Sabtu). Cron Helper di halaman menyenaraikan contoh, dan Cron Generator membuka crontab.guru untuk membinanya.
| Pratetap | Ungkapan |
|---|---|
| Daily at 9:00 AM (Setiap hari, 9:00 pagi) | 0 9 * * * |
| Weekly on Monday at 9:00 AM (Setiap Isnin, 9:00 pagi) | 0 9 * * 1 |
| Monthly on 1st at 9:00 AM (Setiap 1 haribulan, 9:00 pagi) | 0 9 1 * * |
| Every 6 hours (Setiap 6 jam) | 0 */6 * * * |
| Weekdays at 9:00 AM (Hari bekerja, 9:00 pagi) | 0 9 * * 1-5 |
Contoh lain:
| Ungkapan | Berjalan |
|---|---|
0 0 * * * | Setiap tengah malam |
30 8 * * 1-5 | 8:30 pagi pada hari bekerja |
0 */3 * * * | Setiap 3 jam |
0 12 1,15 * * | 12 tengah hari pada 1 dan 15 haribulan |
Dalam ungkapan, * bermaksud sebarang nilai, / menetapkan langkah, - julat dan , senarai.
Zon waktu#
Jadual berjalan dalam zon waktu yang anda pilih, dan waktu jimat siang diikuti secara automatik. Lajur Next Run menunjukkan masa seterusnya dalam zon waktu itu. Senarai itu termasuk UTC, zon AS dan Kanada, Europe/London, Paris dan Berlin, Asia/Kolkata, Dubai, Shanghai dan Tokyo, Australia/Sydney dan America/Sao_Paulo.
Peringatan disemak setiap minit, dan mesej dimasukkan ke baris gilir apabila minit yang dijadualkan tiba. Jika semakan berjalan lewat, larian itu masih dimasukkan ke baris gilir sehingga 10 minit selepas masa yang dijadualkan (1 minit bagi larian pertama peringatan), dan tidak pernah dua kali. Ia kemudian dihantar sebaik sahaja nombor penghantar lapang.
Pemboleh ubah mesej#
Pemegang tempat ini digantikan setiap kali peringatan berjalan. Tulisnya dengan kurungan kurawal tunggal, tepat seperti yang ditunjukkan:
| Pemboleh ubah | Digantikan dengan | Contoh |
|---|---|---|
{reminder_name} | Nama peringatan | Daily Follow-up |
{to_number} | Penerima seperti yang dimasukkan | 919876543210 |
{organisation_name} | Nama ruang kerja anda | Acme Store |
{client_name} | Nama pemilik ruang kerja | Aman |
{current_date} | Tarikh dalam zon waktu peringatan | 2026-09-16 |
{current_date_formatted} | Tarikh panjang, dengan hari berpad sifar | September 06, 2026 |
{current_time} | Masa 24 jam | 09:00:00 |
{current_time_12h} | Masa 12 jam | 09:00 AM |
{current_datetime} | Tarikh dan masa | 2026-09-16 09:00:00 |
{timezone} | Nama zon waktu | Asia/Kolkata |
{timezone_short} | Singkatan zon waktu | IST |
Contohnya, Good morning team, here's the plan for {current_date_formatted}.
Urus peringatan#
Your Reminders menyenaraikan setiap peringatan dengan Name, To, Type, Schedule, Next Run, Status (Active atau Inactive) dan masa Created (UTC). Butang Actions ialah ikon; letakkan tetikus di atasnya untuk melihat namanya:
| Butang | Fungsinya |
|---|---|
| Edit (pensel) | Membuka Edit Reminder untuk menukar nama, jenis, penerima, URL imej atau fail, jadual, zon waktu atau mesej, dan untuk menjeda atau menyambung semula dengan kotak semak Active. Jadual di sana ialah kotak teks biasa untuk ungkapan cron, tanpa pratetap. Klik Update Reminder untuk menyimpan. |
| Clone (dua segi empat) | Menunjukkan butiran peringatan. Yes, clone it! menyalinnya ke borang cipta dengan "(Copy)" ditambah pada nama, sedia untuk diubah dan disimpan. |
| Toggle Status (ikon kuasa) | Menjeda peringatan aktif atau menyambung semula peringatan tidak aktif. |
| Delete (tong sampah) | Bertanya "Are you sure you want to delete this reminder?". Klik Yes, delete it!. |
Memadam atau menjeda peringatan tidak membatalkan mesej yang telah dimasukkannya ke baris gilir. Batalkan mesej itu di halaman Reports.
Import peringatan dari fail#
Sediakan fail
Klik CSV Upload, kemudian Sample Format untuk melihat lajur, dan muat turun fail contoh. Isikan satu peringatan bagi setiap baris. Jangan muat naik fail contoh begitu sahaja: pautan imej dan failnya (
example.com) ialah pemegang tempat yang tidak boleh dimuat turun, jadi gantikannya dengan pautan anda sendiri atau padam baris tersebut. Fail itu juga tiada lajurtimezone, dan nilaiwhatsapp_client_idnya (1,2) bukan milik anda, jadi baris tersebut menggunakan nombor bersambung pertama anda.Muat naik
Dalam Upload Reminders CSV, pilih fail
.csv,.xlsatau.xlsxanda dan klik Upload Reminders.Semak hasilnya
Anda melihat "Successfully created N reminders." dengan bilangan baris yang dilangkau. Peringatan yang diimport bermula sebagai Active.
| Lajur | Wajib | Nilai |
|---|---|---|
reminder_name | Ya | Nama untuk peringatan. |
phone | Ya | Nombor dengan kod negara, atau nama kumpulan. +, ruang, sengkang, kurungan dan 0 di hadapan dibuang. |
message | Ya | Teks mesej. Pemboleh ubah juga berfungsi di sini. |
cron_expression | Ya | Jadual, seperti 0 9 * * *. |
timezone | Tidak | Nama zon waktu seperti Asia/Kolkata. Kosong bermaksud UTC. Singkatan seperti IST tidak diterima. Lihat Rujukan zon waktu. |
msg_type | Tidak | 0 teks (lalai), 1 imej atau 2 fail. |
img_url | Tidak | Pautan imej, wajib apabila msg_type ialah 1. |
file_url | Tidak | Pautan fail sehingga 100 aksara, wajib apabila msg_type ialah 2. |
whatsapp_client_id | Tidak | Whatsapp Client ID nombor yang bersambung. Kosong, tidak dikenali atau tidak bersambung pada masa itu bermaksud nombor bersambung pertama anda setiap kali peringatan berjalan. |
Sesuatu baris dilangkau apabila jadual atau zon waktunya tidak sah, apabila msg_type ialah 1 tanpa img_url, apabila msg_type ialah 2 tanpa file_url, atau apabila file_url lebih panjang daripada 100 aksara. Nilai msg_type lain dianggap sebagai teks.
Penyelesaian masalah#
| Mesej atau masalah | Apa yang perlu dilakukan |
|---|---|
| "name is required", "to_whatsapp_number is required", "message_template is required" atau "cron_expression is required" | Isikan medan yang tiada. |
| "Invalid cron expression" | Gunakan lima nilai yang dipisahkan dengan ruang. Cuba Cron Generator. |
| "Image URL is required for image messages" | Tambah Image URL, atau tukar kepada Text Message. |
| "Invalid WhatsApp client" | Nombor yang dipilih telah terputus. Muat semula halaman dan pilih nombor yang bersambung. |
| "Invalid timezone" | Pilih zon waktu daripada senarai. |
| "File URL is required for file messages" | Tambah File URL, atau tukar kepada Text Message. |
| "Error creating reminder: value too long…" atau "Error updating reminder: value too long…" | File URL melebihi 100 aksara. Gunakan pautan yang lebih pendek, atau cipta peringatan melalui API. |
| Peringatan fail yang dicipta melalui API berhenti melampirkan failnya | Ia telah diedit atau diklon dalam papan pemuka, yang membuang pautan fail. Batalkannya dan cipta semula dengan API cipta peringatan. |
| "Please select a CSV file to upload." | Pilih fail dalam Upload Reminders CSV dahulu. |
| "Invalid file format. Only CSV, XLS, and XLSX files are supported." | Simpan fail sebagai .csv, .xls atau .xlsx. |
| "An error occurred while uploading the CSV file" | Semak sambungan anda, muat semula halaman dan muat naik semula. |
| "Missing required columns: …" | Tambah pengepala lajur yang disenaraikan ke fail anda, dieja dengan tepat. |
| "No valid reminders found in the CSV file. Please check the format and data." | Semak jadual, zon waktu, URL imej dan URL fail dalam setiap baris. |
| Peringatan tidak dihantar | Pastikan status Active, Next Run seperti yang dijangka, ada nombor yang Connected, dan anda masih mempunyai kredit. Larian dilangkau apabila anda tiada kredit. Jika peringatan tiada nombor penghantar yang dipilih, larian juga dilangkau apabila tiada nombor bersambung. Jika anda memilih nombor tertentu dan ia terputus, mesej tetap dimasukkan ke baris gilir dan menunggu sebagai belum selesai. Jika peringatan lama menunjukkan Active tetapi tidak pernah menghantar, klik Toggle Status dua kali (jeda, kemudian sambung semula). |
| Dihantar pada masa yang salah | Semak Timezone dan jam dalam ungkapan cron. |
| Mesej ke kumpulan gagal | Gunakan nama kumpulan yang tepat, dan pastikan nombor penghantar ialah ahli. |