Panduan ini memberikan ikhtisar mendetail mengenai kemampuan inti, instalasi, dan penggunaan Skill Pengiriman Pesan Chat App. Skill ini memungkinkan Anda mengirim pesan WhatsApp, menanyakan templat, dan mengelola sesi secara langsung dalam suatu agen, sehingga tidak perlu berpindah antar konsol atau menyusun permintaan API secara manual.
Prasyarat
Anda memiliki ID AccessKey dan Secret AccessKey untuk sub-akun Alibaba Cloud. Akun utama membuat pengguna di Konsol RAM dan memberikan izin Chat App Message Service (CAMS) yang diperlukan.
Anda telah mengaktifkan Konsol Chat App Message Service dan menyelesaikan operasi berikut:
Bind akun WhatsApp Business (WABA).
Daftarkan dan dapatkan persetujuan untuk nomor telepon pengirim (From).
Buat dan dapatkan persetujuan untuk templat pesan (wajib untuk mengirim pesan templat).
1. Kemampuan dan keunggulan
Skill Pengiriman Pesan Chat App Alibaba Cloud mengemas fitur pengiriman pesan WhatsApp, kueri templat, dan manajemen sesi ke dalam sebuah tool yang dapat dipanggil oleh agen. Hal ini memungkinkan Anda mengirim notifikasi, menjalankan kampanye pemasaran, dan berinteraksi dengan pelanggan langsung dari agen, tanpa perlu berpindah konsol atau menyusun muatan JSON secara manual.
Kemampuan | Deskripsi |
Kirim pesan templat | Kirim pesan templat WhatsApp di luar jendela sesi 24 jam. Fitur ini mendukung penggantian variabel untuk skenario seperti notifikasi pemasaran, pembaruan status pesanan, kode verifikasi, dan pengingat logistik. |
Kirim pesan kustom | Kirim pesan bebas selama dalam jendela sesi 24 jam. Mendukung tujuh jenis pesan: teks, gambar, video, audio, dokumen, interaktif, dan lokasi. |
Daftar templat kueri | Filter templat berdasarkan status persetujuan, jenis, atau bahasa, memungkinkan agen memilih templat secara otomatis atau menampilkan opsi kepada pengguna. |
Detail Templat Kueri | Ambil struktur variabel dari templat tertentu. Hal ini memungkinkan agen membimbing pengguna mengisi parameter satu per satu, mencegah ketidaksesuaian jumlah dan format parameter. |
Keunggulan utama:
Pengiriman pesan percakapan: Anda dapat menggunakan bahasa alami untuk menanyakan templat, mengisi variabel, dan mengirim pesan langsung melalui tool agen seperti Claude Code, Qwen Coder, dan OpenClaw, sehingga tidak perlu sering mengakses konsol.
Penyusunan parameter yang disederhanakan: Agen secara otomatis menyusun JSON yang valid dan membantu pencocokan variabel, menghindari format ketat yang diperlukan oleh panggilan API tradisional di mana satu kesalahan saja dapat menyebabkan kegagalan.
Diagnostik error otomatis: Skill ini menyediakan diagnostik bawaan dan menyarankan solusi untuk kode kesalahan umum. Misalnya, jika terjadi error
SessionWindowExpired, Skill secara otomatis beralih ke alur kerja pesan templat. Jika izin RAM tidak mencukupi, Skill ini bekerja sama dengan Skillram-permission-diagnoseuntuk membimbing Anda melalui proses pengajuan izin.Konfirmasi sebelum pengiriman: Agen memastikan akurasi dengan meminta konfirmasi eksplisit dari pengguna untuk semua parameter yang dapat dikustomisasi sebelum mengirim, dan tidak pernah mengasumsikan nilai default.
2. Instalasi
Alibaba Cloud Skill Marketplace
Buka Alibaba Cloud Skill Marketplace, cari "Chat App Message Sending", lalu instal Skill tersebut.
ClawHub
Buka platform ClawHub, cari "alibabacloud-chatapp-message-send" untuk melihat detail Skill dan menginstalnya.
Metode lain
ClaudeCode
Untuk informasi lebih lanjut, lihat dokumentasi resmi Claude Code.
Ekstrak paket Skill yang diunduh dan pindahkan direktorinya ke folder skill Claude Code:
Untuk cakupan global (semua proyek): Pindahkan Skill ke direktori
~/.claude/skills/.Untuk cakupan tingkat proyek (proyek saat ini saja): Pindahkan Skill ke direktori
project_root/.claude/skills/.
Setelah memindahkan direktori, restart Claude Code agar perubahan diterapkan.
OpenClaw
Ekstrak paket Skill yang diunduh dan salin path ke direktori Skill tersebut. Di OpenClaw, masukkan path tersebut dan minta agen, "Bantu saya menginstal Skill di direktori ini." Tunggu hingga muncul pesan konfirmasi bahwa instalasi telah selesai sebelum menggunakan Skill tersebut.
3. Penyiapan
1. Aliyun CLI >= 3.3.3
Jalankan aliyun version untuk memeriksa versi saat ini. Jika Aliyun CLI belum terinstal atau versi Anda lebih lama dari 3.3.3:
# Di macOS atau Linux, jalankan perintah ini untuk menginstal atau meningkatkan ke versi terbaru.
curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash
# Verifikasi bahwa versinya 3.3.3 atau lebih baru.
aliyun versionPenting: Sebelum menggunakan CLI, aktifkan instalasi plugin otomatis dan AI-Mode:
aliyun configure set --auto-plugin-install true
aliyun plugin update
aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent \
--user-agent "AlibabaCloud-Agent-Skills/alibabacloud-chatapp-message-send"Penting: Anda harus menonaktifkan AI-Mode ketika sesi berakhir karena alasan apa pun, seperti penyelesaian tugas, error, atau keluar. Selalu jalankan aliyun configure ai-mode disable sebelum keluar.
2. Instal plugin CAMS
aliyun plugin install --names aliyun-cli-cams3. Kredensial
Aturan keamanan:
JANGAN PERNAH membaca, menampilkan, atau mencetak nilai ID AccessKey atau Secret AccessKey.
JANGAN PERNAH meminta pengguna memasukkan ID AccessKey atau Secret AccessKey mereka secara langsung dalam percakapan atau di command line.
JANGAN PERNAH menggunakan
aliyun configure setdengan kredensial dalam bentuk teks biasa.HANYA gunakan
aliyun configure listuntuk memeriksa status kredensial.
aliyun configure listPeriksa output perintah untuk profil yang valid, seperti AccessKey, STS, atau OAuth. Jika tidak ada profil valid, hentikan proses dan peroleh kredensial dari Konsol RAM. Konfigurasikan di luar sesi saat ini menggunakan aliyun configure atau variabel lingkungan sebelum kembali ke prosedur ini.
4. Izin RAM
Skill ini memerlukan aksi RAM berikut:
API | Action | Deskripsi |
SendChatappMessage | cams:SendChatappMessage | Kirim pesan |
SendChatappMassMessage | cams:SendChatappMassMessage | Kirim pesan secara batch |
ListChatappTemplate | cams:ListChatappTemplate | Kueri daftar templat |
GetChatappTemplateDetail | cams:GetChatappTemplateDetail | Kueri detail templat |
ListChatappMessage | cams:ListChatappMessage | Kueri daftar pesan |
JSON kebijakan izin minimum:
{
"Version": "1",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cams:SendChatappMessage",
"cams:SendChatappMassMessage",
"cams:ListChatappTemplate",
"cams:GetChatappTemplateDetail",
"cams:ListChatappMessage"
],
"Resource": "*"
}
]
}4. Penggunaan
Fitur inti
Secara percakapan menanyakan daftar templat dan detailnya untuk mengambil templat yang tersedia beserta struktur variabelnya.
Otomatis mengirim pesan templat dan pesan kustom, memungkinkan Anda menjangkau pengguna baik di dalam maupun di luar jendela sesi 24 jam.
Mendeteksi kedaluwarsa jendela sesi dan secara otomatis beralih ke alur kerja pesan templat.
Dukungan untuk templat multi-bahasa, seperti en, zh_CN, dan zh_HK.
Dukungan untuk skenario multi-tenant bagi vendor perangkat lunak independen (ISV) menggunakan parameter
--cust-space-id.
5. Kasus penggunaan
Notifikasi pesanan internasional
Kasus penggunaan umum dalam bisnis internasional termasuk mengirim notifikasi pengiriman, pembaruan logistik, dan konfirmasi pembayaran.
Sebelumnya, staf operasional harus mencari templat, mengisi variabel, dan menyiapkan nomor telepon sebelum mengirim pesan dari konsol atau skrip. Dengan Skill ini, Anda cukup menyampaikan kebutuhan Anda kepada agen, yang kemudian membantu mencocokkan templat, melengkapi variabel, mengirim pesan, dan melaporkan hasilnya.
Penjangkauan kampanye pemasaran
Dalam kampanye pemasaran internasional, WhatsApp sering digunakan untuk pengumuman produk baru, pengingat promosi, dan re-engagement pelanggan.
Perhatikan bahwa pesan templat WhatsApp harus disetujui terlebih dahulu; Skill ini tidak memperpendek siklus tinjauan templat Meta. Namun, setelah templat disetujui, agen membantu Anda menggunakannya lebih efisien dengan secara otomatis memvalidasi format nomor telepon, memeriksa kecocokan templat, memproses daftar pelanggan, mencocokkan variabel, mengirim pesan secara batch, dan meninjau hasilnya.
Tindak lanjut layanan pelanggan
Dalam layanan pelanggan, jendela sesi 24 jam adalah aturan penting. Setelah pelanggan memulai percakapan, bisnis dapat mengirim pesan bebas selama dalam jendela tersebut. Di luar jendela itu, pesan templat wajib digunakan.
Skill ini membantu agen menentukan apakah akan menggunakan pesan bebas atau pesan templat dan merekomendasikan metode yang tepat. Hal ini mengurangi kebutuhan interpretasi dan penilaian aturan secara manual oleh staf dukungan, membantu mencegah kegagalan pengiriman dan pengulangan.
6. FAQ
Tool agen AI mana yang didukung oleh Skill ini?
Saat ini mendukung tool yang mengikuti standar Agent Skills, seperti Claude Code, Cursor, OpenClaw, Qoderwork, dan Wukong. Kami sedang mengembangkan dukungan untuk lebih banyak platform.
Apa perbedaan antara kemampuan Skill ini dan konsol?
Skill ini saat ini mendukung pengiriman pesan templat, pengiriman pesan kustom, kueri daftar templat, dan kueri detail templat. Anda tetap harus membuat templat di konsol.
Bisakah saya mengirim pesan tanpa mendaftarkan akun?
Tidak. Anda harus mendaftarkan akun Alibaba Cloud, mengaktifkan Chat App Message Service (CAMS), mengikat WABA Anda, mendaftarkan nomor telepon pengirim, dan mendapatkan persetujuan untuk templat pesan Anda.
Bisakah pengguna individu menggunakan layanan ini?
WhatsApp Business API memerlukan kredensial bisnis. Pengguna individu hanya dapat menggunakan layanan ini jika mereka menyediakan informasi bisnis yang valid. Layanan ini tidak mendukung kredensial pribadi untuk mengirim pesan.
Apakah variabel templat perlu diisi dalam format tertentu?
Ya. Variabel templat harus diisi secara berurutan secara numerik, misalnya, 1=value1 2=value2 3=value3. Agen membimbing Anda untuk mengonfirmasi masing-masing agar mencegah ketidaksesuaian jumlah atau format.
Templat jenis apa yang dapat saya gunakan untuk mengirim pesan?
Anda dapat menggunakan templat apa pun yang memiliki status "Approved" dan bahasa yang sesuai dengan bahasa pengguna target. Jalankan list-chatapp-template --audit-status pass untuk menanyakan templat yang telah disetujui.
Bisakah saya mengirim pesan ke beberapa pengguna sekaligus?
Ya. Untuk mengirim pesan ke beberapa pengguna, berikan daftar nomor telepon target kepada agen.
Apakah pesan kustom hanya dapat dikirim dalam jendela sesi 24 jam?
Ya. Pesan WhatsApp kustom hanya dapat dikirim dalam waktu 24 jam sejak pesan terakhir pengguna. Setelah periode ini, Anda akan menerima error SessionWindowExpired. Saat hal ini terjadi, agen secara otomatis beralih ke alur kerja pesan templat.
7. Kode kesalahan
Kode kesalahan | Deskripsi | Solusi |
InvalidParameter.FromOnlyNumeric | Nomor telepon berisi tanda plus (+). | API hanya menerima angka. Hapus tanda plus (+). Contohnya, gunakan |
TemplateNotFound | Templat tidak ada. | Periksa nilai |
TemplateParamInvalid | Variabel templat tidak valid. | Periksa apakah jumlah dan format variabel sesuai dengan templat. |
SessionWindowExpired | Jendela sesi 24 jam telah kedaluwarsa. | Beralih ke alur kerja pesan templat. |
PhoneNumberNotRegistered | Nomor telepon pengirim belum terdaftar. | Selesaikan proses pendaftaran dan persetujuan nomor telepon di konsol. |
Forbidden.RAM | Izin RAM tidak mencukupi. | Gunakan Skill |
InvalidAccessKeyId.NotFound | ID AccessKey salah. | Periksa ID AccessKey Anda. |
SignatureDoesNotMatch | Secret AccessKey salah. | Periksa Secret AccessKey Anda. |
Penanganan izin otomatis: Jika perintah gagal karena izin RAM tidak mencukupi, Skill secara otomatis membaca references/ram-policies.md dan memanggil Skill ram-permission-diagnose untuk membimbing Anda melalui proses pemberian izin yang diperlukan. Perintah asli dilanjutkan setelah Anda memberikan izin tersebut.