--- title: "Cara Menginstal YCloud Developer Kit dan Membangun Integrasi WhatsApp API di Codex" description: "Pelajari cara memasang YCloud Developer Kit di Codex dan menggunakannya untuk merencanakan, membangun, dan menguji integrasi API WhatsApp secara end-to-end." canonical: "https://www.ycloud.com/id/blog/how-to-install-ycloud-developer-kit-with-codex" language: "id" datePublished: "2026-10-09T15:59:12.396Z" dateModified: "2026-10-09T16:01:41.589Z" author: "Team YCloud" categories: - "Pengembang👨‍💻" --- # Cara Menginstal YCloud Developer Kit dan Membangun Integrasi WhatsApp API di Codex ![YC Dev. Kit YCloud Developer Kit- Installation + WhatsApp Integration.png](https://static-blog.ycloud.com/YC_Dev_Kit_Y_Cloud_Developer_Kit_Installation_Whats_App_Integration_e7930dff89.png) **Berapa banyak pekerjaan yang diperlukan untuk memulai integrasi YCloud di Codex?** YCloud Developer Kit membawa keterampilan integrasi spesifik YCloud ke dalam Codex. Untuk menunjukkan cara kerjanya, artikel ini menggunakan alur kerja konfirmasi pesanan WhatsApp yang terfokus dengan data yang disimulasikan. Anda akan menginstal dan memverifikasi Kit, kemudian menggunakan satu perintah untuk merencanakan integrasi, mengimplementasikannya secara lokal, dan menjalankan tes simulasi. > **Untuk kemampuan yang didukung, panduan keamanan, dan pertimbangan produksi, baca** [**YCloud Developer Kit: Membangun dan Menguji Integrasi WhatsApp API dengan Codex**](https://www.ycloud.com/blog/ycloud-developer-kit-whatsapp-api-integration)**.** ## Cara Menginstal YCloud Developer Kit di Codex ### Langkah 1: Buka YCloud Developer Kit Buka [**halaman plugin YCloud Developer Kit**](https://chatgpt.com/plugins/plugins_6a9669d9e57c8191a04a3c8951e44401?search=ycloud). Pilih **Instal** atau **Coba sekarang**, dan pastikan Kit diaktifkan di lingkungan Codex tempat Anda berencana menggunakannya. ![Find and Enable YCloud Developer Kit](https://static-blog.ycloud.com/1_Find_and_Enable_Y_Cloud_Developer_Kit_8b834184cc.png) ### Langkah 2: Instal Kit di Proyek Codex Anda Buka proyek target di Codex dan jalankan: ```plaintext npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a codex --copy -y ``` Perintah ini menginstal keterampilan YCloud di proyek saat ini. Setelah penginstalan, mulai sesi Codex baru agar dapat menemukan keterampilan yang baru diinstal. > **Lihat** [**instruksi penginstalan YCloud Developer Kit**](https://github.com/YCloud-Developers/YCloud-Developer-Kit?tab=readme-ov-file#%E4%B8%80%E6%AC%A1%E5%AE%89%E8%A3%85%E6%95%B4%E5%A5%97%E6%8A%80%E8%83%BD) **untuk detail pengaturan lengkap.** ![YCloud Developer Kit Plugin Overview](https://static-blog.ycloud.com/2_Y_Cloud_Developer_Kit_Plugin_Overview_5c150eef48.png) ### Langkah 3: Verifikasi Instalasi Dalam tugas Codex baru, masukkan: ```plaintext Use $ycloud-developer-kit-smoke-test to check whether the plugin is ready. ``` **Respons yang diharapkan adalah:** ```plaintext YCloud Developer Kit is ready. No external API was called. ``` Ini mengonfirmasi bahwa Codex dapat menemukan dan menggunakan Kit. Ini tidak memvalidasi kredensial akun YCloud atau mengirim pesan WhatsApp. ![Verify the Plugin with the Smoke Test](https://static-blog.ycloud.com/3_Verify_the_Plugin_with_the_Smoke_Test_9486615e28.png) Setelah smoke test berhasil, Kit siap untuk bekerja pada persyaratan integrasi yang ditentukan. ## Cara Membangun Integrasi Konfirmasi Pesanan WhatsApp ### Apa yang Kita Bangun? **Pertimbangkan alur kerja konfirmasi pesanan:** - *Pelanggan melakukan pemesanan.* - *Backend menyiapkan konfirmasi WhatsApp.* - *Pesan tersebut dikaitkan dengan pesanan.* - *Peristiwa pengiriman atau kegagalan selanjutnya memperbarui catatan notifikasi.* Untuk contoh ini, aplikasi menggunakan Node.js, Express, dan SQLite. Semua pesanan, respons YCloud, dan event Webhook disimulasikan. Siaran pemasaran, pesan masuk, dan manajemen kampanye berada di luar contoh ini. ### Langkah 1: Jelaskan Persyaratan dalam Codex Alih-alih memilih API atau keterampilan individu, mulailah dengan menjelaskan keseluruhan alur kerja bisnis: ```plaintext Use $ycloud-integration-architect to build a local WhatsApp order-confirmation integration. Our backend uses Node.js, Express and SQLite. When a customer places an order: - Prepare a WhatsApp order-confirmation message - Associate the message with the order - Process later delivery or failure events - Prevent duplicate Webhook events from causing repeated updates Implement the workflow in the current local project and add tests. Use fictional orders and simulated YCloud responses. Do not read real credentials or call real APIs. After completing the work, provide: 1. The integration flow 2. Changed files 3. Configuration placeholders 4. Executed tests and actual results 5. Items that still require verification with YCloud ``` Prompt tunggal ini mendefinisikan tujuan bisnis, tumpukan teknologi, alur kerja yang diperlukan, tindakan yang diizinkan, skenario uji, dan output yang diharapkan. ![Generate the WhatsApp Integration Plan](https://static-blog.ycloud.com/4_Generate_the_Whats_App_Integration_Plan_c22a1e267a.png) ### Langkah 2: Tinjau Rencana yang Dihasilkan Codex pertama-tama memetakan kebutuhan bisnis ke komponen integrasi yang diperlukan. **Untuk alur kerja ini, rencana harus mencakup:** - *Pembuatan pesanan sebagai pemicu* - *Penyusunan dan pengiriman pesan WhatsApp* - *Koneksi antara pesanan dan catatan pesan* - *Pemrosesan Webhook status pesan* - *Penanganan duplikat peristiwa* - *Penanganan kegagalan dan batas waktu* - *Persyaratan akun, nomor telepon, dan templat* Tinjau poin-poin ini untuk memastikan bahwa alur kerja yang diusulkan sesuai dengan kebutuhan aplikasi. ### Langkah 3: Biarkan Codex Mengimplementasikan Alur Kerja Karena perintah tersebut mengizinkan perubahan pada proyek lokal saat ini, Codex dapat mengimplementasikan alur kerja yang telah ditentukan dan menambahkan pengujiannya. **Implementasi yang dihasilkan mungkin mencakup:** - *Logika konfirmasi pesanan* - *Adaptor permintaan YCloud* - *Placeholder konfigurasi* - *Korelasi pesanan ke pesan* - *Penerima Webhook* - *Logika pemrosesan status* - *Pengujian lokal* - *Instruksi menjalankan* Setelah implementasi, Codex harus mencantumkan setiap file yang dibuat atau diubah. Ini memberikan ringkasan jelas kepada pengembang tentang pekerjaan yang perlu ditinjau. ![Run Local Implementation and Simulated Tests](https://static-blog.ycloud.com/5_Run_Local_Implementation_and_Simulated_Tests_3e49d06721.png) ### Langkah 4: Jalankan Pengujian Simulasi > **Penting:** Contoh ini menggunakan respons YCloud simulasi dan peristiwa Webhook sintetis. Ini tidak terhubung ke akun YCloud langsung atau mengirim pesan WhatsApp yang sebenarnya. **Pengujian lokal mencakup:** - *Pengajuan permintaan yang berhasil* - *Penolakan API* - *Status pesan yang gagal kemudian* - *Batas waktu permintaan* - *Peristiwa status duplikat* - *Webhook Tidak Valid* Hasil yang direkam adalah: ```plaintext 24 tests passed 0 failed 0 skipped ``` Hasil ini mengkonfirmasi bahwa skenario lokal yang didefinisikan menghasilkan hasil yang diharapkan. **Mereka juga menunjukkan bahwa:** - *Pengajuan permintaan dan status pesan selanjutnya disimpan secara terpisah.* - *Peristiwa duplikat tidak memicu pembaruan bisnis yang berulang.* - *Permintaan yang mengalami timeout tetap tidak pasti.* - *Aplikasi tidak secara otomatis mengirim ulang setelah timeout yang tidak pasti.* Hasil ini hanya berlaku untuk skenario simulasi yang diuji. ![Run Local Implementation and Simulated Tests](https://static-blog.ycloud.com/5_Run_Local_Implementation_and_Simulated_Tests_3e49d06721.png) ### Langkah 5: Mengidentifikasi Apa yang Tersisa Sebelum Produksi Codex juga dapat memisahkan pekerjaan lokal yang telah selesai dari tugas yang masih memerlukan lingkungan YCloud yang berwenang: - Konfigurasikan akun YCloud dan nomor telepon WhatsApp. - Konfirmasikan template pesan yang disetujui. - Tambahkan kunci API sisi server. - Konfigurasikan endpoint Webhook publik. - Uji permintaan nyata dan panggilan balik status. - Selesaikan tinjauan kode, pemantauan, dan penerapan. ![Technical Handoff and Production Requirements](https://static-blog.ycloud.com/6_Technical_Handoff_and_Production_Requirements_1eb2fea647.png) Alur kerja lokal sekarang telah diimplementasikan dan diuji terhadap simulasi yang didefinisikan. Pekerjaan yang tersisa dilakukan di lingkungan YCloud dan penerapan yang berwenang bagi tim. ## Apa yang Ditunjukkan oleh Contoh Ini? YCloud Developer Kit membantu memindahkan persyaratan bisnis yang didefinisikan melalui perencanaan, implementasi lokal, pengujian, dan serah terima teknis dalam Codex.
Masukan
Hasil
Satu alur kerja bisnis yang didefinisikanRencana integrasi terstruktur
Satu permintaan implementasiPlaceholder kode dan konfigurasi lokal
Skenario uji simulasi yang ditentukanMencatat hasil jalur normal dan kegagalan
Satu permintaan handoffSisa persyaratan YCloud dan deployment
Ini memungkinkan pengembang untuk bekerja melalui proses pengembangan integrasi lengkap tanpa harus mengidentifikasi setiap kemampuan YCloud atau langkah implementasi secara manual. ## Pikiran Terakhir YCloud Developer Kit memberikan jalur langsung dari instalasi hingga pengembangan integrasi lokal. Instal dan verifikasi Kit, jelaskan satu alur kerja bisnis dengan jelas, dan biarkan Codex merencanakan, mengimplementasikan, dan mengujinya dalam proyek yang telah ditentukan. Konfigurasi akun, deployment produksi, dan verifikasi lingkungan nyata tetap menjadi langkah terpisah. > Untuk daftar kemampuan lengkap, tingkat validasi, praktik keamanan, dan pertimbangan produksi, baca [YCloud Developer Kit: Bangun dan Uji Integrasi WhatsApp API dengan Codex](https://www.ycloud.com/blog/ycloud-developer-kit-whatsapp-api-integration). ## Mulai Membangun dengan YCloud Developer Kit [Instal YCloud Developer Kit](https://github.com/YCloud-Developers/YCloud-Developer-Kit), buka tugas Codex baru dan jelaskan alur kerja WhatsApp yang ingin Anda bangun. ### [**Pelajari lebih lanjut tentang YCloud Developer Kit lengkap DI SINI**](https://www.ycloud.com/blog/ycloud-developer-kit-whatsapp-api-integration) ## Frequently Asked Questions ### Apakah YCloud Developer Kit Sama dengan YCloud Dashboard? Developer Kit No. YCloud adalah asisten pengembangan integrasi yang digunakan dalam Codex. Operasi pesan dan manajemen kampanye menggunakan alat terpisah. ### Apakah Pemasangan Kit Menghubungkannya ke Akun YCloud? Akses akun YCloud, kredensial, dan sumber daya eksternal harus dikonfigurasi secara terpisah. ### Bisakah Mengirim Pesan WhatsApp Nyata? Tidak sendiri. Versi 0.7.9 dapat membantu developer menulis kode aplikasi yang mengirim pesan melalui YCloud. Namun, Kit ini tidak membaca kredensial langsung, memanggil API YCloud, atau mengirim pesan sungguhan selama alur kerjanya. Pengiriman sungguhan terjadi terpisah melalui aplikasi yang dikonfigurasi dalam lingkungan yang telah diotorisasi. ### Apakah Developer Perlu Menyediakan API Key Selama Tahap Perencanaan? Tidak. Perencanaan, contoh kode, dan pengujian simulasi dapat menggunakan placeholder dan data sintetis. ### Dapatkah Ini Memodifikasi Proyek yang Sudah Ada? Ya. Developer harus secara eksplisit mengotorisasi perubahan file lokal dan mendefinisikan proyek, modul, serta cakupan yang diizinkan. ### Apakah Simulasi yang Berhasil Berarti Integrasi Siap Produksi? Tidak. Simulasi hanya memvalidasi skenario lokal yang telah ditentukan. Konfigurasi produksi dan pengujian terhadap YCloud masih diperlukan. ### Apakah Itu Dapat Membantu Membangun Penanganan Pesan Masuk? Ya. Ini dapat membantu menerapkan penangan Webhook yang memvalidasi dan mengarahkan peristiwa pesan masuk ke logika bisnis aplikasi. ### Apakah Mendukung Template, Kontak, dan Manajemen Berhenti Berlangganan? Ya. Versi 0.7.9 mencakup panduan khusus untuk alur kerja template, kontak, dan pelanggan yang berhenti berlangganan. ### Apakah Mendukung SMS, Suara, Verifikasi, atau Email? Integrasi No. SMS, Verify, YCloud Voice, dan Email berada di luar cakupan yang dinyatakan pada versi 0.7.9. WhatsApp Calling didukung dan terpisah dari YCloud Voice. ### Apa yang Terjadi Jika Dokumentasi API Resmi Tidak Dapat Diverifikasi? Tandai contoh sebagai tidak terverifikasi dan identifikasi endpoint, bidang, atau perilaku yang masih memerlukan konfirmasi. Jika Kit mengembalikan: **"synthetic\_unverified"** Artinya hasil tersebut dihasilkan dengan data sintetis dan detail kontrak yang dinyatakan tidak sepenuhnya diverifikasi. Ini bukan status API YCloud atau bukti pengujian integrasi nyata. --- Canonical HTML: https://www.ycloud.com/id/blog/how-to-install-ycloud-developer-kit-with-codex