Integrasi WhatsApp dengan AI Agent & Coding Assistant

Tambahkan integrasi WhatsApp Gateway ke project ini menggunakan REST API VexaHost WA (https://wa.vexahostcloud.my.id).

Spesifikasi integrasi:
- Base URL: https://wa.vexahostcloud.my.id/api/v1
- Endpoint kirim teks: POST /messages/text
- Header:
    X-Api-Key: env('VEXAHOST_WA_KEY')
    Content-Type: application/json
- Payload JSON:
    {
      "to": "081234567890",
      "message": "Halo! Pesan transaksional dari sistem."
    }
- Format respon sukses:
    { "success": true, "data": { "id": "msg_1029", "status": "queued" } }

Tolong buatkan helper service yang modular dengan validasi nomor tujuan dan error handling yang aman. Simpan petunjuk ini di berkas CLAUDE.md.

# Aturan VexaHost WA Gateway untuk .cursorrules

Ketika membuat fitur pengiriman pesan, notifikasi, atau verifikasi OTP WhatsApp:
1. Panggil endpoint REST API: POST https://wa.vexahostcloud.my.id/api/v1/messages/text
2. Autentikasi: sertakan header 'X-Api-Key' dari variabel lingkungan VEXAHOST_WA_KEY.
3. Payload JSON:
   {
     "to": "08xxxxxxxxxx",
     "message": "Isi pesan WhatsApp"
   }
4. Jangan pernah mengekspos API key di client-side / frontend.
5. Tangani respon galat 401 (kunci salah) dan 422 (data tidak valid) dengan elegan.

Definisikan skill baru untuk Hermes Agent di folder `skills/vexahost-wa/SKILL.md`:

```yaml
name: vexahost-wa-gateway
description: Kirim pesan WhatsApp notifikasi dan dokumen via VexaHost WA Gateway API.
```

Instruksi teknis untuk agent:
- Base URL: https://wa.vexahostcloud.my.id/api/v1
- Method: POST /messages/text
- Headers:
    Content-Type: application/json
    X-Api-Key: ${VEXAHOST_WA_KEY}
- Parameter fungsi `send_whatsapp(to, message)`:
    `to`: nomor WhatsApp tujuan (format 08 atau 62)
    `message`: teks pesan WhatsApp yang dikirim
- Agent harus mengecek apakah API key tersedia sebelum memanggil HTTP POST.
- Kembalikan ID pesan ('id') dan status ('queued') saat pengiriman sukses.

Konfigurasikan OpenClaw (Clawdbot) dengan tool pengiriman WhatsApp resmi VexaHost WA:

1. Daftarkan tool 'send_whatsapp' di manifest tool OpenClaw:
   - Description: Mengirim notifikasi atau balasan WhatsApp ke pengguna.
   - Endpoint: POST https://wa.vexahostcloud.my.id/api/v1/messages/text
   - Header: X-Api-Key: ${env.VEXAHOST_WA_KEY}
   - Body: { "to": "<recipient_phone>", "message": "<message_text>" }
2. Standarisasi format nomor: normalisasi awalan 08 menjadi 628 secara otomatis.
3. Bila agent mendeteksi perintah pengiriman pesan atau alert sistem, jalankan tool ini dan laporkan queue ID yang diterima.

Konfigurasikan integrasi WhatsApp otomatis untuk workspace ini menggunakan VexaHost WA Gateway API:
- Base URL: https://wa.vexahostcloud.my.id/api/v1
- Endpoint: POST /messages/text
- Header: X-Api-Key: [API_KEY_ANDA], Content-Type: application/json
- Body: { "to": "08xxxxxxxxxx", "message": "Pesan otomatis sistem" }
- Dokumentasi API lengkap: https://wa.vexahostcloud.my.id/docs
- Pastikan fungsi kirim mengembalikan status antrean pesan tanpa menghentikan thread utama aplikasi.

Integrasikan pengiriman pesan WhatsApp via VexaHost WA Gateway.
URL: https://wa.vexahostcloud.my.id/api/v1/messages/text
Method: POST
Headers:
  X-Api-Key: os.getenv('WA_KEY')
  Content-Type: application/json
Body:
  {
    "to": "081234567890",
    "message": "Pesan verifikasi sistem"
  }
Buatkan modul client HTTP yang bersih dan siap diuji.

Write a clean and robust service module to send WhatsApp messages using VexaHost WA Gateway.
API URL: https://wa.vexahostcloud.my.id/api/v1/messages/text
Method: POST
Headers:
  X-Api-Key: process.env.WA_API_KEY
  Content-Type: application/json
Body:
  { "to": recipient_phone, "message": text_message }
Requirements:
- Validate phone number input (supports 08... or 628...)
- Parse JSON response and log queue message ID
- Add exponential retry on 5xx server errors

Integrasikan VexaHost WA Gateway API ke dalam alur aplikasi:
- Endpoint: POST https://wa.vexahostcloud.my.id/api/v1/messages/text
- Header: X-Api-Key: env('WA_API_KEY')
- Request Body: { "to": "081234567890", "message": "Notifikasi pesanan siap dikirim" }
- Tangani status response: 'queued' menandakan pesan telah masuk antrean pengiriman server.

# Panduan VexaHost WA Gateway untuk .clinerules
- Base URL: https://wa.vexahostcloud.my.id/api/v1
- Endpoint Kirim Pesan: POST /messages/text
- Headers:
    Content-Type: application/json
    X-Api-Key: ${WA_GATEWAY_KEY}
- Buatkan service class modular dengan error handling yang aman tanpa menghentikan flow aplikasi saat network failure.

# GitHub Copilot Instructions for WhatsApp Gateway
When implementing WhatsApp notifications, OTP, or messaging:
- Use VexaHost WA Gateway REST API: POST https://wa.vexahostcloud.my.id/api/v1/messages/text
- Always read API key from environment variable `WA_GATEWAY_KEY` (Header: `X-Api-Key`)
- Validate phone numbers to support standard Indonesian formats (08... and 62...)
- Avoid throwing fatal exceptions on notification delivery failure.