Volara Docs

Tema

Channel WhatsApp ​

WhatsApp adalah channel paling populer untuk percakapan dengan pelanggan di Indonesia. Panduan ini menjelaskan cara menghubungkan nomor WhatsApp ke Volara dan mulai berkomunikasi melalui Inbox maupun API.

Menghubungkan channel ​

  1. Buka Settings → Channels → WhatsApp di dashboard.
  2. Ikuti langkah otorisasi untuk menautkan nomor WhatsApp Business Anda.
  3. Setelah status menjadi Connected, catat channelId untuk dipakai di API.

Verifikasi nomor

Nomor harus memenuhi syarat WhatsApp Business. Nomor yang sudah dipakai di aplikasi WhatsApp personal pada perangkat lain perlu dilepas terlebih dahulu.

Mengirim pesan teks ​

Setelah channel aktif, kirim pesan lewat API:

bash
curl -X POST https://api.volara.chat/api/messages \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "CHANNEL_ID",
    "to": "6281234567890",
    "type": "text",
    "text": "Halo! Ada yang bisa kami bantu?"
  }'
ts
await fetch('https://api.volara.chat/api/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! Ada yang bisa kami bantu?',
  }),
})

Template & jendela 24 jam ​

WhatsApp membatasi pesan bebas (free-form) ke dalam jendela 24 jam sejak balasan terakhir pelanggan. Di luar jendela tersebut, gunakan template yang sudah disetujui. Kelola dan kirim template untuk Broadcast dan notifikasi terjadwal.

Menerima balasan ​

Balasan pelanggan otomatis masuk ke Inbox pada percakapan yang sama. Untuk diberi tahu secara real-time di sistem Anda, daftarkan webhook untuk event message.received (verifikasi tanda tangan HMAC-SHA256 sebelum memproses).

Langkah selanjutnya ​