🚀 Quick Start Guide
Selamat datang di Wagy API! Panduan ini akan membantu Anda mengirim pesan WhatsApp pertama Anda menggunakan API Wagy dalam waktu kurang dari 5 menit.
1. Persiapan​
Sebelum memulai, pastikan Anda telah:
- Memiliki akun di Wagy Panel.
- Membuat sebuah Device dan memastikan statusnya sudah Connected (Scan QR).
- Mendapatkan Device ID dan API Key (Token) dari halaman pengaturan device Anda.
2. Autentikasi​
Semua request ke API Wagy menggunakan metode Bearer Token. Anda wajib menyertakan header berikut pada setiap request:
Authorization: Bearer YOUR_DEVICE_API_KEY
Content-Type: application/json
3. Kirim Pesan Pertama​
Gunakan endpoint /send untuk mengirim pesan teks sederhana. Ganti DEVICE_ID dengan ID device Anda dan YOUR_DEVICE_API_KEY dengan token Anda.
- cURL
- Node.js
- PHP
curl -X POST https://api.wagy.web.id/api/v1/DEVICE_ID_ANDA/send \
-H "Authorization: Bearer YOUR_DEVICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone": "628123456789",
"message": "Halo! Ini adalah pesan pertama saya melalui Wagy API 🚀"
}'
const axios = require('axios');
const data = {
phone: '628123456789',
message: 'Halo! Ini adalah pesan pertama saya melalui Wagy API 🚀'
};
axios.post('https://api.wagy.web.id/api/v1/DEVICE_ID_ANDA/send', data, {
headers: {
'Authorization': 'Bearer YOUR_DEVICE_API_KEY',
'Content-Type': 'application/json'
}
})
.then(res => console.log(res.data))
.catch(err => console.error(err));
<?php
$client = new \GuzzleHttp\Client();
$response = $client->post('https://api.wagy.web.id/api/v1/DEVICE_ID_ANDA/send', [
'headers' => [
'Authorization' => 'Bearer YOUR_DEVICE_API_KEY',
'Content-Type' => 'application/json',
],
'json' => [
'phone' => '628123456789',
'message' => 'Halo! Ini adalah pesan pertama saya melalui Wagy API 🚀',
],
]);
echo $response->getBody();
Hasil Response (Success):
{
"status": "success",
"data": {
"message_id": 1024,
"status": "PENDING",
"quota_type": "pro",
"remaining": 499
},
"message": "Pesan masuk antrean"
}
4. Menerima Pesan (Webhook)​
Wagy menggunakan arsitektur Event-Based Payload. Setiap ada pesan masuk, Wagy akan mengirimkan POST request ke URL Webhook Anda dengan struktur sebagai berikut:
{
"event": "message.received",
"source": "whatsapp",
"data": {
"id": 1001,
"device_id": "DVC-123",
"owner_jid": "62812345678@s.whatsapp.net",
"content": {
"pn_jid": "6281299887766@s.whatsapp.net",
"lid_jid": "203998263034091@lid",
"content": "Halo admin, saya mau tanya...",
"message_id": "ABC123XYZ",
"timestamp": "2026-05-10T08:30:00Z",
"is_edit": false
},
"created_at": "2026-05-10T08:30:05Z"
}
}
Keamanan Webhook (Signature)​
Setiap request dari Wagy menyertakan header X-Wagy-Signature. Header ini adalah hash HMAC-SHA256 dari seluruh body request menggunakan Webhook Secret Anda.
Sangat disarankan untuk selalu memvalidasi signature ini untuk memastikan request benar-benar berasal dari server Wagy dan bukan dari pihak ketiga yang tidak bertanggung jawab.
5. Apa Selanjutnya?​
Setelah berhasil mengirim pesan, Anda dapat mengeksplorasi fitur lainnya: