📱 Dokumentasi WhatsApp Bot

🚀 Pendahuluan

Dokumentasi ini menjelaskan cara kerja dan fitur-fitur utama dari WhatsApp Bot yang telah dikembangkan. Bot ini menggunakan library whatsapp-web.js dan beberapa teknologi pendukung lainnya.

🛠️ Teknologi yang Digunakan

🔑 Fitur Utama

1. 🔄 Manajemen Sesi

2. 📨 Pengiriman Pesan

3. 🖼️ Generasi QR Code

4. 🔐 Autentikasi

📋 API Endpoints

1. POST /api/create-session

Membuat sesi WhatsApp baru.

Request:

{
  "phone": "6281234567890"
}

Response:

{
  "message": "Client for 6281234567890 is being initialized..."
}

2. POST /api/delete

Menghapus sesi WhatsApp yang ada.

Request:

{
  "phone": "6281234567890"
}

Response:

{
  "message": "Session 6281234567890 deleted successfully."
}

3. POST /api/reset

Mereset dan membuat ulang sesi WhatsApp.

Request:

{
  "phone": "6281234567890"
}

Response:

{
  "message": "Sesi 6281234567890 berhasil direset dan dibuat ulang!"
}

4. POST /api/send-message

Mengirim pesan WhatsApp.

Request:

{
  "sessionId": "6281234567890",
  "number": "6289876543210",
  "message": "Halo, ini pesan dari bot!"
}

Response:

{
  "message": "Pesan berhasil dikirim!",
  "sessionId": "6281234567890",
  "number": "6289876543210"
}

5. PUT /api/client/store

Menyimpan atau memperbarui informasi sesi.

Request:

{
  "phone": "6281234567890",
  "user_id": 123,
  "api_token": "your_api_token_here"
}

Response:

{
  "message": "Session stored successfully"
}

🔄 Alur Kerja

  1. Saat server dimulai, semua sesi yang tersimpan akan diinisialisasi.
  2. Untuk setiap sesi, QR code akan di-generate dan dikirim ke server Laravel.
  3. Setelah scan QR code, bot siap menerima dan mengirim pesan.
  4. Pesan yang diterima akan diteruskan ke server Laravel.
  5. Server dapat mengirim pesan melalui bot menggunakan API yang disediakan.

⚠️ Penanganan Error

Contoh respons error:

{
  "error": "Nomor HP diperlukan!"
}

🔒 Keamanan

📚 Referensi