pixco

Dokumentasi API

Semua yang kamu butuhkan untuk mengirim pesan WhatsApp secara otomatis dari aplikasimu — dari koneksi device hingga pengiriman pesan bulk.

Base URL/api/v1

Mulai Pakai pixco

Ikuti langkah-langkah ini supaya WhatsApp gateway kamu siap mengirim pesan.

1

Buat Akun & Pilih Paket

Daftar di pixco dan pilih paket yang sesuai: Starter untuk mulai cepat, Basic untuk operasional harian, atau Pro untuk tim dengan volume tinggi.

2

Hubungkan Perangkat WhatsApp

Tambahkan perangkat dari menu Perangkat di dashboard. Scan QR code dengan WhatsApp kamu untuk menghubungkan nomor.

Gunakan nomor WhatsApp yang aktif dan tidak sedang digunakan di perangkat lain.
3

Buat API Key

Buka menu API Keys di dashboard, buat key baru dengan permission yang sesuai. Gunakan API key di header x-api-key.

Simpan license key dengan aman. Jangan taruh di frontend yang bisa diakses publik.
4

Mulai Kirim Pesan

Gunakan endpoint /api/v1/send/message dengan API key kamu untuk mengirim pesan WhatsApp dari aplikasimu.

Referensi API

Endpoint pengiriman pesan menggunakan header x-api-key untuk autentikasi. Endpoint lainnya menggunakan Bearer token.

POST/api/v1/send/messageKirim Pesan

Kirim pesan WhatsApp ke satu nomor tujuan menggunakan perangkat yang sudah terhubung. Nilai device_id diambil dari field id pada endpoint GET /api/v1/devices.

Headers
x-api-keyAPI key dari menu API Keys
Content-Typeapplication/json
Request Body
{
  "device_id": "id-device-dari-get-devices",
  "to": "628123456789",
  "message": "Halo dari pixco!"
}
Response
{
  "status": "success",
  "message_id": "uuid-message",
  "to": "628123456789",
  "status_msg": "sent"
}
POST/api/v1/send/bulkKirim Pesan Massal

Kirim pesan ke banyak nomor sekaligus menggunakan satu request.

Headers
x-api-keyAPI key dari menu API Keys
Content-Typeapplication/json
Request Body
{
  "device_id": "id-device-dari-get-devices",
  "targets": [
    "628111111111",
    "628222222222"
  ],
  "message": "Halo dari pixco!"
}
Response
{
  "status": "success",
  "queued": 2
}
GET/api/v1/messagesDaftar Pesan

Ambil riwayat pesan yang dikirim dan diterima. Memerlukan Bearer token.

Headers
AuthorizationBearer <jwt_token>
Response
{
  "data": [],
  "total": 0,
  "page": 1,
  "limit": 20
}
DELETE/api/v1/devices/{id}Hapus Device

Menghapus device dengan alur aman: logout/disconnect session WhatsApp terlebih dahulu, lalu menghapus seluruh riwayat pesan yang berelasi dengan device tersebut secara transaksional.

deleted_messages_count hanya menghitung pesan milik user yang sedang login (scoped by user_id), bukan semua user.
Headers
AuthorizationBearer <jwt_token>
Response
{
  "message": "Deleted successfully",
  "deleted_messages_count": 12,
  "device_logged_out": true
}