2.9 KiB

Raw Permalink Blame History

Dokumentasi API & Webhook WhatsApp Gateway (Go)

Sistem WhatsApp Gateway ini dikembangkan menggunakan Golang dan terhubung dengan library whatsmeow untuk memberikan REST API yang responsif dan ringan, serta dilengkapi sistem Webhook modern untuk push notification secara realtime.

🔒 Autentikasi

Gunakan header berikut untuk mengakses API (jika diaktifkan di konfigurasi gateway Anda):

Header: x-api-key
Value: API_KEY rahasia Anda

📩 1. Mengirim Pesan (API Endpoints)

Base URI: http://localhost:5555/api (atau disesuaikan dengan URL gateway Anda)

Mengirim Teks (Personal / Grup)

Endpoint: POST /api/send-message Format Body (JSON):

{
  "phone": "628123456789", 
  "message": "Halo, ini pesan otomatis."
}

Catatan: Sistem otomatis mengenali dan memformat nomor.

Mengirim Media (Gambar, Video, Dokumen)

Endpoint:

POST /api/send-image
POST /api/send-video
POST /api/send-document
POST /api/send-audio
POST /api/send-sticker

Format Body (Multipart/form-data):

phone: Nomor tujuan
caption: Teks/caption (Opsional)
file: File upload yang valid

Fitur Teks Lanjutan

Quote (Reply): POST /api/send-message-quote (menyertakan quotedMsgId)
Mention (Tag): POST /api/send-message-mention (menyertakan list mentionedJIDs)

📡 2. Pengecekan Status & QR

Cek Status Bot: GET /api/status
Generate / Ambil QR Code: GET /api/qr (hanya jika WhatsApp berstatus belum terhubung)

🪝 3. Dokumentasi Webhook (Realtime Events)

Webhook berfungsi untuk menerima notifikasi secara otomatis ke server Anda (seperti aplikasi MikroTik) ketika ada pesan masuk ke WhatsApp.

Cara Mengaktifkan Webhook

Edit file .env di direktori aplikasi WhatsApp Gateway Golang:

WEBHOOK_ENABLED=true
WEBHOOK_URL=http://url-aplikasi-anda.com/webhook/wa-receive
WEBHOOK_SECRET=kode_rahasia_anda (opsional, untuk X-Webhook-Signature)

Struktur Payload yang Diterima (POST Request)

Server aplikasi Anda akan menerima JSON dengan struktur berikut:

{
  "event": "message",
  "timestamp": "2024-03-29T22:30:00Z",
  "data": {
    "messageId": "3E3A4B89...",
    "from": "628123456789@s.whatsapp.net",
    "phoneNumber": "628123456789",
    "chatType": "personal", 
    "isGroup": false,
    "pushName": "Budi",
    "messageType": "message",
    "text": "Teks pesan dari pengirim"
  }
}

Fitur Auto-Reply langsung dari Webhook

Anda dapat memberikan balasan otomatis tanpa perlu melakukan API Call lagi. Cukup response endpoint webhook Anda dengan JSON 200 OK:

{
  "action": "reply",
  "messages": [
    { "type": "text", "content": "Halo Budi, pesan Anda telah kami terima!" }
  ]
}

🗂 Fitur Lainnya (Kontak & Grup)

Get Kontak: GET /api/contacts (Lokal)
Cek Info Nomor WA: GET /api/contact/info?phone=628xx
Manajemen Grup: GET /api/groups (List grup) dan GET /api/groups/:jid/info (Detail grup)

2.9 KiB Raw Permalink Blame History