Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ndiing/whatsapp-client
WhatsApp Client adalah aplikasi yang berfungsi sebagai klien dan HTTP server untuk menghubungkan WhatsApp dengan perangkat lunak yang Anda kembangkan.
https://github.com/ndiing/whatsapp-client
api chat client http-server messaging webhook whatsapp
Last synced: 21 days ago
JSON representation
WhatsApp Client adalah aplikasi yang berfungsi sebagai klien dan HTTP server untuk menghubungkan WhatsApp dengan perangkat lunak yang Anda kembangkan.
- Host: GitHub
- URL: https://github.com/ndiing/whatsapp-client
- Owner: ndiing
- License: mit
- Created: 2024-10-20T10:47:51.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2024-10-23T18:28:22.000Z (24 days ago)
- Last Synced: 2024-10-23T21:22:07.614Z (23 days ago)
- Topics: api, chat, client, http-server, messaging, webhook, whatsapp
- Language: JavaScript
- Homepage:
- Size: 193 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# WhatsApp Client
[](https://github.com/ndiing/whatsapp-client/releases)
[](https://github.com/ndiing/whatsapp-client/releases)
**WhatsApp Client** adalah aplikasi desktop yang memudahkan integrasi WhatsApp dengan sistem lain melalui HTTP request dan webhook. Aplikasi ini cocok untuk Anda yang membutuhkan integrasi sederhana dengan WhatsApp tanpa perlu pengetahuan mendalam tentang socket atau Server-Sent Events (SSE).
## Fitur Utama
- **HTTP Request**: Kirim pesan ke WhatsApp menggunakan request sederhana.
- **Webhook**: Terima pesan masuk dari WhatsApp secara otomatis.
- **Mudah Digunakan**: Instal dan langsung gunakan, tanpa perlu konfigurasi rumit.
- **Kompatibel**: Dukungan penuh untuk aplikasi yang belum support socket/SSE.
## Cara Download dan Instalasi
1. Download versi terbaru dari [WhatsApp Client Releases](https://github.com/ndiing/whatsapp-client/releases).
2. Setelah selesai download, install aplikasi sesuai sistem operasi Anda.
- Untuk Windows: Jalankan file `.exe`.
- ~~Untuk Mac: Ekstrak dan jalankan file `.dmg` atau `.pkg`.~~
- ~~Untuk Linux: Gunakan file `.deb` atau `.AppImage`.~~
## Penggunaan Aplikasi
WhatsApp Client berjalan di background sebagai tray icon. Berikut beberapa fungsinya:
1. **Berhenti**: Klik kanan pada icon di tray, pilih "Berhenti" untuk menutup aplikasi.
2. **Relaunch**: Klik kanan pada icon di tray, pilih "Relaunch" untuk memulai ulang aplikasi.
3. **Lihat Versi Terkini**: Arahkan mouse ke tray icon untuk melihat versi aplikasi yang sedang berjalan.
## Pengaturan Awal (Default .env)
Jika Anda ingin melakukan konfigurasi manual, berikut adalah contoh file `.env` yang digunakan oleh aplikasi:
HTTP_PORT=2000
HTTPS_PORT=0
HOSTNAME=localhost
WHATSAPP_WEBHOOK=http://127.0.0.1:2001/:_id/webhook
WHATSAPP_AUTOSTART=false
### Penjelasan:
- **HTTP_PORT**: Port yang digunakan untuk HTTP (default: `2000`).
- **HTTPS_PORT**: Port untuk HTTPS (default: `0`, artinya tidak aktif).
- **HOSTNAME**: Nama host (default: `localhost`).
- **WHATSAPP_WEBHOOK**: URL webhook untuk menerima pesan dari WhatsApp.
- **WHATSAPP_AUTOSTART**: Atur apakah WhatsApp Client otomatis dijalankan saat startup (default: `false`).
## Persiapan Sebelum Memulai
1. **Atur Webhook**: Pastikan untuk mengatur URL webhook pada file `.env`:
WHATSAPP_WEBHOOK=http://127.0.0.1:2001/:_id/webhook
2. **Contoh Penanganan Login dan Pesan**: Jika Anda ingin mencoba penanganan login dengan QR code dan mengelola pesan, Anda perlu menjalankan aplikasi desktop sebagai gateway. Anda dapat meng-clone repo dan mengatur aplikasi dengan langkah berikut:
git clone https://github.com/ndiing/whatsapp-client
npm install
npm start
Pastikan Node.js sudah terinstall dan aplikasi desktop sudah dijalankan.
## Contoh REST API
WhatsApp Client menyediakan beberapa endpoint REST API yang dapat Anda gunakan untuk mengirim dan menerima pesan. Berikut contoh file HTTP untuk beberapa fungsionalitas:
1. [Example](./http/example.http) - Contoh umum.
2. [Chat](./http/whatsapp-chat.http) - Kirim pesan.
3. [Group](./http/whatsapp-group.http) - Mengelola grup.
4. [Message](./http/whatsapp-message.http) - Mengelola pesan.
5. [Misc](./http/whatsapp-misc.http) - Fungsi-fungsi tambahan.
6. [Presence](./http/whatsapp-presence.http) - Status kehadiran.
7. [Privacy](./http/whatsapp-privacy.http) - Pengaturan privasi.
8. [Store](./http/whatsapp-store.http) - Pengelolaan store.
9. [WhatsApp](./http/whatsapp.http) - Endpoint utama.
## Identifikasi JID (WhatsApp JID)
Dalam WhatsApp, JID digunakan untuk mengidentifikasi pengguna, grup, atau fungsi tertentu. Berikut penjelasan tipe JID:
1. `[email protected]` - Untuk chat individu.
2. `[email protected]` - Untuk grup.
3. `xyzxyzxyzxyz@lid` - Pengguna dalam grup tertentu.
4. `xyzxyzxyzxyz@newsletter` - Untuk saluran newsletter.
5. `62123456789@broadcast` - Penerima dalam siaran.
6. `[email protected]` - Identifikasi via nomor telepon.
7. `62123456789@call` - Untuk panggilan di WhatsApp.
8. `status@broadcast` - Untuk melihat status WhatsApp.