Panduan

Dokumentasi API BalesOtomatis

Kirim pesan WhatsApp, template WhatsApp Business API, kelola kontak, dan jalankan broadcast dari aplikasi Anda sendiri.

BASEhttps://api.balesotomatis.co.id/public/v1

Aturan umum

Semua endpoint memakai metode POST dengan body JSON dan header Content-Type: application/json. Form x-www-form-urlencoded juga diterima.
Akhiran .php boleh ditulis, boleh tidak: /send_personal_message sama dengan /send_personal_message.php.
Kredensial dikirim di dalam body, bukan header. Lihat Autentikasi.
Kode hasil ada di field code di dalam body. Lihat Format jawaban.

Paket Lite belum bisa memakai API. Endpoint menjawab 403. Endpoint WhatsApp Business API juga membutuhkan kuota CoEx di akun Anda.

Langkah pertama

Ambil API key di member area, menu Integration → Kode Akses (Token).
Panggil Info akun & perangkat untuk mendapatkan number_id perangkat WhatsApp Anda.
Kirim pesan pertama dengan Kirim pesan teks / gambar. Contohnya ada di panel kanan.
Atur webhook untuk menerima pesan masuk dan status pengiriman.

Pesan pertama

curl -X POST https://api.balesotomatis.co.id/public/v1/send_personal_message \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "message": "Halo, pesanan Anda sudah dikirim."
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "message": "Halo, pesanan Anda sudah dikirim."
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_personal_message');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_personal_message', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "number_id": "NUMBER_ID_ANDA",
    "phone_no": "628123456789",
    "message": "Halo, pesanan Anda sudah dikirim."
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_personal_message',
    json={
        "api_key": "API_KEY_ANDA",
        "number_id": "NUMBER_ID_ANDA",
        "phone_no": "628123456789",
        "message": "Halo, pesanan Anda sudah dikirim.",
    },
    timeout=30,
)
data = res.json()

Jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully"
}

Panduan

Autentikasi

Tidak ada header Authorization. Kredensial dikirim sebagai field di body permintaan.

api_key dan secret_key adalah kunci yang sama, yaitu Kode Akses akun Anda. Namanya berbeda antar endpoint karena sejarah, jadi ikuti nama yang tertulis di tiap endpoint.

Pasangan kredensial

api_key + number_id: Pengiriman lewat perangkat WhatsApp yang Anda hubungkan dengan QR. number_id didapat dari Info akun & perangkat.
secret_key + licenses_key: Pengiriman lewat nomor resmi WhatsApp Business API. licenses_key tampil sebagai "Kunci Nomor" di halaman perangkat, atau lewat Daftar perangkat WABA.
api_key saja: Endpoint kontak, audiens, broadcast, dan akun.

Kode Akses ada di member area, menu Integration → Kode Akses (Token).

Simpan kredensial di server Anda. Kode Akses mewakili seluruh akun. Jangan menaruhnya di aplikasi web atau aplikasi ponsel yang bisa dibongkar pengguna.

Panduan

Format jawaban & kode

Jawaban selalu JSON dengan code dan message. Periksa isi code, karena sebagian endpoint menjawab HTTP 200 walaupun code berisi error.

code	Arti	Yang perlu diperiksa
`200`	Berhasil	Permintaan diterima. Untuk pengiriman, pesan diterima sistem, belum tentu sampai ke penerima. Status akhirnya datang lewat webhook status.
`400`	Tidak valid	Isi parameter tidak sesuai, atau batas kirim per menit terlewati.
`403`	Ditolak	Kode Akses salah, paket habis, atau paket belum mendukung fitur tersebut.
`404`	Tidak ditemukan	Perangkat pengirim, template, atau data yang dirujuk tidak ada.
`405`	Parameter kurang	Ada parameter wajib yang kosong, atau metode bukan POST.
`408`	Waktu habis	Server pengirim tidak menjawab. Coba lagi beberapa saat kemudian.

Kode error dari Meta

Untuk WhatsApp Business API, kegagalan sering datang dari Meta dan muncul di field errors pada webhook status.

Kode	Arti	Cara mengatasi
`131056`	Terlalu sering ke nomor yang sama	Beri jeda antar pengiriman ke nomor tersebut.
`132000`	Jumlah variabel tidak cocok	Banyaknya nilai di `variables` harus sama dengan jumlah `{{n}}` di template.
`132012`	Format parameter tidak sesuai	Periksa jenis dan urutan variabel, termasuk di header dan tombol. Untuk template ber-header gambar, video, atau dokumen, kirim `image_url` atau `file_url` bila media di template kosong.
`132001`	Template tidak ditemukan di akun pengirim	Template dibuat di nomor atau akun WhatsApp Business yang berbeda. Pastikan `licenses_key` dan `platform` sesuai tempat template dibuat, dan `template` berisi ID template yang benar.
`131047`	Di luar jendela 24 jam	Pesan bebas hanya bisa dikirim dalam 24 jam sejak penerima membalas. Di luar itu, kirim memakai template yang sudah disetujui.
`131042`	Masalah pembayaran akun bisnis	Ada tagihan Meta yang belum lunas atau metode pembayaran bermasalah. Periksa Penagihan di WhatsApp Manager.
`131026`	Pesan tidak terkirim ke nomor tujuan	Nomor penerima tidak terdaftar di WhatsApp atau tidak bisa menerima pesan. Bersihkan dari daftar tujuan.
`131031`	Akun WhatsApp Business dikunci	Cek Business Support Home di Meta untuk penyebab dan cara membukanya.

Webhook

Cara kerja webhook

BalesOtomatis mengirim POST ke URL Anda setiap ada pesan masuk, pesan keluar, atau perubahan status pengiriman.

Mengatur URL

Buka member area, menu Integration → Pengaturan Webhook.
Pilih nomor, lalu isi URL penerima. Satu nomor hanya punya satu URL.
Untuk n8n, daftarkan URL lewat Daftarkan webhook n8n. URL n8n menerima salinan event yang sama.

Bentuk permintaan

Metode POST, body JSON {type, data, spec}. spec selalu bo.omni.event.v1.
Header BLS-OTO-NUMBERID berisi kunci perangkat, sama dengan data.number_key.
Tidak ada tanda tangan. Pakai URL yang sulit ditebak, mis. berisi token acak, dan cocokkan number_key dengan perangkat Anda.
Tidak ada pengiriman ulang. Balas 200 secepatnya, lalu proses event di belakang.
Instagram dan Facebook belum mengirim event webhook.

Jenis event

Pesan masuk incoming_chat: WhatsApp (non-resmi), WhatsApp Business API
Pesan keluar outgoing_chat: WhatsApp (non-resmi)
Status pengiriman message_status: WhatsApp Business API

Menerima webhook

<?php
// webhook.php: balas 200 secepatnya, proses belakangan.
$event = json_decode(file_get_contents('php://input'), true);
$numberKey = $_SERVER['HTTP_BLS_OTO_NUMBERID'] ?? '';

if (($event['type'] ?? '') === 'message_status') {
    $d = $event['data'];
    // Perbarui status pesan $d['message_id'] menjadi $d['status']
}

http_response_code(200);
echo 'ok';

// Express
app.post('/webhook', express.json({ limit: '15mb' }), (req, res) => {
  res.sendStatus(200); // balas dulu, proses belakangan

  const { type, data } = req.body;
  const numberKey = req.get('BLS-OTO-NUMBERID');

  if (type === 'message_status') {
    // Perbarui status pesan data.message_id menjadi data.status
  }
});

# Flask
@app.post("/webhook")
def webhook():
    event = request.get_json(force=True)
    number_key = request.headers.get("BLS-OTO-NUMBERID")

    if event.get("type") == "message_status":
        d = event["data"]
        # Perbarui status pesan d["message_id"] menjadi d["status"]

    return "ok", 200

Header

{
  "Content-Type": "application/json",
  "BLS-OTO-NUMBERID": "LICENSES_KEY_ANDA"
}

Webhook

Pesan masuk

EVENTincoming_chat

Dikirim setiap ada pesan masuk ke nomor Anda: teks, media, lokasi, atau balasan tombol.

Kanal: WhatsApp (non-resmi) dan WhatsApp Business API

Isi `data`

data.number_keystring

Kunci perangkat penerima event: number_id untuk WhatsApp, licenses_key untuk WhatsApp Business API. Sama dengan header BLS-OTO-NUMBERID.

data.chat_idstring

Lawan bicara. WhatsApp Business API: nomor, mis. 628123456789. WhatsApp: JID, mis. 628123456789@s.whatsapp.net, …@lid, atau …@g.us untuk grup.

data.message_idstring

ID pesan. WhatsApp Business API memakai format wamid.….

data.namestring

Nama pengirim. Di WhatsApp Business API saat ini berisi nomor pengirim, bukan nama profil.

data.profile_picturestring

URL foto profil. Selalu kosong di WhatsApp Business API.

data.timestampstring | number

Waktu pesan dalam detik Unix. WhatsApp Business API mengirim string, WhatsApp mengirim angka.

data.message_bodystring

Isi teks, atau keterangan media. Bisa tidak ada sama sekali di WhatsApp kalau pesan tidak punya teks.

data.message_ackstring

Status pesan di sisi WhatsApp saat event dikirim, mis. SERVER_ACK.

data.has_mediaboolean

true kalau pesan berisi gambar, video, dokumen, atau audio.

data.media_mimestring

Jenis media, mis. image/jpeg.

data.media_namestring

Nama file (untuk dokumen).

data.media_bodystring

WhatsApp: isi file dalam base64. WhatsApp Business API: ID media Meta, unduh lewat Graph API.

data.location_attachedobject

{lat, lng} untuk pesan lokasi, selain itu berisi null.

data.is_forwadingboolean

Pesan diteruskan dari chat lain. Ejaan kunci memang is_forwading.

data.is_from_meboolean

true kalau pesan dikirim dari nomor Anda sendiri.

data.interactiveobject | nullWhatsApp Business API saja

Balasan tombol atau daftar: {type, id, title}, dengan description untuk daftar.

data.phone_numberstring | nullWhatsApp saja

Nomor lawan bicara tanpa akhiran JID. null kalau WhatsApp hanya memberi ID LID.

data.wa_idstring | nullWhatsApp saja

JID berbasis nomor, mis. 628123456789@s.whatsapp.net.

data.lidstring | nullWhatsApp saja

ID LID lawan bicara bila ada.

data.is_lidbooleanWhatsApp saja

true kalau chat_id berformat LID.

data.is_groupbooleanWhatsApp saja

true untuk pesan grup.

data.sender_idstring | nullWhatsApp saja

Khusus grup: JID anggota yang mengirim.

data.sender_phonestring | nullWhatsApp saja

Khusus grup: nomor anggota yang mengirim.

Batasan saat ini

WhatsApp Business API: stiker, reaksi, kartu kontak, klik tombol template, dan balasan Flow datang dengan message_body kosong.
WhatsApp Business API: pesan yang disunting atau dihapus pengirim tidak diteruskan.
WhatsApp: file base64 di atas 10 MB tidak terkirim ke webhook.

Contoh payload

{
  "type": "incoming_chat",
  "data": {
    "number_key": "LICENSES_KEY_ANDA",
    "chat_id": "628123456789",
    "message_id": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAEhgUM0VCMDRGQzE2",
    "name": "628123456789",
    "profile_picture": "",
    "timestamp": "1759050000",
    "message_body": "Halo, pesanan saya sudah dikirim?",
    "message_ack": "SERVER_ACK",
    "has_media": false,
    "media_mime": "",
    "media_name": "",
    "media_body": "",
    "location_attached": {
      "lat": null,
      "lng": null
    },
    "is_forwading": false,
    "is_from_me": false,
    "interactive": null
  },
  "spec": "bo.omni.event.v1"
}

Webhook

Pesan keluar

EVENToutgoing_chat

Dikirim setiap nomor WhatsApp Anda mengirim pesan, baik lewat API, dashboard, maupun langsung dari HP. Isinya sama dengan pesan masuk, dengan is_from_me bernilai true.

Kanal: WhatsApp (non-resmi)

Hanya untuk WhatsApp (non-resmi). Nomor WhatsApp Business API belum mengirim event ini: pesan yang dikirim dari aplikasi WhatsApp di HP pada nomor WhatsApp Business API tidak diteruskan ke webhook. Untuk pesan yang dikirim lewat BalesOtomatis (API, broadcast, CRM) pada nomor WhatsApp Business API, statusnya tersedia lewat event Status pengiriman.

Isi `data`

data.number_keystring

Kunci perangkat penerima event: number_id untuk WhatsApp, licenses_key untuk WhatsApp Business API. Sama dengan header BLS-OTO-NUMBERID.

data.chat_idstring

Lawan bicara. WhatsApp Business API: nomor, mis. 628123456789. WhatsApp: JID, mis. 628123456789@s.whatsapp.net, …@lid, atau …@g.us untuk grup.

data.message_idstring

ID pesan. WhatsApp Business API memakai format wamid.….

data.namestring

Nama pengirim. Di WhatsApp Business API saat ini berisi nomor pengirim, bukan nama profil.

data.profile_picturestring

URL foto profil. Selalu kosong di WhatsApp Business API.

data.timestampstring | number

Waktu pesan dalam detik Unix. WhatsApp Business API mengirim string, WhatsApp mengirim angka.

data.message_bodystring

Isi teks, atau keterangan media. Bisa tidak ada sama sekali di WhatsApp kalau pesan tidak punya teks.

data.message_ackstring

Status pesan di sisi WhatsApp saat event dikirim, mis. SERVER_ACK.

data.has_mediaboolean

true kalau pesan berisi gambar, video, dokumen, atau audio.

data.media_mimestring

Jenis media, mis. image/jpeg.

data.media_namestring

Nama file (untuk dokumen).

data.media_bodystring

WhatsApp: isi file dalam base64. WhatsApp Business API: ID media Meta, unduh lewat Graph API.

data.location_attachedobject

{lat, lng} untuk pesan lokasi, selain itu berisi null.

data.is_forwadingboolean

Pesan diteruskan dari chat lain. Ejaan kunci memang is_forwading.

data.is_from_meboolean

true kalau pesan dikirim dari nomor Anda sendiri.

data.phone_numberstring | null

Nomor lawan bicara tanpa akhiran JID. null kalau WhatsApp hanya memberi ID LID.

data.wa_idstring | null

JID berbasis nomor, mis. 628123456789@s.whatsapp.net.

data.lidstring | null

ID LID lawan bicara bila ada.

data.is_lidboolean

true kalau chat_id berformat LID.

data.is_groupboolean

true untuk pesan grup.

data.sender_idstring | null

Khusus grup: JID anggota yang mengirim.

data.sender_phonestring | null

Khusus grup: nomor anggota yang mengirim.

Batasan saat ini

WhatsApp (non-resmi) tidak mengirim event status terkirim atau dibaca.

Contoh payload

{
  "type": "outgoing_chat",
  "data": {
    "number_key": "NUMBER_ID_ANDA",
    "chat_id": "628123456789@s.whatsapp.net",
    "phone_number": "628123456789",
    "wa_id": "628123456789@s.whatsapp.net",
    "lid": null,
    "is_lid": false,
    "is_group": false,
    "sender_id": null,
    "sender_phone": null,
    "message_id": "3EB0C4A1F2D39B7E5A10",
    "name": "Budi",
    "profile_picture": "",
    "timestamp": 1759050000,
    "message_body": "Pesanan Anda sudah dikirim hari ini.",
    "message_ack": "SERVER_ACK",
    "has_media": false,
    "media_mime": "",
    "media_name": "",
    "media_body": "",
    "location_attached": {
      "lat": null,
      "lng": null
    },
    "is_forwading": false,
    "is_from_me": true
  },
  "spec": "bo.omni.event.v1"
}

Webhook

Status pengiriman

EVENTmessage_status

Dikirim setiap status pesan keluar berubah: terkirim, sampai di HP penerima, dibaca, atau gagal. Berlaku untuk semua pesan keluar dari nomor itu, termasuk template, broadcast, dan balasan AI.

Kanal: WhatsApp Business API

Mencocokkan dengan pesan yang Anda kirim

Simpan message dari jawaban kirim template (percakapan baru) atau kirim pesan bebas: nilainya adalah wamid. Cocokkan dengan data.message_id di event ini. Endpoint kirim template memproses pesan lewat antrean dan belum mengembalikan wamid, jadi untuk endpoint itu cocokkan dengan recipient_id dan waktu kirim.

Isi `data`

data.number_keystring

licenses_key perangkat pengirim.

data.message_idstring

ID pesan wamid.…, sama dengan ID yang dikembalikan endpoint kirim.

data.statusstring

sent, delivered, read, atau failed.

data.timestampstring

Waktu perubahan status dalam detik Unix.

data.recipient_idstring

Nomor penerima.

data.conversationobject | null

Objek percakapan dari Meta (id, origin.type).

data.pricingobject | null

Objek biaya dari Meta (billable, pricing_model, category).

data.errorsarray | null

Detail kegagalan dari Meta saat status bernilai failed, mis. kode 131026.

data.is_templateboolean

true kalau percakapan dimulai oleh bisnis (origin.type = business_initiated). Bukan penanda pasti bahwa pesan itu template.

Batasan saat ini

Satu pesan bisa menghasilkan beberapa event (sent, lalu delivered, lalu read). Urutan kedatangan tidak dijamin, jadi jangan menurunkan status yang sudah lebih tinggi.

Contoh payload

{
  "type": "message_status",
  "data": {
    "number_key": "LICENSES_KEY_ANDA",
    "message_id": "wamid.HBgNNjI4MTIzNDU2Nzg5FQIAERgSQjI3RkE1",
    "status": "delivered",
    "timestamp": "1759050042",
    "recipient_id": "628123456789",
    "conversation": {
      "id": "c0f1e2d3",
      "origin": {
        "type": "business_initiated"
      }
    },
    "pricing": {
      "billable": true,
      "pricing_model": "PMP",
      "category": "utility"
    },
    "errors": null,
    "is_template": true
  },
  "spec": "bo.omni.event.v1"
}

Kirim Pesan WhatsApp

Kirim pesan teks / gambar

POST/public/v1/send_personal_message

Mengirim pesan ke satu nomor WhatsApp. Bisa teks saja, gambar saja, atau gambar dengan keterangan.

Kredensial: api_key + number_id. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

number_idstringwajib

ID perangkat WhatsApp pengirim. Ambil dari endpoint info.

phone_nostringwajib*

Nomor tujuan, format internasional tanpa tanda plus, mis. 628123456789. Wajib kecuali Anda memakai bsuid.

bsuidstringopsional

Alternatif phone_no, memakai ID kontak internal BalesOtomatis.

messagestringwajib*

Isi pesan. Wajib kalau image_url tidak diisi.

image_urlstringopsional

URL gambar yang bisa diakses publik. Kalau diisi, message boleh kosong.

send_as_captionbooleanopsional

Kirim message sebagai keterangan gambar, bukan pesan terpisah.

country_codestringopsional

Kode negara kalau phone_no ditulis dalam format lokal.

enable_typingbooleanopsional

Tampilkan indikator sedang mengetik sebelum pesan terkirim.

quoted_msgstringopsional

ID pesan yang ingin dibalas (reply).

method_sendstringopsional

async untuk masuk antrean, atau kosongkan untuk kirim langsung.

message_uuidstringopsional

ID unik dari sisi Anda, dikembalikan lagi lewat webhook untuk pencocokan.

send_bystringopsional

Penanda pengirim, tampil di riwayat chat.

* wajib salah satu, lihat keterangan parameter.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_personal_message \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "message": "Halo, pesanan Anda sudah dikirim."
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "message": "Halo, pesanan Anda sudah dikirim."
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_personal_message');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_personal_message', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "number_id": "NUMBER_ID_ANDA",
    "phone_no": "628123456789",
    "message": "Halo, pesanan Anda sudah dikirim."
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_personal_message',
    json={
        "api_key": "API_KEY_ANDA",
        "number_id": "NUMBER_ID_ANDA",
        "phone_no": "628123456789",
        "message": "Halo, pesanan Anda sudah dikirim.",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kirim Pesan WhatsApp

Kirim file / dokumen

POST/public/v1/send_personal_file

Mengirim dokumen, PDF, gambar, atau video ke satu nomor WhatsApp.

Kredensial: api_key + number_id. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

number_idstringwajib

ID perangkat WhatsApp pengirim.

phone_nostringwajib

Nomor tujuan.

file_urlstringwajib

URL file yang bisa diakses publik.

messagestringopsional

Keterangan yang menyertai file.

country_codestringopsional

Kode negara.

enable_typingbooleanopsional

Indikator sedang mengetik.

quoted_msgstringopsional

ID pesan yang dibalas.

method_sendstringopsional

async untuk masuk antrean.

send_bystringopsional

Penanda pengirim.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_personal_file \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "file_url": "https://situs-anda.com/invoice.pdf",
  "message": "Invoice pesanan Anda"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "file_url": "https://situs-anda.com/invoice.pdf",
  "message": "Invoice pesanan Anda"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_personal_file');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_personal_file', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "number_id": "NUMBER_ID_ANDA",
    "phone_no": "628123456789",
    "file_url": "https://situs-anda.com/invoice.pdf",
    "message": "Invoice pesanan Anda"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_personal_file',
    json={
        "api_key": "API_KEY_ANDA",
        "number_id": "NUMBER_ID_ANDA",
        "phone_no": "628123456789",
        "file_url": "https://situs-anda.com/invoice.pdf",
        "message": "Invoice pesanan Anda",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kirim Pesan WhatsApp

Kirim pesan ke grup

POST/public/v1/send_group_message

Mengirim pesan teks atau gambar ke grup WhatsApp.

Kredensial: api_key + number_id. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

number_idstringwajib

ID perangkat WhatsApp pengirim.

group_idstringwajib

ID grup WhatsApp tujuan.

messagestringwajib

Isi pesan.

image_urlstringopsional

URL gambar yang bisa diakses publik.

send_as_captionbooleanopsional

Kirim pesan sebagai keterangan gambar.

enable_typingbooleanopsional

Indikator sedang mengetik.

method_sendstringopsional

async untuk masuk antrean.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_group_message \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "group_id": "1203630xxxxxx@g.us",
  "message": "Info untuk semua anggota grup"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "group_id": "1203630xxxxxx@g.us",
  "message": "Info untuk semua anggota grup"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_group_message');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_group_message', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "number_id": "NUMBER_ID_ANDA",
    "group_id": "1203630xxxxxx@g.us",
    "message": "Info untuk semua anggota grup"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_group_message',
    json={
        "api_key": "API_KEY_ANDA",
        "number_id": "NUMBER_ID_ANDA",
        "group_id": "1203630xxxxxx@g.us",
        "message": "Info untuk semua anggota grup",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kirim Pesan WhatsApp

Kirim file ke grup

POST/public/v1/send_group_file

Mengirim file atau dokumen ke grup WhatsApp.

Kredensial: api_key + number_id. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

number_idstringwajib

ID perangkat WhatsApp pengirim.

group_idstringwajib

ID grup WhatsApp tujuan.

messagestringwajib

Keterangan yang menyertai file.

image_urlstringopsional

URL file atau gambar yang bisa diakses publik.

send_as_captionbooleanopsional

Kirim pesan sebagai keterangan file.

method_sendstringopsional

async untuk masuk antrean.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_group_file \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "group_id": "1203630xxxxxx@g.us",
  "message": "Lampiran rapat",
  "image_url": "https://situs-anda.com/notulen.pdf"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "group_id": "1203630xxxxxx@g.us",
  "message": "Lampiran rapat",
  "image_url": "https://situs-anda.com/notulen.pdf"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_group_file');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_group_file', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "number_id": "NUMBER_ID_ANDA",
    "group_id": "1203630xxxxxx@g.us",
    "message": "Lampiran rapat",
    "image_url": "https://situs-anda.com/notulen.pdf"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_group_file',
    json={
        "api_key": "API_KEY_ANDA",
        "number_id": "NUMBER_ID_ANDA",
        "group_id": "1203630xxxxxx@g.us",
        "message": "Lampiran rapat",
        "image_url": "https://situs-anda.com/notulen.pdf",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kirim Pesan WhatsApp

Kirim reaksi emoji

POST/public/v1/send_reaction

Memberi reaksi emoji pada sebuah pesan di chat personal.

Kredensial: api_key + number_id. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

number_idstringwajib

ID perangkat WhatsApp pengirim.

phone_nostringwajib

Nomor lawan bicara.

message_idstringwajib

ID pesan yang ingin diberi reaksi.

emojistringwajib

Emoji reaksi, mis. 👍. Kirim string kosong untuk menghapus reaksi.

country_codestringopsional

Kode negara.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_reaction \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "message_id": "3EB0xxxxxxxx",
  "emoji": "👍"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "message_id": "3EB0xxxxxxxx",
  "emoji": "👍"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_reaction');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_reaction', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "number_id": "NUMBER_ID_ANDA",
    "phone_no": "628123456789",
    "message_id": "3EB0xxxxxxxx",
    "emoji": "👍"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_reaction',
    json={
        "api_key": "API_KEY_ANDA",
        "number_id": "NUMBER_ID_ANDA",
        "phone_no": "628123456789",
        "message_id": "3EB0xxxxxxxx",
        "emoji": "👍",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kirim Pesan WhatsApp

Hapus pesan

POST/public/v1/delete_message

Menghapus pesan yang sudah terkirim dari sisi perangkat Anda.

Kredensial: api_key + number_id. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

number_idstringwajib

ID perangkat WhatsApp pengirim.

chat_idstringwajib

ID chat tempat pesan berada.

message_idstringwajib

ID pesan yang akan dihapus.

licenses_keystringopsional

Kunci lisensi perangkat, kalau berbeda dari bawaan.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/delete_message \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "chat_id": "628123456789@s.whatsapp.net",
  "message_id": "3EB0xxxxxxxx"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "chat_id": "628123456789@s.whatsapp.net",
  "message_id": "3EB0xxxxxxxx"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/delete_message');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/delete_message', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "number_id": "NUMBER_ID_ANDA",
    "chat_id": "628123456789@s.whatsapp.net",
    "message_id": "3EB0xxxxxxxx"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/delete_message',
    json={
        "api_key": "API_KEY_ANDA",
        "number_id": "NUMBER_ID_ANDA",
        "chat_id": "628123456789@s.whatsapp.net",
        "message_id": "3EB0xxxxxxxx",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

OTP

Kirim kode OTP

POST/public/v1/send_otp

Membuat dan mengirim kode OTP ke nomor WhatsApp. Kode dibuat oleh sistem dan dikembalikan pada respons.

Kredensial: api_key + number_id. Cara mendapatkan

Endpoint ini memakai perangkat WhatsApp (dihubungkan dengan QR): kredensialnya api_key + number_id. number_id berbeda untuk tiap nomor, sedangkan api_key sama untuk seluruh akun. Nomor WhatsApp Business API memakai secret_key + licenses_key dan tidak bisa dipakai di endpoint ini; kirim lewat Kirim template.

Parameter body

api_keystringwajib

API key akun Anda.

number_idstringwajib

ID perangkat WhatsApp pengirim.

phone_nostringwajib

Nomor tujuan.

customer_namestringwajib

Nama penerima, dipakai di isi pesan.

service_namestringwajib

Nama layanan, mis. Login Dashboard.

company_namestringwajib

Nama perusahaan Anda.

lifetimeintegerwajib

Masa berlaku kode dalam detik, mis. 300 untuk 5 menit. Nilai kecil seperti 5 berarti kode kedaluwarsa dalam 5 detik.

country_codestringopsional

Kode negara.

custom_templatestringopsional

Templat pesan Anda sendiri, menggantikan templat bawaan. Wajib memuat {{code}}; placeholder lain yang tersedia: {{customer_name}}, {{service_name}}, {{company_name}}, {{expiry}} (mis. 5 minutes), dan {{lifetime}} (detik). Maksimal 1000 karakter. Kalau templat tidak memuat {{code}} atau terlalu panjang, pesan tetap terkirim dengan templat bawaan dan respons memuat field warning.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_otp \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "customer_name": "Budi",
  "service_name": "Login Dashboard",
  "company_name": "Toko ABC",
  "lifetime": 300
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "number_id": "NUMBER_ID_ANDA",
  "phone_no": "628123456789",
  "customer_name": "Budi",
  "service_name": "Login Dashboard",
  "company_name": "Toko ABC",
  "lifetime": 300
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_otp');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_otp', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "number_id": "NUMBER_ID_ANDA",
    "phone_no": "628123456789",
    "customer_name": "Budi",
    "service_name": "Login Dashboard",
    "company_name": "Toko ABC",
    "lifetime": 300
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_otp',
    json={
        "api_key": "API_KEY_ANDA",
        "number_id": "NUMBER_ID_ANDA",
        "phone_no": "628123456789",
        "customer_name": "Budi",
        "service_name": "Login Dashboard",
        "company_name": "Toko ABC",
        "lifetime": 300,
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "otp_code": "482913",
  "req_id": "..."
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

OTP

Verifikasi kode OTP

POST/public/v1/validate_otp

Memeriksa apakah kode OTP yang dimasukkan pengguna benar dan masih berlaku.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

otp_codestringwajib

Kode OTP yang dimasukkan pengguna.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/validate_otp \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "otp_code": "482913"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "otp_code": "482913"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/validate_otp');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/validate_otp', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "otp_code": "482913"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/validate_otp',
    json={
        "api_key": "API_KEY_ANDA",
        "otp_code": "482913",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

WhatsApp Business API

Kirim template

POST/public/v1/send_message_template

Mengirim template WhatsApp Business yang sudah disetujui Meta ke satu nomor. Pesan masuk antrean lebih dulu, lalu dikirim oleh worker.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Urutan variables harus sama persis dengan nomor variabel di template. Kalau template Anda memakai {{1}}, {{2}}, dan {{5}}, isi index 2 dan 3 dengan string kosong supaya posisi tidak bergeser. Jumlah nilai di variables harus sama dengan jumlah variabel di template; kalau kurang atau lebih, permintaan tetap dijawab 200 tetapi ditolak Meta saat pengiriman (kode 132000).

200 dengan message: "queued" berarti pesan masuk antrean, bukan konfirmasi terkirim. Pengiriman ke Meta dilakukan belakangan oleh worker. Pantau hasil akhirnya lewat webhook Status pengiriman. Endpoint ini belum mengembalikan ID pesan (wamid), jadi cocokkan event dengan recipient_id dan waktu kirim.

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringwajib

Kunci perangkat pengirim. Untuk platform whatsapp_bisnis_api isi kunci nomor dari tab WhatsApp Business API di Platform Manager; untuk whatsapp_cloud_api isi kunci koneksi dari tab WhatsApp Business (Cloud API). Template harus dibuat di nomor yang sama dengan pengirim ini.

recipientsstringwajib*

Nomor tujuan. Wajib kecuali Anda memakai bsuid.

bsuidstringopsional

Alternatif recipients, memakai ID kontak internal.

templatestringwajib

Template ID yang sudah berstatus APPROVED.

variablesarrayopsional

Nilai variabel body, berupa array string berurutan: index 0 untuk {{1}}, index 1 untuk {{2}}, dan seterusnya.

platformstringopsional

whatsapp_bisnis_api (bawaan; nomor yang disambung lewat "Mulai Daftar WhatsApp") atau whatsapp_cloud_api (koneksi Cloud API manual). Harus sesuai jenis koneksi dari licenses_key.

file_urlstringopsional

URL file untuk template ber-header DOCUMENT atau VIDEO. Harus bisa diakses publik.

fileNamestringopsional

Nama file yang tampil di chat penerima, mis. invoice.pdf.

messageTypestringopsional

MIME file, mis. application/pdf. Kalau dikosongkan, ditebak dari ekstensi file_url.

image_urlstringopsional

URL gambar untuk template ber-header IMAGE. Wajib dikirim bila template ber-header gambar dan kolom Media di Template Detail kosong. Tautan harus publik (bisa dibuka tanpa login).

quoted_msg_idstringopsional

ID pesan yang dibalas.

send_as_captionbooleanopsional

Kirim teks sebagai keterangan lampiran.

* wajib salah satu, lihat keterangan parameter.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_message_template \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "recipients": "628123456789",
  "platform": "whatsapp_bisnis_api",
  "template": "1234567890123456",
  "variables": [
    "Budi",
    "91",
    "Toko ABC"
  ],
  "file_url": "https://situs-anda.com/invoice.pdf",
  "fileName": "invoice.pdf"
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "recipients": "628123456789",
  "platform": "whatsapp_bisnis_api",
  "template": "1234567890123456",
  "variables": [
    "Budi",
    "91",
    "Toko ABC"
  ],
  "file_url": "https://situs-anda.com/invoice.pdf",
  "fileName": "invoice.pdf"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_message_template');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_message_template', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx",
    "recipients": "628123456789",
    "platform": "whatsapp_bisnis_api",
    "template": "1234567890123456",
    "variables": [
      "Budi",
      "91",
      "Toko ABC"
    ],
    "file_url": "https://situs-anda.com/invoice.pdf",
    "fileName": "invoice.pdf"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_message_template',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
        "recipients": "628123456789",
        "platform": "whatsapp_bisnis_api",
        "template": "1234567890123456",
        "variables": ["Budi", "91", "Toko ABC"],
        "file_url": "https://situs-anda.com/invoice.pdf",
        "fileName": "invoice.pdf",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "queued",
  "type": "successfully",
  "template": "1234567890123456",
  "bc_id": "..."
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

WhatsApp Business API

Kirim template (percakapan baru)

POST/public/v1/send_new_chat_template

Sama seperti kirim template, tetapi ditujukan untuk memulai percakapan baru dengan penerima yang belum pernah berinteraksi. Mendukung lampiran dan lokasi.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringwajib

Kunci lisensi perangkat WABA pengirim.

reciptientstringwajib

Nomor tujuan. Perhatikan ejaan parameter ini.

templatestringwajib

Template ID yang sudah disetujui.

recipientNamestringopsional

Nama penerima, dipakai untuk pencatatan kontak.

variablesarrayopsional

Nilai variabel body, array string berurutan.

platformstringopsional

whatsapp_bisnis_api atau whatsapp_cloud_api.

file_urlstringopsional

URL file lampiran.

fileNamestringopsional

Nama file yang tampil di chat.

messageTypestringopsional

MIME file lampiran.

image_urlstringopsional

URL gambar untuk header IMAGE.

latitudestringopsional

Garis lintang, untuk template berheader lokasi.

longitudestringopsional

Garis bujur.

nameLocationstringopsional

Nama lokasi.

quoted_msg_idstringopsional

ID pesan yang dibalas.

method_sendstringopsional

async untuk masuk antrean.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_new_chat_template \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "reciptient": "628123456789",
  "template": "1234567890123456",
  "recipientName": "Budi",
  "variables": [
    "Budi",
    "Toko ABC"
  ]
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "reciptient": "628123456789",
  "template": "1234567890123456",
  "recipientName": "Budi",
  "variables": [
    "Budi",
    "Toko ABC"
  ]
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_new_chat_template');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_new_chat_template', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx",
    "reciptient": "628123456789",
    "template": "1234567890123456",
    "recipientName": "Budi",
    "variables": [
      "Budi",
      "Toko ABC"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_new_chat_template',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
        "reciptient": "628123456789",
        "template": "1234567890123456",
        "recipientName": "Budi",
        "variables": ["Budi", "Toko ABC"],
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully",
  "template": "1234567890123456"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

WhatsApp Business API

Kirim pesan bebas (dalam 24 jam)

POST/public/v1/send_meta_personal_message

Mengirim pesan bebas lewat WhatsApp Business API. Hanya bisa dipakai kalau penerima menghubungi Anda lebih dulu dan masih dalam jendela 24 jam. Di luar itu, gunakan template.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringwajib

Kunci lisensi perangkat WABA pengirim.

reciptientstringwajib

Nomor tujuan.

messagestringopsional

Isi pesan teks.

typestringopsional

Jenis pesan, mis. text, image, document, audio, location, interactive.

image_urlstringopsional

URL gambar.

file_urlstringopsional

URL dokumen.

audio_urlstringopsional

URL berkas suara.

fileNamestringopsional

Nama file yang tampil di chat.

messageTypestringopsional

MIME lampiran.

interactiveobjectopsional

Objek pesan interaktif (tombol / daftar) sesuai format Meta.

latitudestringopsional

Garis lintang.

longitudestringopsional

Garis bujur.

nameLocationstringopsional

Nama lokasi.

quoted_msg_idstringopsional

ID pesan yang dibalas.

send_bystringopsional

Penanda pengirim di riwayat chat.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_meta_personal_message \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "reciptient": "628123456789",
  "message": "Terima kasih sudah menghubungi kami."
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "reciptient": "628123456789",
  "message": "Terima kasih sudah menghubungi kami."
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_meta_personal_message');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_meta_personal_message', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx",
    "reciptient": "628123456789",
    "message": "Terima kasih sudah menghubungi kami."
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_meta_personal_message',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
        "reciptient": "628123456789",
        "message": "Terima kasih sudah menghubungi kami.",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

WhatsApp Business API

Kirim katalog produk (carousel)

POST/public/v1/send_carousel_products

Mengirim beberapa produk sekaligus dalam bentuk kartu bergeser. Minimal dua produk.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringwajib

Kunci lisensi perangkat WABA pengirim.

reciptientstringwajib

Nomor tujuan.

product_idsarrayopsional

Daftar ID produk dari katalog Anda. Minimal 2 produk terkirim.

cardsarrayopsional

Susunan kartu buatan sendiri, sebagai ganti product_ids.

body_textstringopsional

Teks pembuka di atas kartu.

button_typestringopsional

Jenis tombol pada tiap kartu.

button_labelstringopsional

Tulisan pada tombol.

button_url_basestringopsional

Awalan URL tombol; ID produk ditambahkan di belakangnya.

limitintegeropsional

Batas jumlah kartu yang dikirim.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_carousel_products \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "reciptient": "628123456789",
  "product_ids": [
    "id1",
    "id2",
    "id3"
  ],
  "body_text": "Produk terbaru bulan ini"
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "reciptient": "628123456789",
  "product_ids": [
    "id1",
    "id2",
    "id3"
  ],
  "body_text": "Produk terbaru bulan ini"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_carousel_products');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_carousel_products', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx",
    "reciptient": "628123456789",
    "product_ids": [
      "id1",
      "id2",
      "id3"
    ],
    "body_text": "Produk terbaru bulan ini"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_carousel_products',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
        "reciptient": "628123456789",
        "product_ids": ["id1", "id2", "id3"],
        "body_text": "Produk terbaru bulan ini",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully",
  "products_sent": 3
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

WhatsApp Business API

Kirim reaksi emoji (WABA)

POST/public/v1/send_reaction_meta

Memberi reaksi emoji pada pesan di WhatsApp Business API.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringwajib

Kunci lisensi perangkat WABA.

reciptientstringwajib

Nomor lawan bicara.

message_idstringwajib

ID pesan yang diberi reaksi.

emojistringwajib

Emoji reaksi.

platformstringopsional

whatsapp_bisnis_api atau whatsapp_cloud_api.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/send_reaction_meta \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "reciptient": "628123456789",
  "message_id": "wamid.xxxx",
  "emoji": "❤️"
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "reciptient": "628123456789",
  "message_id": "wamid.xxxx",
  "emoji": "❤️"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/send_reaction_meta');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/send_reaction_meta', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx",
    "reciptient": "628123456789",
    "message_id": "wamid.xxxx",
    "emoji": "❤️"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/send_reaction_meta',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
        "reciptient": "628123456789",
        "message_id": "wamid.xxxx",
        "emoji": "❤️",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

WhatsApp Business API

Blokir kontak

POST/public/v1/block-contact-meta

Memblokir sebuah nomor pada perangkat WhatsApp Business API Anda.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringwajib

Kunci lisensi perangkat WABA.

phone_numberstringwajib

Nomor yang diblokir.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/block-contact-meta \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "phone_number": "628123456789"
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "phone_number": "628123456789"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/block-contact-meta');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/block-contact-meta', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx",
    "phone_number": "628123456789"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/block-contact-meta',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
        "phone_number": "628123456789",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Contact blocked successfully",
  "type": "successfully",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

WhatsApp Business API

Buka blokir kontak

POST/public/v1/unblock-contact-meta

Membuka blokir sebuah nomor pada perangkat WhatsApp Business API Anda.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringwajib

Kunci lisensi perangkat WABA.

phone_numberstringwajib

Nomor yang dibuka blokirnya.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/unblock-contact-meta \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "phone_number": "628123456789"
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "phone_number": "628123456789"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/unblock-contact-meta');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/unblock-contact-meta', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx",
    "phone_number": "628123456789"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/unblock-contact-meta',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
        "phone_number": "628123456789",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Contact unblocked successfully",
  "type": "successfully",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

WhatsApp Business API

Daftar kontak terblokir

POST/public/v1/list-blocked-contacts-meta

Menampilkan daftar nomor yang sedang diblokir pada perangkat WABA.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringwajib

Kunci lisensi perangkat WABA.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/list-blocked-contacts-meta \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx"
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/list-blocked-contacts-meta');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/list-blocked-contacts-meta', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/list-blocked-contacts-meta',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "type": "successfully",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Template & Perangkat

Daftar template

POST/public/v1/get-template-list

Menampilkan daftar template WhatsApp Business milik Anda, dengan pencarian dan pengurutan.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringopsional

Saring berdasarkan perangkat tertentu.

platformstringopsional

whatsapp_bisnis_api atau whatsapp_cloud_api.

searchstringopsional

Kata kunci pencarian nama template.

order_bystringopsional

Kolom pengurutan.

order_dirstringopsional

asc atau desc.

startintegeropsional

Baris awal untuk penomoran halaman.

lengthintegeropsional

Jumlah baris per halaman.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/get-template-list \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "start": 0,
  "length": 25
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx",
  "start": 0,
  "length": 25
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/get-template-list');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/get-template-list', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx",
    "start": 0,
    "length": 25
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/get-template-list',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
        "start": 0,
        "length": 25,
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "TotalRecords": 42,
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Template & Perangkat

Buat template baru

POST/public/v1/create-template

Mengajukan template baru ke Meta untuk ditinjau. Template baru bisa dipakai setelah statusnya APPROVED.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licensesKeystringwajib

Kunci lisensi perangkat WABA. Perhatikan penulisan camelCase pada parameter ini.

payloadobjectwajib

Isi template: nama, bahasa, kategori, body, header, footer, tombol, dan contoh variabel.

payload.headerobjectopsional

Header template. Untuk tipe IMAGE / VIDEO / DOCUMENT sertakan url berisi contoh berkas.

payload.variablesarrayopsional

Daftar variabel beserta contoh nilainya, tiap item berisi placeholder dan example.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/create-template \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licensesKey": "WB-xxxxxxx",
  "payload": {
    "name": "promo_agustus",
    "language": "id",
    "category": "MARKETING",
    "body": "Halo {{1}}, ada promo untuk Anda.",
    "header": {
      "type": "TEXT",
      "content": "Promo Spesial"
    },
    "variables": [
      {
        "placeholder": "{{1}}",
        "example": "Budi"
      }
    ]
  }
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licensesKey": "WB-xxxxxxx",
  "payload": {
    "name": "promo_agustus",
    "language": "id",
    "category": "MARKETING",
    "body": "Halo {{1}}, ada promo untuk Anda.",
    "header": {
      "type": "TEXT",
      "content": "Promo Spesial"
    },
    "variables": [
      {
        "placeholder": "{{1}}",
        "example": "Budi"
      }
    ]
  }
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/create-template');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/create-template', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licensesKey": "WB-xxxxxxx",
    "payload": {
      "name": "promo_agustus",
      "language": "id",
      "category": "MARKETING",
      "body": "Halo {{1}}, ada promo untuk Anda.",
      "header": {
        "type": "TEXT",
        "content": "Promo Spesial"
      },
      "variables": [
        {
          "placeholder": "{{1}}",
          "example": "Budi"
        }
      ]
    }
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/create-template',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licensesKey": "WB-xxxxxxx",
        "payload": {
            "name": "promo_agustus",
            "language": "id",
            "category": "MARKETING",
            "body": "Halo {{1}}, ada promo untuk Anda.",
            "header": {
                "type": "TEXT",
                "content": "Promo Spesial",
            },
            "variables": [
                {
                    "placeholder": "{{1}}",
                    "example": "Budi",
                },
            ],
        },
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully."
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Template & Perangkat

Daftar template tersetujui

POST/public/v1/list-template-whatsapp-official

Menampilkan template berstatus APPROVED untuk satu perangkat. Cocok dipakai untuk mengisi pilihan template di aplikasi Anda.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

licenses_keystringopsional

Kunci lisensi perangkat WABA.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/list-template-whatsapp-official \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx"
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA",
  "licenses_key": "WB-xxxxxxx"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/list-template-whatsapp-official');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/list-template-whatsapp-official', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA",
    "licenses_key": "WB-xxxxxxx"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/list-template-whatsapp-official',
    json={
        "secret_key": "SECRET_KEY_ANDA",
        "licenses_key": "WB-xxxxxxx",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Template & Perangkat

Daftar perangkat WABA

POST/public/v1/list-device-whatsapp-official

Menampilkan seluruh perangkat WhatsApp Business API pada akun Anda beserta kunci lisensinya.

Kredensial: secret_key + licenses_key. Cara mendapatkan

Parameter body

secret_keystringwajib

Secret key akun Anda.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/list-device-whatsapp-official \
  -H 'Content-Type: application/json' \
  -d '{
  "secret_key": "SECRET_KEY_ANDA"
}'

<?php
$body = <<<'JSON'
{
  "secret_key": "SECRET_KEY_ANDA"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/list-device-whatsapp-official');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/list-device-whatsapp-official', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "secret_key": "SECRET_KEY_ANDA"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/list-device-whatsapp-official',
    json={
        "secret_key": "SECRET_KEY_ANDA",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Template & Perangkat

Daftar perangkat WABA + limit harian

POST/public/v1/list-waba-devices

Sama seperti daftar perangkat, ditambah informasi batas kirim harian dari Meta untuk tiap nomor.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/list-waba-devices \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/list-waba-devices');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/list-waba-devices', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/list-waba-devices',
    json={
        "api_key": "API_KEY_ANDA",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Template & Perangkat

Template per perangkat

POST/public/v1/list-templates-by-device

Menampilkan template berstatus APPROVED untuk satu perangkat, memakai autentikasi API key.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

licensesKeystringwajib

Kunci lisensi perangkat. Perhatikan penulisan camelCase.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/list-templates-by-device \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "licensesKey": "WB-xxxxxxx"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "licensesKey": "WB-xxxxxxx"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/list-templates-by-device');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/list-templates-by-device', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "licensesKey": "WB-xxxxxxx"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/list-templates-by-device',
    json={
        "api_key": "API_KEY_ANDA",
        "licensesKey": "WB-xxxxxxx",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kontak

Buat daftar kontak

POST/public/v1/create-contact

Membuat sebuah daftar kontak (contact list) baru.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contacts_namestringwajib

Nama daftar kontak.

contacts_typestringopsional

Jenis daftar kontak.

whatsapp_idstringopsional

Kaitkan daftar ini dengan perangkat WhatsApp tertentu.

bsuidstringopsional

ID internal untuk pencocokan dari sistem Anda.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/create-contact \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contacts_name": "Pelanggan Agustus"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contacts_name": "Pelanggan Agustus"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/create-contact');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/create-contact', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contacts_name": "Pelanggan Agustus"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/create-contact',
    json={
        "api_key": "API_KEY_ANDA",
        "contacts_name": "Pelanggan Agustus",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully.",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kontak

Daftar semua kontak list

POST/public/v1/get-list-contacts

Menampilkan daftar kontak milik Anda dengan pencarian, pengurutan, dan penomoran halaman.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

startintegeropsional

Baris awal.

lengthintegeropsional

Jumlah baris per halaman.

searchstringopsional

Kata kunci pencarian.

order_bystringopsional

Kolom pengurutan.

order_dirstringopsional

asc atau desc.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/get-list-contacts \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "start": 0,
  "length": 25
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "start": 0,
  "length": 25
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/get-list-contacts');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/get-list-contacts', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "start": 0,
    "length": 25
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/get-list-contacts',
    json={
        "api_key": "API_KEY_ANDA",
        "start": 0,
        "length": 25,
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kontak

Detail kontak list

POST/public/v1/get-contact-detail

Menampilkan rincian satu daftar kontak.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contact_idstringwajib

ID daftar kontak. Bisa berupa angka atau ID terenkripsi.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/get-contact-detail \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/get-contact-detail');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/get-contact-detail', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contact_id": "123"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/get-contact-detail',
    json={
        "api_key": "API_KEY_ANDA",
        "contact_id": "123",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully.",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kontak

Ubah nama kontak list

POST/public/v1/update-contact-name

Mengganti nama sebuah daftar kontak.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contact_idstringwajib

ID daftar kontak.

contacts_namestringwajib

Nama baru.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/update-contact-name \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "contacts_name": "Pelanggan September"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "contacts_name": "Pelanggan September"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/update-contact-name');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/update-contact-name', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contact_id": "123",
    "contacts_name": "Pelanggan September"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/update-contact-name',
    json={
        "api_key": "API_KEY_ANDA",
        "contact_id": "123",
        "contacts_name": "Pelanggan September",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully."
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kontak

Hapus kontak list

POST/public/v1/delete-contact

Menghapus sebuah daftar kontak beserta isinya.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contact_idstringwajib

ID daftar kontak.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/delete-contact \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/delete-contact');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/delete-contact', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contact_id": "123"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/delete-contact',
    json={
        "api_key": "API_KEY_ANDA",
        "contact_id": "123",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully."
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kontak

Daftar ringkas kontak list

POST/public/v1/list-contact-lists

Versi ringkas dari daftar kontak, hanya berisi ID dan nama. Cocok untuk mengisi dropdown.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/list-contact-lists \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/list-contact-lists');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/list-contact-lists', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/list-contact-lists',
    json={
        "api_key": "API_KEY_ANDA",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kontak

Daftar kolom kustom

POST/public/v1/get-contact-fields

Menampilkan kolom kustom yang tersedia pada satu atau beberapa daftar kontak. Berguna untuk menyusun pemetaan variabel broadcast.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contacts_idsarrayopsional

Daftar ID kontak list yang ingin diperiksa.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/get-contact-fields \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contacts_ids": [
    "123",
    "124"
  ]
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contacts_ids": [
    "123",
    "124"
  ]
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/get-contact-fields');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/get-contact-fields', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contacts_ids": [
      "123",
      "124"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/get-contact-fields',
    json={
        "api_key": "API_KEY_ANDA",
        "contacts_ids": ["123", "124"],
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Kontak

Hitung kontak unik

POST/public/v1/count-unique-contacts

Menghitung jumlah nomor unik dari gabungan beberapa daftar kontak, tanpa duplikat.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contacts_idsarrayopsional

Daftar ID kontak list yang digabung.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/count-unique-contacts \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contacts_ids": [
    "123",
    "124"
  ]
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contacts_ids": [
    "123",
    "124"
  ]
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/count-unique-contacts');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/count-unique-contacts', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contacts_ids": [
      "123",
      "124"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/count-unique-contacts',
    json={
        "api_key": "API_KEY_ANDA",
        "contacts_ids": ["123", "124"],
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": {
    "total": 1280
  }
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Audiens

Daftar audiens

POST/public/v1/get-list-audiences

Menampilkan isi sebuah daftar kontak, yaitu nama dan nomor tiap audiens beserta kolom kustomnya.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contact_idstringopsional

Saring berdasarkan daftar kontak tertentu.

startintegeropsional

Baris awal.

lengthintegeropsional

Jumlah baris per halaman.

searchstringopsional

Kata kunci pencarian.

order_bystringopsional

Kolom pengurutan.

order_dirstringopsional

asc atau desc.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/get-list-audiences \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "start": 0,
  "length": 25
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "start": 0,
  "length": 25
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/get-list-audiences');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/get-list-audiences', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contact_id": "123",
    "start": 0,
    "length": 25
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/get-list-audiences',
    json={
        "api_key": "API_KEY_ANDA",
        "contact_id": "123",
        "start": 0,
        "length": 25,
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Audiens

Detail audiens

POST/public/v1/get-audience-detail

Menampilkan rincian satu audiens, termasuk seluruh kolom kustomnya.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contact_idstringwajib

ID daftar kontak.

audience_idstringwajib

ID audiens.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/get-audience-detail \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "audience_id": "456"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "audience_id": "456"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/get-audience-detail');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/get-audience-detail', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contact_id": "123",
    "audience_id": "456"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/get-audience-detail',
    json={
        "api_key": "API_KEY_ANDA",
        "contact_id": "123",
        "audience_id": "456",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully.",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Audiens

Tambah audiens

POST/public/v1/insert-audiences-by-contact

Menambahkan satu atau banyak audiens ke dalam sebuah daftar kontak, lengkap dengan kolom kustom.

Kredensial: api_key. Cara mendapatkan

Penambahan audiens tunduk pada batas jumlah kontak paket Anda. Kalau melebihi batas, permintaan ditolak.

Parameter body

api_keystringwajib

API key akun Anda.

contact_idstringwajib

ID daftar kontak tujuan.

audiencesarraywajib

Daftar audiens. Tiap item berisi name, wa_number, dan opsional custom_fields.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/insert-audiences-by-contact \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "audiences": [
    {
      "name": "Budi",
      "wa_number": "628123456789",
      "custom_fields": {
        "kota": "Bandung"
      }
    }
  ]
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "audiences": [
    {
      "name": "Budi",
      "wa_number": "628123456789",
      "custom_fields": {
        "kota": "Bandung"
      }
    }
  ]
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/insert-audiences-by-contact');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/insert-audiences-by-contact', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contact_id": "123",
    "audiences": [
      {
        "name": "Budi",
        "wa_number": "628123456789",
        "custom_fields": {
          "kota": "Bandung"
        }
      }
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/insert-audiences-by-contact',
    json={
        "api_key": "API_KEY_ANDA",
        "contact_id": "123",
        "audiences": [
            {
                "name": "Budi",
                "wa_number": "628123456789",
                "custom_fields": {
                    "kota": "Bandung",
                },
            },
        ],
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully.",
  "data": {},
  "meta": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Audiens

Ubah audiens

POST/public/v1/update-audience

Memperbarui nama, nomor, atau kolom kustom seorang audiens.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

contact_idstringwajib

ID daftar kontak.

audience_idstringwajib

ID audiens.

namestringopsional

Nama baru.

wa_numberstringopsional

Nomor WhatsApp baru.

custom_fieldsobjectopsional

Pasangan kolom kustom dan nilainya.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/update-audience \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "audience_id": "456",
  "name": "Budi Santoso",
  "custom_fields": {
    "kota": "Jakarta"
  }
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "contact_id": "123",
  "audience_id": "456",
  "name": "Budi Santoso",
  "custom_fields": {
    "kota": "Jakarta"
  }
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/update-audience');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/update-audience', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "contact_id": "123",
    "audience_id": "456",
    "name": "Budi Santoso",
    "custom_fields": {
      "kota": "Jakarta"
    }
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/update-audience',
    json={
        "api_key": "API_KEY_ANDA",
        "contact_id": "123",
        "audience_id": "456",
        "name": "Budi Santoso",
        "custom_fields": {
            "kota": "Jakarta",
        },
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully.",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Audiens

Hapus audiens

POST/public/v1/delete-audience

Menghapus seorang audiens dari daftar kontak.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

audience_idstringwajib

ID audiens.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/delete-audience \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "audience_id": "456"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "audience_id": "456"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/delete-audience');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/delete-audience', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "audience_id": "456"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/delete-audience',
    json={
        "api_key": "API_KEY_ANDA",
        "audience_id": "456",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully."
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Buat broadcast

POST/public/v1/create-broadcast-official

Membuat draf broadcast baru. Setelah dibuat, isi dan jalankan lewat publish-broadcast.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

bc_titlestringwajib

Nama broadcast.

bc_typestringopsional

Jenis broadcast.

scheduled_atstringopsional

Waktu penjadwalan, format YYYY-MM-DD HH:MM:SS.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/create-broadcast-official \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "bc_title": "Promo Agustus"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "bc_title": "Promo Agustus"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/create-broadcast-official');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/create-broadcast-official', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "bc_title": "Promo Agustus"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/create-broadcast-official',
    json={
        "api_key": "API_KEY_ANDA",
        "bc_title": "Promo Agustus",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Broadcast berhasil dibuat",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Jalankan broadcast

POST/public/v1/publish-broadcast

Mengisi draf broadcast dengan perangkat, template, dan daftar kontak, lalu menjalankannya.

Kredensial: api_key. Cara mendapatkan

Broadcast yang sudah berjalan tidak bisa dijalankan ulang. Template harus berstatus APPROVED dan perangkat WABA harus dalam keadaan terhubung.

Parameter body

api_keystringwajib

API key akun Anda.

broadcast_idstringwajib

ID broadcast yang akan dijalankan.

deviceWabastringwajib

Kunci lisensi perangkat WABA pengirim.

deviceWabaTypestringopsional

Jenis perangkat WABA.

templateIdstringwajib

Template ID berstatus APPROVED.

contacts_selectedarraywajib

Daftar ID kontak list yang dikirimi. Minimal satu.

variable_mappingobjectopsional

Pemetaan nomor variabel ke kolom kontak, mis. {"1":"fullname"}.

time_to_sendstringopsional

Waktu mulai pengiriman.

sending_speedintegeropsional

Jeda antar pesan, untuk mengatur kecepatan kirim.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/publish-broadcast \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "...",
  "deviceWaba": "WB-xxxxxxx",
  "templateId": "1234567890123456",
  "contacts_selected": [
    "123"
  ],
  "variable_mapping": {
    "1": "fullname"
  }
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "...",
  "deviceWaba": "WB-xxxxxxx",
  "templateId": "1234567890123456",
  "contacts_selected": [
    "123"
  ],
  "variable_mapping": {
    "1": "fullname"
  }
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/publish-broadcast');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/publish-broadcast', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "broadcast_id": "...",
    "deviceWaba": "WB-xxxxxxx",
    "templateId": "1234567890123456",
    "contacts_selected": [
      "123"
    ],
    "variable_mapping": {
      "1": "fullname"
    }
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/publish-broadcast',
    json={
        "api_key": "API_KEY_ANDA",
        "broadcast_id": "...",
        "deviceWaba": "WB-xxxxxxx",
        "templateId": "1234567890123456",
        "contacts_selected": ["123"],
        "variable_mapping": {
            "1": "fullname",
        },
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully."
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Daftar broadcast

POST/public/v1/list-broadcasts-official

Menampilkan daftar broadcast beserta statusnya, dengan penyaringan tanggal dan status.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

searchstringopsional

Kata kunci nama broadcast.

statusstringopsional

Saring berdasarkan status.

from_datestringopsional

Tanggal awal, format YYYY-MM-DD.

to_datestringopsional

Tanggal akhir.

pageintegeropsional

Nomor halaman.

per_pageintegeropsional

Jumlah baris per halaman.

sort_bystringopsional

Kolom pengurutan.

sort_dirstringopsional

asc atau desc.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/list-broadcasts-official \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "page": 1,
  "per_page": 25
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "page": 1,
  "per_page": 25
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/list-broadcasts-official');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/list-broadcasts-official', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "page": 1,
    "per_page": 25
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/list-broadcasts-official',
    json={
        "api_key": "API_KEY_ANDA",
        "page": 1,
        "per_page": 25,
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": []
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Detail broadcast

POST/public/v1/get-broadcast-detail

Menampilkan rincian satu broadcast, termasuk isi pesan dan daftar penerimanya.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

broadcast_idstringwajib

ID broadcast.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/get-broadcast-detail \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "..."
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "..."
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/get-broadcast-detail');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/get-broadcast-detail', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "broadcast_id": "..."
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/get-broadcast-detail',
    json={
        "api_key": "API_KEY_ANDA",
        "broadcast_id": "...",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Ubah nama broadcast

POST/public/v1/rename-broadcast-official

Mengganti nama sebuah broadcast.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

broadcast_idstringwajib

ID broadcast.

bc_namestringwajib

Nama baru.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/rename-broadcast-official \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "...",
  "bc_name": "Promo September"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "...",
  "bc_name": "Promo September"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/rename-broadcast-official');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/rename-broadcast-official', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "broadcast_id": "...",
    "bc_name": "Promo September"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/rename-broadcast-official',
    json={
        "api_key": "API_KEY_ANDA",
        "broadcast_id": "...",
        "bc_name": "Promo September",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Nama broadcast berhasil diubah"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Duplikat broadcast

POST/public/v1/duplicate-broadcast-official

Menyalin sebuah broadcast beserta isinya menjadi draf baru.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

broadcast_idstringwajib

ID broadcast yang disalin.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/duplicate-broadcast-official \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "..."
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "..."
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/duplicate-broadcast-official');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/duplicate-broadcast-official', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "broadcast_id": "..."
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/duplicate-broadcast-official',
    json={
        "api_key": "API_KEY_ANDA",
        "broadcast_id": "...",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Broadcast berhasil diduplikasi",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Hentikan broadcast

POST/public/v1/stop-broadcast-official

Menghentikan broadcast yang sedang berjalan. Pesan yang masih di antrean dibatalkan; pesan yang sudah terkirim tidak bisa ditarik kembali.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

broadcast_idstringwajib

ID broadcast.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/stop-broadcast-official \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "..."
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "..."
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/stop-broadcast-official');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/stop-broadcast-official', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "broadcast_id": "..."
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/stop-broadcast-official',
    json={
        "api_key": "API_KEY_ANDA",
        "broadcast_id": "...",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Broadcast berhasil dihentikan"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Hapus broadcast

POST/public/v1/delete-broadcast-official

Menghapus sebuah broadcast.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

broadcast_idstringwajib

ID broadcast.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/delete-broadcast-official \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "..."
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "broadcast_id": "..."
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/delete-broadcast-official');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/delete-broadcast-official', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "broadcast_id": "..."
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/delete-broadcast-official',
    json={
        "api_key": "API_KEY_ANDA",
        "broadcast_id": "...",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Broadcast berhasil dihapus"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Broadcast

Ringkasan performa broadcast

POST/public/v1/broadcast-analytics

Menampilkan ringkasan jumlah terkirim, gagal, dan status broadcast dalam rentang tanggal tertentu.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

from_datestringwajib

Tanggal awal, format YYYY-MM-DD.

to_datestringwajib

Tanggal akhir.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/broadcast-analytics \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "from_date": "2026-08-01",
  "to_date": "2026-08-31"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "from_date": "2026-08-01",
  "to_date": "2026-08-31"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/broadcast-analytics');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/broadcast-analytics', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "from_date": "2026-08-01",
    "to_date": "2026-08-31"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/broadcast-analytics',
    json={
        "api_key": "API_KEY_ANDA",
        "from_date": "2026-08-01",
        "to_date": "2026-08-31",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Akun & Webhook

Periksa API key

POST/public/v1/validate-api-key

Memeriksa apakah API key valid dan paketnya masih aktif. Cocok dipakai saat pengguna memasukkan API key di aplikasi Anda.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key yang diperiksa.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/validate-api-key \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/validate-api-key');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/validate-api-key', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/validate-api-key',
    json={
        "api_key": "API_KEY_ANDA",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully.",
  "type": "successfully"
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Akun & Webhook

Info akun & perangkat

POST/public/v1/info

Menampilkan informasi paket, akun, zona waktu, dan daftar perangkat WhatsApp Anda beserta status koneksinya. Di sinilah Anda mendapatkan number_id.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/info \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/info');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/info', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/info',
    json={
        "api_key": "API_KEY_ANDA",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "message": "Successfully.",
  "info": {
    "package": {
      "name": "pro",
      "active_from": "2026-01-01",
      "active_until": "2026-12-31"
    },
    "user": {
      "email": "anda@contoh.com",
      "registered_at": "2025-03-01 10:00:00"
    },
    "timezone": "Asia/Jakarta",
    "devices": [
      {
        "number_id": "NUMBER_ID_ANDA",
        "number_whatsapp": "628123456789",
        "state_connection": "connected",
        "last_connected_at": "2026-08-31 09:00:00"
      }
    ]
  }
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Akun & Webhook

Daftarkan webhook n8n

POST/public/v1/register-webhook-n8n

Mendaftarkan URL webhook n8n untuk seluruh perangkat pada akun Anda. Setidaknya salah satu dari URL produksi atau URL pengembangan harus diisi.

Kredensial: api_key. Cara mendapatkan

Parameter body

api_keystringwajib

API key akun Anda.

webhook_url_prodstringwajib*

URL webhook produksi. Harus diawali http:// atau https://.

webhook_url_devstringwajib*

URL webhook pengembangan.

* wajib salah satu, lihat keterangan parameter.

Permintaan

curl -X POST https://api.balesotomatis.co.id/public/v1/register-webhook-n8n \
  -H 'Content-Type: application/json' \
  -d '{
  "api_key": "API_KEY_ANDA",
  "webhook_url_prod": "https://n8n-anda.com/webhook/balesotomatis"
}'

<?php
$body = <<<'JSON'
{
  "api_key": "API_KEY_ANDA",
  "webhook_url_prod": "https://n8n-anda.com/webhook/balesotomatis"
}
JSON;

$ch = curl_init('https://api.balesotomatis.co.id/public/v1/register-webhook-n8n');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://api.balesotomatis.co.id/public/v1/register-webhook-n8n', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "api_key": "API_KEY_ANDA",
    "webhook_url_prod": "https://n8n-anda.com/webhook/balesotomatis"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    'https://api.balesotomatis.co.id/public/v1/register-webhook-n8n',
    json={
        "api_key": "API_KEY_ANDA",
        "webhook_url_prod": "https://n8n-anda.com/webhook/balesotomatis",
    },
    timeout=30,
)
data = res.json()

Contoh jawaban

{
  "code": "200",
  "success": true,
  "message": "Successfully.",
  "data": {}
}

Coba dari akun Anda

Kirim permintaan ini langsung dari member area, dengan Kode Akses dan perangkat terisi otomatis.

Segera hadir

Dokumentasi API BalesOtomatis

Aturan umum

Langkah pertama

Autentikasi

Pasangan kredensial

Format jawaban & kode

Kode error dari Meta

Cara kerja webhook

Mengatur URL

Bentuk permintaan

Jenis event

Pesan masuk

Isi data

Batasan saat ini

Pesan keluar

Isi data

Batasan saat ini

Status pengiriman

Mencocokkan dengan pesan yang Anda kirim

Isi data

Batasan saat ini

Kirim pesan teks / gambar

Parameter body

Kirim file / dokumen

Parameter body

Kirim pesan ke grup

Parameter body

Kirim file ke grup

Parameter body

Kirim reaksi emoji

Parameter body

Hapus pesan

Parameter body

Kirim kode OTP

Parameter body

Verifikasi kode OTP

Parameter body

Kirim template

Parameter body

Kirim template (percakapan baru)

Parameter body

Kirim pesan bebas (dalam 24 jam)

Parameter body

Kirim katalog produk (carousel)

Parameter body

Kirim reaksi emoji (WABA)

Parameter body

Blokir kontak

Parameter body

Buka blokir kontak

Parameter body

Daftar kontak terblokir

Parameter body

Daftar template

Parameter body

Buat template baru

Parameter body

Daftar template tersetujui

Parameter body

Daftar perangkat WABA

Parameter body

Daftar perangkat WABA + limit harian

Parameter body

Template per perangkat

Parameter body

Buat daftar kontak

Parameter body

Daftar semua kontak list

Parameter body

Detail kontak list

Parameter body

Ubah nama kontak list

Parameter body

Hapus kontak list

Parameter body

Daftar ringkas kontak list

Parameter body

Daftar kolom kustom

Parameter body

Hitung kontak unik

Isi `data`

Isi `data`

Isi `data`