Skip to main content

API WhatsApp Business

Sambung ke API WhatsApp Business rasmi Meta untuk menghantar kempen diperibadikan, mengautomasikan perbualan dan mengurus penglibatan pelanggan secara berskala.

Prasyarat

Akaun BeeCastly (peringkat percuma memadai)
Akaun Meta Business (business.facebook.com)
Nombor telefon perniagaan yang disahkan (belum digunakan di WhatsApp)
Pengesahan perniagaan telah selesai dalam Meta Business Manager

Panduan Persediaan

1Sambungkan WhatsApp dalam BeeCastly

Pergi ke Tetapan → Integrasi → WhatsApp dalam papan pemuka BeeCastly anda.
Klik "Sambung API WhatsApp Business". Anda akan dialihkan ke aliran pendaftaran terbenam Meta.
Ikut arahan untuk memilih akaun Meta Business dan nombor telefon anda.
Setelah disambungkan, ID Akaun WhatsApp Business, ID Nombor Telefon dan token akses anda akan dikonfigurasikan secara automatik.

2Cipta Templat Mesej

WhatsApp memerlukan templat yang telah diluluskan untuk mesej keluar (anda tidak boleh menghantar mesej bebas di luar tetingkap 24 jam).
Pergi ke Kempen → Templat dan klik "Cipta Templat".
Pilih satu kategori: Pemasaran, Utiliti, atau Pengesahan.
Tulis templat anda dengan pemboleh ubah seperti {{1}}, {{2}} untuk pemperibadian.
Hantar untuk semakan Meta. Kelulusan biasanya mengambil masa 1-24 jam.

3Hantar Kempen Siaran

Pergi ke Kempen → Siaran → Cipta.
Pilih WhatsApp sebagai saluran.
Pilih templat yang diluluskan dan khalayak anda (kenalan, tag atau segmen).
Petakan pemboleh ubah templat kepada medan kenalan (nama, telefon, medan tersuai).
Pratonton mesej tersebut, kemudian klik Hantar Sekarang atau Jadualkan.

4Urus Perbualan

Semua mesej WhatsApp masuk akan dipaparkan dalam Mesej → WhatsApp.
Balas pelanggan terus daripada peti masuk — dalam tetingkap 24 jam, anda boleh menghantar mesej bebas.
Aktifkan Balasan Automatik AI supaya bot AI anda mengendalikan pertanyaan biasa secara automatik.
Tugaskan perbualan kepada ahli pasukan untuk pengendalian secara manual.

Amalan Terbaik

Kekalkan penarafan kualiti yang tinggi

Kekalkan penarafan kualiti mesej anda pada tahap TINGGI dengan mengelakkan spam. Jika pengguna menyekat anda atau melaporkan mesej anda, Meta mungkin mengehadkan had penghantaran anda.

Dapatkan keizinan penyertaan

Sentiasa dapatkan keizinan yang jelas sebelum menghantar mesej pemasaran. Gunakan borang, widget laman web atau pengumpulan keizinan secara bersemuka.

Guna balasan automatik AI dengan bijak

Balasan automatik AI berfungsi paling baik apabila anda telah melatih bot anda dengan artikel pangkalan pengetahuan yang berkaitan. Sentiasa sediakan cara untuk pelanggan menghubungi ejen manusia.

Penting: Tetingkap Pemesejan 24 Jam

API WhatsApp Business mempunyai tetingkap pemesejan 24 jam. Anda hanya boleh menghantar mesej bebas dalam tempoh 24 jam selepas mesej terakhir pelanggan. Di luar tetingkap ini, anda mesti menggunakan templat yang diluluskan.

API Examples

Use the BeeCastly REST API to send WhatsApp messages programmatically.

bash
curl -X POST https://api.beecastly.com/api/whatsapp/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+1234567890",
    "message": "Hello from BeeCastly!"
  }
javascript·send-message.js
const response = await fetch('https://api.beecastly.com/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone: '+1234567890',
    message: 'Hello from BeeCastly!',
  }),
});

const data = await response.json();
console.log(data);

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

Ensure the recipient has opted in to receive messages. Check your WhatsApp Business Account health status in the Meta Business Manager.

Rate limits

WhatsApp Cloud API has rate limits. Start with small batches and scale gradually. Use the BeeCastly campaign scheduler to manage sending rates.

Frequently Asked Questions

How long does Meta verification take?
Meta Business verification typically takes 2-5 business days. Ensure your business documents are clear and match your Business Manager details.
Can I use my personal WhatsApp number?
No, you need a dedicated WhatsApp Business API number. This cannot be a personal WhatsApp or WhatsApp Business App number.
What is the cost per message?
WhatsApp charges per conversation (24-hour window), not per message. The first message in a conversation is charged; all subsequent messages within 24 hours are free.