Engineering Specifications

Developer Hub & API Standards

Semua yang Anda butuhkan untuk membangun integrasi yang tangguh, aman, dan dapat diandalkan ke WhatsApp Gateway.

Standar Autentikasi Aplikasi

Header wajib untuk setiap permintaan ke endpoint /api/v1/app/*

1. X-App-Id (String)

Identifier unik aplikasi konsumen yang dibuat di dashboard (contoh: app_portal_demo).

2. X-App-Key (Secret String)

Kunci rahasia API berawalan wai_live_. Disimpan dalam bentuk SHA-256 hash di server database.

Kunci hilang? Anda dapat membuat kunci baru kapan saja melalui Multi-Application Hub di dashboard admin.Buka Hub

Format Respons Standar (ApiResponse)

Struktur JSON seragam untuk status sukses maupun error

Success Response (200 OK)
{
  "success": true,
  "message": "Message sent successfully",
  "data": {
    "messageId": "msg_9012498214",
    "status": "SENT",
    "to": "6281275001234",
    "createdAt": "2026-10-12T11:42:00.000Z"
  }
}
Error Response (401 Unauthorized)
{
  "success": false,
  "message": "Invalid or expired Application credentials",
  "error": {
    "code": "Unauthorized",
    "statusCode": 401
  },
  "path": "/api/v1/app/info",
  "timestamp": "2026-10-12T11:58:02.940Z"
}

Referensi HTTP Status Codes

400 Bad RequestParameter DTO tidak valid atau format nomor telepon bukan format internasional (E.164).
401 UnauthorizedX-App-Id tidak ditemukan atau hash X-App-Key tidak cocok dengan database.
403 ForbiddenAplikasi dinonaktifkan atau mencoba mengakses sesi WhatsApp milik aplikasi konsumen lain.
404 Not FoundSesi WhatsApp, pesan, atau sumber daya yang diminta tidak terdaftar.
429 Too Many RequestsAplikasi melebihi kuota rate limit yang telah ditentukan (misal: 60 rpm).
500 Internal ErrorTerjadi kendala sementara pada gateway saat memproses permintaan. Silakan hubungi dukungan atau coba beberapa saat lagi.