{"id":26372744,"url":"https://github.com/classyid/helmai-client-spreadsheet","last_synced_at":"2025-03-17T01:19:06.844Z","repository":{"id":281222857,"uuid":"944608860","full_name":"classyid/helmai-client-spreadsheet","owner":"classyid","description":"Google Apps Script Client untuk berinteraksi dengan API HelmAI dan asisten pintar toko helm.","archived":false,"fork":false,"pushed_at":"2025-03-07T16:56:55.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-07T17:34:27.264Z","etag":null,"topics":["api-key","google-apps-script","helmai","zonahelm"],"latest_commit_sha":null,"homepage":"https://s.id/XX9io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/classyid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-07T16:44:43.000Z","updated_at":"2025-03-07T16:56:59.000Z","dependencies_parsed_at":"2025-03-07T17:44:37.466Z","dependency_job_id":null,"html_url":"https://github.com/classyid/helmai-client-spreadsheet","commit_stats":null,"previous_names":["classyid/helmai-client-spreadsheet"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/classyid%2Fhelmai-client-spreadsheet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/classyid%2Fhelmai-client-spreadsheet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/classyid%2Fhelmai-client-spreadsheet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/classyid%2Fhelmai-client-spreadsheet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/classyid","download_url":"https://codeload.github.com/classyid/helmai-client-spreadsheet/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243955777,"owners_count":20374373,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-key","google-apps-script","helmai","zonahelm"],"created_at":"2025-03-17T01:19:06.371Z","updated_at":"2025-03-17T01:19:06.833Z","avatar_url":"https://github.com/classyid.png","language":"JavaScript","readme":"# HelmAI Client 🛡️🤖\n\nGoogle Apps Script Client untuk berinteraksi dengan API HelmAI dan asisten pintar toko helm.\n\n![HelmAI Client Banner](https://blog.classy.id/upload/gambar_berita/85f96b6847da7cafe73175c28e2b8d8b_20250307234536.png)\n\n## 📋 Deskripsi\n\nHelmAI Client adalah Google Apps Script yang memungkinkan pengguna untuk mengakses informasi produk helm dan berinteraksi dengan asisten pintar HelmAI melalui antarmuka spreadsheet Google. Ideal untuk staf toko dan pengguna yang ingin akses cepat ke katalog produk dan bantuan dari asisten AI.\n\n## ✨ Fitur\n\n- **Akses Informasi Produk** - Mendapatkan dan menampilkan data produk helm terbaru dalam spreadsheet\n- **Visualisasi Promosi** - Menampilkan promosi aktif dengan detail diskon dan periode\n- **Chat dengan Asisten Cerdas** - Sidebar interaktif untuk berkomunikasi dengan HelmAI \n- **Multi-Mode Asisten** - Pilihan mode CS, Konten, dan Sales untuk berbagai kebutuhan komunikasi\n- **Manajemen Sesi** - Kemampuan melanjutkan percakapan melalui ID sesi\n\n## 🔧 Teknologi\n\n- Google Apps Script\n- Google Spreadsheet\n- HTML Service (untuk UI sidebar)\n- RESTful API\n- JavaScript\n\n## 📚 Cara Kerja\n\nScript ini berfungsi sebagai client yang menghubungkan Google Spreadsheet dengan API HelmAI. Pengguna dapat:\n\n1. Mengupdate dan melihat data produk helm dalam format spreadsheet\n2. Membuka sidebar chat untuk berinteraksi dengan asisten virtual\n3. Melakukan percakapan dalam berbagai mode sesuai kebutuhan\n\n```\n┌─────────────────┐      ┌───────────────┐      ┌───────────────┐\n│  Google Sheet   │\u003c────\u003e│  Apps Script  │\u003c────\u003e│  HelmAI API   │\n│  (User View)    │      │  Client       │      │  Endpoints    │\n└─────────────────┘      └───────────────┘      └───────┬───────┘\n      │                         │                       │\n      │                         │                       │\n      │                  ┌──────┴──────┐                │\n      └──────────────--\u003e│ Chat Sidebar │\u003c───────────────┘\n                        └─────────────┘\n```\n\n## 🚀 Deployment\n\n### Prasyarat\n\n- Akun Google\n- Akses ke HelmAI API (URL server dan API key)\n\n### Setup di Google Spreadsheet\n\n1. Buat Google Spreadsheet baru\n2. Buka menu Extensions \u003e Apps Script\n3. Copy-paste kode dari `helmAI-client.gs` ke editor\n4. Update variabel CONFIG dengan URL server dan API key Anda:\n\n```javascript\nconst CONFIG = {\n  baseUrl: \"http://your-server-url\", // Ganti dengan URL atau IP server Anda\n  apiKey: \"your_api_key_here\", // Ganti dengan API key Anda\n  timeout: 30000 // Timeout dalam milidetik\n};\n```\n\n5. Simpan project dan berikan nama (contoh: \"HelmAI Client\")\n6. Reload spreadsheet Anda\n7. Anda akan melihat menu \"Toko Helm\" di menu bar\n\n### Langkah Penggunaan\n\n1. Klik menu \"Toko Helm\" \u003e \"Update Data Produk\" untuk mengisi spreadsheet dengan data produk terbaru\n2. Klik menu \"Toko Helm\" \u003e \"Chat dengan Asisten\" untuk membuka sidebar chat\n3. Pilih mode asisten (CS, Konten, atau Sales) sesuai kebutuhan Anda\n4. Mulai percakapan dengan asisten HelmAI\n\n### Otorisasi\n\nSaat pertama kali menjalankan script, Google akan meminta otorisasi untuk:\n- Akses spreadsheet Anda\n- Melakukan permintaan ke layanan eksternal (API HelmAI)\n\nBerikan izin yang diperlukan untuk menggunakan fitur secara lengkap.\n\n## 📱 Penggunaan\n\n### Update Data Produk\n\n```\nToko Helm \u003e Update Data Produk\n```\n\nPerintah ini akan mengambil data produk dan promosi terbaru dari server dan menampilkannya dalam format tabel di spreadsheet Anda.\n\n### Chat dengan Asisten\n\n```\nToko Helm \u003e Chat dengan Asisten\n```\n\nPerintah ini akan membuka sidebar dengan antarmuka chat. Anda dapat:\n\n1. Memilih mode asisten (CS, Konten, Sales)\n2. Mengetik pesan di kotak input\n3. Menekan tombol \"Kirim\" atau Enter untuk mengirim pesan\n4. Melihat respons dari asisten HelmAI\n\n### Mode Asisten\n\n- **CS (Customer Service)**: Untuk pertanyaan layanan pelanggan, penanganan keluhan, dan dukungan umum\n- **Konten**: Untuk informasi produktif, edukasi tentang jenis helm, keselamatan, dan konten informatif lainnya\n- **Sales**: Untuk rekomendasi produk, penawaran spesial, dan bantuan konversi penjualan\n\n## ⚙️ Konfigurasi Lanjutan\n\nAnda dapat menyesuaikan berbagai aspek client dengan mengedit variabel dan fungsi:\n\n- Mengubah tampilan UI sidebar di fungsi `showChatSidebar()`\n- Menambahkan kolom data tambahan di fungsi `populateProductsSheet()`\n- Menambahkan mode asisten baru di elemen `select` dalam sidebar\n\n## 📖 API Endpoints\n\nHelmAI Client menggunakan endpoint berikut:\n\n- `GET /api/helm/info` - Mendapatkan informasi produk dan promosi\n- `POST /api/helm/chat` - Mengirim pesan ke asisten dan menerima respons\n- `GET /api/helm/sessions` - Mendapatkan daftar sesi chat aktif\n\n## 🔒 Keamanan\n\nScript menggunakan API key untuk otentikasi dengan server. Pastikan untuk:\n\n- Menyimpan API key dengan aman\n- Tidak membagikan spreadsheet yang berisi konfigurasi API key\n- Menggunakan API key dengan izin minimal yang diperlukan\n\n## 🤝 Integrasi\n\nHelmAI Client dapat diintegrasikan dengan:\n\n- HelmAI Dashboard Admin (untuk manajemen produk)\n- Sistem POS toko helm\n- Laporan analitik dan business intelligence\n\n## 🛠️ Troubleshooting\n\nJika mengalami masalah:\n\n1. Periksa konfigurasi API (URL dan key)\n2. Verifikasi koneksi internet\n3. Periksa log dengan `Logger.log()` dan lihat di menu View \u003e Logs di editor Apps Script\n4. Pastikan server API berjalan dan dapat diakses\n\n## 📞 Dukungan\n\nUntuk pertanyaan dan dukungan, silakan hubungi kami di [kontak@classy.id](mailto:kontak@classy.id) atau buka issue di repository GitHub.\n\n## 📄 Lisensi\n\nProyek ini dilisensikan di bawah [MIT License](LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclassyid%2Fhelmai-client-spreadsheet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclassyid%2Fhelmai-client-spreadsheet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclassyid%2Fhelmai-client-spreadsheet/lists"}