RESTful API Engine v1.0

Dokumentasi API & Integrasi

Hubungkan sistem toko online, aplikasi web, backend ERP, atau bot Anda dengan infrastruktur WhatsApp Gateway dan asisten AI AiWhat dalam beberapa baris kode.

Login & Dapatkan API Key Mulai Cepat
Navigasi Dokumen
1. Autentikasi & Header 2. Kirim OTP WhatsApp 3. AI Chat Assistant 4. Response & Error Code
Penting: Simpan API Key Anda di file environment (.env) backend server. Jangan cantumkan di frontend JavaScript publik.
1

Autentikasi & Format Header

Semua permintaan ke API AiWhat diamankan menggunakan API Key. Sertakan API Key Anda pada setiap HTTP Request melalui header dengan salah satu format berikut:

HTTP Headers 
// Format Header untuk AI Chat & Webhook:
X-API-KEY: your_api_key_here
Content-Type: application/json

// Format Header untuk WhatsApp OTP / Messaging:
Authorization: Bearer your_api_key_here
Content-Type: application/json
Di mana menemukan API Key?
Buka dashboard admin Anda, masuk ke menu "Manajemen API Key" di sidebar kiri, lalu klik "Generate New API Key".
2

Kirim OTP WhatsApp

Kirimkan kode verifikasi 2FA atau token autentikasi login pengguna langsung ke akun WhatsApp tujuan dengan latensi di bawah 3 detik.

POST https://aiwhat.in/api/v1/send-otp

Parameter Request (Body JSON)

Field Tipe Status Keterangan
phone string Wajib Nomor tujuan penerima (contoh: 6281234567890 atau 081234567890)
otp string Wajib Kode verifikasi atau PIN (contoh: 749201)
template string Opsional Nama template HSM jika menggunakan WhatsApp Official Cloud API

Contoh Request (cURL)

Bash / cURL 
curl -X POST https://aiwhat.in/api/v1/send-otp \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "6281234567890",
    "otp": "839201"
  }'

Contoh Response Sukses (200 OK)

JSON Response 
{
  "success": true,
  "message": "OTP berhasil dikirim ke antrian",
  "data": {
    "phone": "6281234567890",
    "status": "QUEUED"
  }
}
3

AI Chat Assistant Endpoint

Kirim teks percakapan pelanggan ke mesin asisten AI AiWhat dan terima balasan cerdas yang kontekstual secara realtime untuk chatbot bisnis Anda.

POST https://aiwhat.in/api/v1/ai/chat

Parameter Request (Body JSON)

Field Tipe Status Keterangan
message string Wajib Pesan pertanyaan dari user (contoh: "Berapa harga paket pro?")
phone string Wajib Session ID / nomor WhatsApp penanya untuk memori percakapan konteks
device_id integer Wajib ID perangkat WhatsApp yang ditugaskan sebagai host AI
push_name string Opsional Nama panggilan pelanggan untuk sapaan personal

Contoh Request (cURL)

Bash / cURL 
curl -X POST https://aiwhat.in/api/v1/ai/chat \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Halo, siapa kamu?",
    "phone": "6281234567890",
    "device_id": 1,
    "push_name": "Budi"
  }'

Contoh Response Sukses (200 OK)

JSON Response 
{
  "status": "success",
  "reply": "Halo Budi! Saya asisten AI dari AiWhat yang siap membantu kebutuhan bisnis Anda.",
  "provider": "gemini"
}
4

Kode Status & Penanganan Error

Daftar standar kode HTTP response yang dikembalikan oleh API AiWhat untuk mempermudah proses integrasi dan debugging:

HTTP Code Arti Penyebab & Solusi
200 OK Berhasil Request diterima dan diproses dengan sukses.
401 Unauthorized Autentikasi Gagal API Key salah, kosong, atau tidak aktif. Periksa kembali header request.
422 Unprocessable Validasi Gagal Ada parameter wajib yang tidak diisi (misal: format nomor salah atau pesan kosong).
500 Server Error Kendala Server Gateway sedang memproses beban tinggi atau koneksi WhatsApp sedang reconnecting.