Lewati ke konten utama

📤 Send Message API

Kirim pesan WhatsApp via API untuk automasi dan integrasi sistem.

🎯 Endpoint Overview​

1. Send Single Message​

POST /messages/send

2. Send Bulk Messages​

POST /messages/send-bulk

3. Send Template Message​

POST /messages/send-template

4. Get Message Status​

GET /messages/:messageId

📨 Send Single Message​

Request Body​

{
  "deviceId": "device-uuid",
  "to": "6281234567890",
  "message": "Halo, ini pesan dari API!",
  "type": "text"
}

Response Success​

{
  "success": true,
  "data": {
    "messageId": "msg-uuid-12345",
    "status": "pending",
    "timestamp": "2024-01-15T10:30:45Z"
  }
}

Example JavaScript​

const axios = require('axios');

async function sendMessage(deviceId, to, message) {
  const response = await axios.post(
    'https://api.pintarx.space/v1/messages/send',
    { deviceId, to, message },
    {
      headers: {
        'Authorization': `Bearer ${process.env.PINTARX_API_KEY}`,
        'Content-Type': 'application/json'
      }
    }
  );
  
  return response.data;
}

📤 Send Bulk Messages​

Kirim ke multiple nomor dengan delay acak untuk mencegah spam detection.

Request​

{
  "deviceId": "device-uuid",
  "messages": [
    { "to": "6281234567890", "message": "Halo John!" },
    { "to": "6289876543210", "message": "Halo Jane!" }
  ],
  "delay": { "min": 5, "max": 15 }
}

Response​

{
  "success": true,
  "data": {
    "campaignId": "campaign-uuid",
    "totalMessages": 2,
    "status": "queued"
  }
}

📋 Send Template Message​

Gunakan template dengan variabel dinamis.

Request​

{
  "deviceId": "device-uuid",
  "to": "6281234567890",
  "templateId": "template-uuid",
  "variables": {
    "nama": "John Doe",
    "produk": "Laptop Asus"
  }
}

📌 Best Practices​

  • Validate phone format (62812XXX)
  • Handle rate limits dengan retry + exponential backoff
  • Use delay untuk bulk send (5-15 detik)
  • Log semua request untuk debugging