Skip to main content
DokumentasiPanduanWhatsApp

API Bisnis WhatsApp

Hubungkan nomor WhatsApp Anda ke BeeCastly untuk chat dengan pelanggan, membiarkan AI membalas untuk Anda, dan mengirim siaran. Anda bisa terhubung dengan memindai kode QR, atau lewat Meta WhatsApp Cloud API resmi.

Prasyarat

Akun BeeCastly (paket gratis pun bisa)
Akun Meta Business (business.facebook.com)
Untuk metode Cloud API: akun Meta Business (business.facebook.com) dan nomor telepon untuk didaftarkan ke Meta

Dua cara untuk terhubung

Pindai kode QR

Tautkan nomor yang sudah Anda pakai, termasuk nomor WhatsApp Business App, seperti WhatsApp Web. Gratis dan tidak memerlukan persetujuan Meta. Terbaik untuk balasan dan balasan otomatis. Jangan dipakai untuk siaran massal: WhatsApp bisa memblokir nomor tersebut.

WhatsApp Cloud API (Meta)

Cara resmi dari Meta. Memerlukan akun Meta Business dan templat pesan yang disetujui. Ini metode yang dipakai untuk siaran dan kampanye.

Panduan Penyiapan

1Hubungkan WhatsApp di BeeCastly

Buka Integrasi → Saluran → WhatsApp.
Kode QR: pilih WhatsApp QR. Di ponsel Anda, buka WhatsApp → Perangkat tertaut → Tautkan perangkat dan pindai kodenya. Ponsel Anda tetap berfungsi seperti biasa.
Cloud API: pilih WhatsApp Cloud API (Meta) dan klik Hubungkan dengan Facebook. Pilih akun Meta Business dan nomor telepon Anda. Jika Anda lebih suka melakukannya manual, Wizard Langkah demi Langkah meminta Meta App ID, WhatsApp Business Account ID, Phone Number ID, dan token akses Anda.

2Buat Templat Pesan

Di Cloud API, Anda hanya bisa mengirim teks bebas dalam 24 jam setelah pesan terakhir pelanggan. Di luar jendela itu Anda memerlukan templat yang sudah disetujui Meta.
Buka Kampanye → Templat dan buat templat.
Pilih kategori: Marketing, Utility, atau Authentication.
Tambahkan variabel seperti {{1}} dan {{2}} untuk nama dan detail lainnya.
Kirimkan. Meta meninjaunya dan statusnya diperbarui di BeeCastly.

3Kirim Kampanye Siaran

Buka Kampanye → Siaran → Buat.
Pilih WhatsApp sebagai salurannya.
Pilih templat yang telah disetujui dan audiens Anda (kontak, tag, atau segmen).
Petakan variabel templat ke kolom kontak (nama, telepon, kolom khusus).
Pratinjau pesannya, lalu klik Kirim Sekarang atau Jadwalkan.

4Kelola Percakapan

Pesan WhatsApp masuk tiba di Pesan → WhatsApp (dan di Semua Pesan).
Balas dari kotak masuk, gunakan Balasan Cepat untuk jawaban yang sering Anda kirim, dan tugaskan chat ke anggota tim.
Aktifkan balasan AI agar chatbot Anda menjawab pertanyaan umum dari Basis Pengetahuan Anda, dan serahkan ke orang bila perlu.

5Alat WhatsApp lainnya

Pesan → Status Studio: posting status WhatsApp.
Pesan → Tautan wa.me: buat tautan klik-untuk-chat atau kode QR untuk situs web dan poster Anda.
Integrasi → Saluran → WhatsApp: edit profil bisnis dan katalog produk Anda (Cloud API).

Praktik Terbaik

Pertahankan peringkat kualitas yang tinggi

Jaga peringkat kualitas pesan Anda tetap TINGGI dengan menghindari spam. Jika pengguna memblokir Anda atau melaporkan pesan Anda, Meta dapat membatasi kuota pengiriman Anda.

Dapatkan persetujuan berlangganan

Dapatkan izin yang jelas sebelum mengirim pesan pemasaran, misalnya lewat formulir, chat situs web, atau secara langsung.

Gunakan balasan otomatis AI dengan bijak

Balasan AI bekerja paling baik jika Basis Pengetahuan Anda berisi harga, jam buka, dan kebijakan Anda. Selalu sediakan cara bagi pelanggan untuk menghubungi orang sungguhan.

Penting: jendela 24 jam (Cloud API)

Di WhatsApp Cloud API, Anda hanya bisa mengirim teks bebas dalam 24 jam setelah pesan terakhir pelanggan. Di luar jendela ini Anda harus memakai templat yang sudah disetujui.

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly