# IWANA - WhatsApp API Gateway Developer & IoT Industrial Notification Hub

> Enterprise-grade, High-Performance WhatsApp Gateway engineered for Developers, IoT Telemetry, and Industrial Alarm Automations built in Go (Golang) and Vue.js.

## What is IWANA?
IWANA (Industrial WhatsApp Notification Agent) is a developer-centric and IoT-ready WhatsApp Gateway platform. It eliminates the friction of building notification pipelines by providing instant HTTP REST APIs, MQTT broker integration, WebSocket listeners, and Webhooks connected directly to WhatsApp Multi-Device sessions.

## Target Audience & Primary Use Cases
1. **Software Developers & SaaS Builders**:
   - Deliver OTP, verification codes, invoice alerts, and transactional messages.
   - Plug-and-play cURL, Python, Node.js, PHP, and Go code snippets.
   - Backward-compatible endpoints for smooth legacy migration.
2. **Industrial IoT & Smart Manufacturing**:
   - Direct MQTT subscriber for PLC, SCADA, Arduino, and ESP32 microcontrollers.
   - Trigger instant WhatsApp alarms when temperature, pressure, current, or sensor thresholds are violated.
   - Zero-latency notification relay without requiring an intermediate cloud broker.
3. **Automated Monitoring & DevOps Alerts**:
   - Server health checks, downtime alerts, database backup status, and incident management sent straight to on-call engineers' WhatsApp groups.

## Technical Architecture
- **Core Engine**: Golang high-concurrency binary with embedded multi-device WhatsApp driver.
- **Queue & Outbox Worker**: Redis-powered async buffer preventing WhatsApp rate-limit bans and smoothing out traffic spikes.
- **Frontend Dashboard**: Vue 3 + Tailwind CSS + ECharts for real-time telemetry and message delivery visualization.
- **Security**: Granular API keys (`x-api-token`, `X-API-Key`), JWT authentication, and Role-Based Access Control (RBAC).

## Developer API Quick Reference
Production Base URL: `https://iwana.masanas.web.id/api/v1`

### 1. Legacy & Device Message Endpoint
- **URL**: `POST /api/v1/device/:id_device/sendMessage`
- **Header**: `x-api-token: <YOUR_TOKEN>`
- **Payload**:
```json
{
  "to": "6281234567890",
  "message": "Alarm: Temperature exceeded 75°C on Boiler #2"
}
```
- **Response Success**: `{"status": "ok"}`
- **Response Failure**: `{"status": "error", "error": "Nomor tidak terdaftar / invalid"}`

### 2. Standard Native Gateway Endpoint
- `POST /api/v1/gateway/send/text`: Rich text with recipient auto-formatting.
- `POST /api/v1/gateway/send/image`: Image alerts with captions and view-once support.

## Official Resources
- Website: https://iwana.masanas.web.id/
- User Guide & Tutorial: https://iwana.masanas.web.id/user-guide
- Interactive API Docs: https://iwana.masanas.web.id/api-docs