Volara Docs

Tema

Quickstart ​

Panduan ini membawa Anda dari nol sampai mengirim pesan pertama lewat API Volara dalam waktu kurang dari lima menit.

Konsep inti ​

Sebelum mulai, kenali tiga konsep yang dipakai di seluruh dokumentasi:

  • Tenant (organisasi) — ruang kerja Anda. Semua data (kontak, percakapan, channel) terisolasi per-tenant. Konteks tenant ditentukan dari sesi login atau API key terverifikasi — tidak pernah dari header publik.
  • Channel — koneksi ke platform pesan: WhatsApp, Instagram, atau TikTok. Satu tenant bisa punya banyak channel.
  • Conversation (percakapan) — utas pesan dengan satu kontak di satu channel, muncul di Inbox omnichannel.

1. Buat akun & organisasi ​

Daftar di app.volara.chat lalu buat organisasi pertama Anda. Organisasi inilah tenant Anda.

2. Ambil API key ​

Buka Settings → API Keys di dashboard, lalu buat API key baru. Simpan kunci dengan aman — kunci hanya ditampilkan sekali. Semua permintaan API memakai header Authorization: Bearer <API_KEY> (atau x-api-key). Detail lengkap di Autentikasi.

Jaga kerahasiaan API key

API key memberi akses penuh ke data tenant Anda. Jangan menaruhnya di kode frontend, repositori publik, atau bundel klien. Gunakan hanya dari server.

3. Hubungkan channel ​

Hubungkan minimal satu channel agar bisa mengirim pesan. Untuk WhatsApp, ikuti panduan channel WhatsApp. Setelah terhubung, catat channelId-nya.

4. Kirim pesan pertama ​

Ganti API_KEY, CHANNEL_ID, dan nomor tujuan, lalu jalankan:

bash
curl -X POST https://api.volara.chat/api/v1/messages \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "CHANNEL_ID",
    "to": "6281234567890",
    "type": "text",
    "text": "Halo dari Volara!"
  }'
ts
const res = await fetch('https://api.volara.chat/api/v1/messages', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.VOLARA_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channelId: 'CHANNEL_ID',
    to: '6281234567890',
    type: 'text',
    text: 'Halo dari Volara!',
  }),
})

const data = await res.json()
console.log(data)
python
import os, requests

res = requests.post(
    "https://api.volara.chat/api/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['VOLARA_API_KEY']}"},
    json={
        "channelId": "CHANNEL_ID",
        "to": "6281234567890",
        "type": "text",
        "text": "Halo dari Volara!",
    },
)
print(res.json())

Hasil yang diharapkan

Respons 2xx berisi id pesan. Pesan akan muncul di Inbox sebagai pesan keluar, dan balasan kontak akan masuk ke percakapan yang sama.

Langkah selanjutnya ​