01Cara kerja Cloud API
Cloud API adalah bagian dari WhatsApp Business Platform. Meta yang menjalankan servernya, jadi bisnis tidak perlu memasang dan merawat server WhatsApp sendiri.
- Bisnis punya WhatsApp Business Account atau WABA, dan nomor telepon bisnis yang didaftarkan ke Cloud API.
- Aplikasi bisnis atau penyedia layanan memakai token akses untuk memanggil API Meta setiap kali mengirim pesan.
- Saat customer mengirim pesan, Meta meneruskannya ke alamat webhook yang sudah didaftarkan.
- Meta juga mengirim status pesan keluar lewat webhook, misalnya terkirim, dibaca, atau gagal.
- Sistem Anda menyimpan pesan, menjalankan aturannya sendiri, lalu membalas lewat API.
02Cloud API dibanding jalur lain
| Aspek | Cloud API | Aplikasi WhatsApp Business | Perangkat tertaut (QR) |
|---|---|---|---|
| Cara kerja | Meta meng-host API, sistem Anda memanggilnya. | Dipakai langsung di ponsel. | Sesi ditautkan ke nomor lewat pemindaian kode QR. |
| Pesan sampai ke sistem | Lewat webhook dari Meta. | Dibaca dan dibalas langsung di aplikasi. | Dibaca dari sesi yang tertaut. |
| Akun yang dibutuhkan | WABA dan nomor bisnis di Meta. | Aplikasi WhatsApp Business di ponsel. | Nomor WhatsApp yang aktif di ponsel. |
| Jalur API resmi | Ya. | Tidak, ini aplikasi. | Tidak. |
Nomor yang didaftarkan ke Cloud API pada umumnya tidak bisa dipakai bersamaan di aplikasi WhatsApp. Fitur Coexistence dibuat Meta agar satu nomor bisa dipakai di aplikasi dan API sekaligus.
03Jendela layanan 24 jam dan template
Jendela layanan 24 jam dimulai setiap kali customer mengirim pesan ke nomor bisnis. Selama jendela terbuka, bisnis boleh membalas dengan teks bebas.
Setelah 24 jam tanpa pesan baru dari customer, jendela tertutup. Pesan berikutnya dari bisnis harus berupa template message yang sudah disetujui Meta. Jendela terbuka lagi begitu customer membalas. Kategori template, tarif, dan batas pengiriman ditetapkan Meta dan dapat berubah.
04Di alur iklan ke WhatsApp
Cloud API ada di tahap chat, jalur yang mengantar pesan pertama calon customer ke sistem Anda. Dari iklan CTWA, webhook membawa objek referral yang bisa berisi ID iklan, judul, isi, URL, dan ctwa_clid. Dari tombol WhatsApp di landing page tidak ada referral, jadi pengenalnya adalah kode seperti [D-AB3K7] di teks pesan. Cara Dalekta membaca data iklan itu dibahas di CTWA tracking.
Di Dalekta, koneksi yang tersedia hari ini adalah QR atau perangkat tertaut. Cloud API masih pilot terbatas dan belum tersedia untuk semua pelanggan. Ilustrasi berikut menggambarkan koneksi Cloud pilot itu dengan jam rekaan.
- Jumat pukul 20.15, calon customer mengetuk iklan CTWA di Facebook dan mengirim "Halo, boleh minta info harga?". Meta meneruskannya ke webhook bersama
referral. Jendela 24 jam terbuka dan baru berakhir Sabtu pukul 20.15 bila customer tidak mengirim pesan lagi. - Bila pengirimnya belum punya lead, Dalekta membuat lead berstatus Masuk WA dengan kode seperti
CTWA-K2M9X. Data iklannya tampil di bagian Atribusi CTWA pada detail lead. - Sabtu pukul 09.00, sales membalas dengan teks bebas. Boleh, karena jendela masih terbuka.
- Sabtu pukul 21.00, tim ingin follow-up tetapi customer belum membalas sejak Jumat. Jendela sudah tertutup, jadi yang boleh dikirim hanya template message yang disetujui Meta.
- Minggu pukul 08.00, customer membalas sendiri dan sepakat membeli. Jendela terbuka lagi. Sales mengubah status lead menjadi Closing dengan nominal di halaman Leads, lalu revenue-nya muncul di Campaign Report pada grup Meta CTWA.
05Kesalahan yang sering terjadi
- Menyamakan koneksi QR dengan Cloud API. Sesi QR menautkan sebuah nomor ke sistem lewat pemindaian kode, sedangkan Cloud API menyambungkan sistem ke WABA di Meta lewat token akses dan webhook.
- Mendaftarkan nomor yang masih dipakai harian di aplikasi WhatsApp ke Cloud API tanpa membaca aturan Meta dulu. Pada umumnya nomor itu tidak bisa lagi dipakai di aplikasi, kecuali lewat Coexistence.
- Membalas chat lama dengan teks bebas setelah jendela 24 jam tertutup, lalu mengira sistemnya rusak. Di luar jendela, yang bisa dikirim hanya template.
- Mengira setiap chat dari iklan membawa data iklan. Chat yang dibuka dari tautan
wa.mebiasa tidak membawa objekreferral.
06Pertanyaan umum
Apa bedanya WhatsApp Cloud API dan aplikasi WhatsApp Business?
Aplikasi WhatsApp Business dipakai langsung di ponsel oleh pemilik atau tim. Cloud API adalah antarmuka yang di-host Meta, sehingga sistem lain bisa mengirim dan menerima pesan lewat webhook. Cloud API membutuhkan WABA di Meta dan nomor yang didaftarkan ke sana.
Apakah WhatsApp Cloud API gratis?
Tidak sepenuhnya. Meta menetapkan tarif pesan: sebagian jenis pesan gratis dan sebagian berbayar, dengan besaran yang bisa berbeda menurut kategori pesan dan negara penerima. Ketentuan ini dapat berubah, jadi cek halaman tarif resmi Meta sebelum menghitung anggaran.
Apakah Dalekta mendukung WhatsApp Cloud API?
Belum untuk semua pelanggan. Cloud API di Dalekta masih pilot terbatas. Koneksi yang tersedia hari ini adalah QR atau perangkat tertaut, dan langkahnya ada di dokumentasi WhatsApp Session.
Apakah Cloud API membawa data iklan CTWA?
Ya, untuk chat yang dimulai dari iklan CTWA. Pesan pertama tiba di webhook bersama objek referral yang memuat data iklan seperti ID, judul, isi, dan URL, serta ctwa_clid. Kelengkapannya bisa berbeda antar chat. Chat yang dibuka dari tautan wa.me biasa tidak membawa objek itu.