gampang

A whatsapp bot framework for NodeJS

GPL-3.0 License

Downloads
287
Stars
20
Committers
4

Bot releases are hidden (Show)

gampang - v1.6.8 - Elpida Release Latest Release

Published by hansputera over 1 year ago

v1.6.8

Dalam versi ini, sudah menggunakan package @adiwajshing/baileys official, tidak lagi menggunakan forked repository. Hal ini disebabkan PR saya sebelumnya mengenai fitur Polling di repository https://github.com/adiwajshing/baileys belum sempat dimaintain kembali oleh saya untuk di review ulang oleh maintainer dan para contributor.

Sehingga, untuk memaksimalkan fungsi dari framework gampang, saya melakukan sedikit trik terhadap kode yang sudah ada untuk dapat mengirim pesan polling. Dan, mengimplementasikan fitur yang berada di https://github.com/adiwajshing/Baileys/pull/2290 ke framework ini.

FAQ

Mengapa masih menggunakan baileys v4.4.0, dan tidak v5.0.0 ?

Pada versi 5.0.0, masih terpantau tidak dapatnya menerima pesan dari event messages.upsert saat setelah melakukan relogin dengan session yang sudah tersimpan dalam hard drive.

Apakah framework gampang tersedia dalam Bahasa Inggris ?

Sebagian besar developmentnya menggunakan Bahasa Inggris, namun untuk releases announcement, dan guide menggunakan Bahasa Indonesia. Dan, kedepannya akan tersedia dalam Bahasa Inggris juga.

Apa yang membedakan framework gampang dengan baileys ?

Gampang merupakan WhatsApp Bot framework, dengan berdasar pada baileys, dengan artian bahwa gampang berdiri atas adanya library baileys. Gampang dirancang untuk memudahkan developer untuk membuat WhatsApp Bot dengan tanpa khawatir membuat banyak handler dan kode yang menyulitkan.

Apa kelebihan framework gampang ?

Ukuran package yang ringan, (unpacked size npmjs) hanya berkisar pada 83.1 kB. Selain itu, mudah dalam menggunakannya, anda tidak perlu lagi membuat parsers untuk mengolah pesan anda, tidak perlu lagi membuat handler untuk mengelola QR. Karena, hal tersebut sudah tersedia di framework gampang.

Related Projects

  1. Encrypted baileys sessions data - https://npmjs.com/package/safe-usemultiauthstate (https://github.com/hansputera/secure-multi-auth-state)

Full Changelog: https://github.com/hansputera/gampang/compare/1.5.1...1.6.8

gampang - v1.5.1

Published by hansputera almost 2 years ago

Gampang v1.5.1

Pada versi ini, terdapat perubahan pada source atau sumber library dari npm @adiwajshing/baileys ke fork github saya. Karena terdapat sedikit penambahan fitur. Sehingga, dalam proses instalasi akan terjadi proses compile atau build source code yang akan menghabiskan beberapa kurun waktu. Namun, fitur tersebut sudah saya ajukan ke repository yang asli atau original, dan dikemudian hari jika fitur tersebut sudah di merge, maka akan saya mengubah kembali sumbernya.

Simple changelogs:

  1. Refactor atau pengubahan penamaan parameter anotherOptions pada Context menjadi options
  Context.send(text, options)
  Context.reply(text, options)
  Context.replyWithSticker(sticker, options)
  Context.replyWithPhoto(photo, options)
  Context.replyWithVideo(video, options)
  1. Pada fungsi adapter, sekarang sudah dapat mengakses instance Client di parameter pertama
const stuffAdapter: AdapterFn = async (client: Client, path: string, auth: AuthenticationState) => { ... }
  1. Penambahan fitur Context.createPoll yang dapat membuat polling di grup whatsapp
    Contoh:
 await context.createPoll('Buah untuk bukber nanti apa?', [
   'Apel',
   'Jeruk',
   'Mangga',
 ]);

Full Changelog: https://github.com/hansputera/gampang/compare/1.4.2...1.5.1

gampang - 1.4.2 - Gampang Ready

Published by hansputera about 2 years ago

Hello Gampang 👋

Halo Dunia! Kami memperkenalkan Gampang

Apa itu gampang? Gampang merupakan framework untuk membangun bot whatsapp dengan mudah (walau tidak terlalu mudah), namun setidaknya dapat membantu kamu dalam membuat bot whatsapp dengan hanya beberapa kode saja. Menurut Kamus Besar Bahasa Indonesia (KBBI) gampang artinya mudah, dan tidak sukar. Oleh karena itu, kami terinspirasi untuk membuat framework ini. Gampang menggunakan library @adiwajshing/baileys untuk bekerja, dan gampang pada dasarnya diciptakan untuk lebih mempermudah dalam menggunakan library tersebut.

Apa kelebihan Gampang?

  • ✔️ Mudah digunakan
  • 📁 Ukuran yang cukup ringan
  • ⚡ Cepat
  • ➕ Middleware, dan command handler include. Kamu tidak perlu repot untuk membuatnya lagi!
  • 🔥 Raw @adiwajshing/baileys events support. Kamu ingin menggunakan event lainnya pada library @adiwajshing/baileys? Kamu sangat bisa melakukannya!

Penggunaan Gampang

Untuk menggunakan gampang cukup mudah atau gampang, karena hanya membutuhkan beberapa kode saja! Perhatikan kode berikut

const { Client, SessionManager } = require('gampang');

const client = new Client(
  new SessionManager('sessions', 'folder'), // 'sessions' bisa kamu ganti dengan nama folder sesukamu ya!
  {
    qr: {
      store: 'file',
      options: {
        'dest': 'qr.png' // 'qr.png' bisa kamu ganti dengan nama file yang lain juga
       }
      },
     prefixes: ['.'], // kamu bisa menentukan awalan untuk perintah bot milikmu di bagian ini
  }
);

// Perintah pertama untuk bot milikmu, yaitu "ping". Kamu cukup kirim pesan ke nomor botmu dengan pesan ".ping"
client.command(
  'ping', // kamu bisa menentukan nama perintah untuk botmu disini
 async (ctx) => {
  await ctx.reply('Pong!'); // dan, bot akan membalas dengan pesan "Pong!"
 }
);

// Langkah terakhir, jalankan botnya
client.launch();

Catatan ⚠️

  • Gampang masih dalam tahap pengembangan, sehingga bug dapat ditemukan dan terjadi.

Full Changelog: https://github.com/hansputera/gampang/commits/1.4.2