Langsung ke konten utama

​
WhatsApp (Saluran Web)

Status: Siap digunakan (production-ready) melalui WhatsApp Web (Baileys). Gateway menangani sesi yang terhubung.

Pairing

Kebijakan DM default menggunakan mode pairing untuk pengirim yang tidak dikenal.

Troubleshooting

Panduan diagnosa dan perbaikan saluran.

Konfigurasi Gateway

Contoh dan pola konfigurasi saluran lengkap.

​
Menghubungkan WhatsApp

1

Konfigurasi kebijakan akses

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+628123456789"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+628123456789"],
    },
  },
}
2

Login WhatsApp (QR)

openclaw channels login --channel whatsapp
3

Mulai Gateway

openclaw gateway
4

Setujui permintaan pairing

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <KODE>
OpenClaw menyarankan penggunaan nomor terpisah untuk bot jika memungkinkan, meskipun penggunaan nomor pribadi tetap didukung.

​
Kebijakan Akses

  • dmPolicy: Mengontrol akses pesan langsung (DM). Pilihan: pairing, allowlist, open, disabled.
  • groupPolicy: Mengontrol akses di dalam grup. Pilihan: open, allowlist, disabled.
  • allowFrom: Daftar nomor telepon (E.164) yang diizinkan untuk berinteraksi.

​
Grup dan Sebutan (Mentions)

Secara default, bot hanya akan merespons di grup jika:
  • Bot disebut (mention) secara eksplisit.
  • Pesan bot dibalas (reply).
  • Pola sebutan kustom cocok dengan isi pesan.

​
Perilaku Pesan

​
Reaksi Tanda Terima (Ack Reactions)

Bot dapat memberikan reaksi emoji secara otomatis saat menerima pesan: 
{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions"
      },
    },
  },
}

​
Media dan Ukuran

  • Mendukung gambar, video, audio (Pesan Suara), dan dokumen.
  • Batas default ukuran media: 5MB untuk balasan otomatis.
  • Gambar akan otomatis dioptimalkan ukurannya jika melebihi batas.

​
Pemecahan Masalah Umum

  • Status: Not Linked: Gunakan openclaw channels login --channel whatsapp untuk memindai QR ulang.
  • Pesan Grup Diabaikan: Periksa groupPolicy, groupAllowFrom, dan pastikan bot sudah disebut (mention) jika diperlukan.
  • Error Bun: Disarankan menjalankan Gateway WhatsApp menggunakan Node.js, karena Bun saat ini belum sepenuhnya stabil untuk operasi WhatsApp.

​
Terkait