Dokumentasi API V.1.0

Overview

CloudChat menyediakan REST API terpadu untuk mengelola percakapan dari berbagai channel chat populer. Satu API key, banyak channel, satu inbox.

Authentication

Authenticate request menggunakan header Authorization dengan API Key Anda.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Send Messages

Kirim pesan teks atau media ke channel apa pun yang didukung. Sistem otomatis menangani logic per-channel.

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://app.cloudchat.id/api/public/v1/messages',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx',
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'channel'  => 'whatsapp',
    'to'       => '6281234567890',
    'type'     => 'text',
    'text'     => 'Halo dari CloudChat API!',
  ]),
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

// Node.js (axios)
import axios from 'axios';

const res = await axios.post(
  'https://app.cloudchat.id/api/public/v1/messages',
  {
    channel: 'whatsapp',
    to:      '6281234567890',
    type:    'text',
    text:    'Halo dari CloudChat API!',
  },
  {
    headers: {
      Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx',
      'Content-Type': 'application/json',
    },
  }
);
console.log(res.data);

Webhooks

Daftarkan URL webhook untuk menerima event real-time saat pesan masuk, status berubah, dll.

1. Event Payload

Contoh payload event pesan masuk:

{
  "event": "message.received",
  "id": "evt_123456",
  "timestamp": 1700000000,
  "channel": "whatsapp",
  "session_id": "uuid-session-001",
  "data": {
    "from":     "6281234567890",
    "pushName": "John Doe",
    "text":     "Halo, saya tertarik produk Anda",
    "media":    null
  }
}

2. Verifikasi Webhook

Setiap event mengandung header X-CloudChat-Signature berupa HMAC-SHA256 dari body. Verifikasi sebelum memproses event di server Anda.

3. Retry Policy

• Kami expect respons 200 OK dalam 5 detik.
• Jika server Anda fail (5xx) atau timeout, kami retry 3 kali.
• Retries menggunakan exponential backoff: 2s, 4s, 8s.

Error Reference

Semua error mengikuti format JSON konsisten dengan kode dan pesan jelas.