WhatsApp

GetMyBot menghubungkan WhatsApp melalui WhatsApp Cloud API (Meta Graph API). Setelah terhubung, bot menerima pesan masuk dari WhatsApp dan menerapkan reaksi Anda pada pesan tersebut, dan operator dapat menangani percakapan di dialog. Gambaran umum multisaluran ada di halaman Saluran.

Menghubungkan saluran WhatsApp

Untuk menghubungkan, diperlukan lima kredensial dari aplikasi Meta Anda (WhatsApp Cloud API). Semuanya wajib:

  • Phone number ID — pengenal nomor WhatsApp Business.
  • WABA ID — pengenal WhatsApp Business Account.
  • Access token — token akses aplikasi Meta.
  • Verify token — string bebas yang Anda tentukan sendiri. Digunakan saat verifikasi webhook di Meta (lihat di bawah).
  • App secret — rahasia aplikasi Meta. Diperlukan untuk memverifikasi tanda tangan HMAC pada webhook masuk (header X-Hub-Signature-256).

Langkah-langkah di antarmuka:

  1. Buka Bot → "Tambah saluran" → WhatsApp.
  2. Isi lima kolom di atas dan, jika mau, nama saluran (opsional).
  3. Klik "Verifikasi" — GetMyBot memvalidasi kredensial melalui Meta.
  4. Klik "Hubungkan".

Konfigurasi webhook di Meta

Setelah terhubung, saluran memperoleh Callback URL berbentuk {alamat}/ch/{channelID} (di antarmuka — ikon webhook 🔗). URL ini bersama Verify token Anda perlu didaftarkan di aplikasi Meta: WhatsApp → Configuration → Webhook.

Cara kerjanya:

  1. Meta mengirim ke Callback URL sebuah permintaan verifikasi dan mencocokkan verify_token yang dikirim dengan Verify token Anda. Jika cocok, webhook dianggap terkonfirmasi.
  2. Selanjutnya Meta mengirim ke alamat ini peristiwa (pesan masuk, status pengiriman, hasil moderasi template).
  3. Setiap permintaan masuk ditandatangani dengan header X-Hub-Signature-256; GetMyBot memverifikasi tanda tangan menggunakan App secret — karena itulah kredensial ini diperlukan saat koneksi.

Jendela sesi 24 jam

WhatsApp membatasi percakapan yang diinisiasi bot: pesan bebas hanya dapat dikirim ke pengguna dalam 24 jam setelah pesan masuk terakhirnya. Setiap pesan masuk baru dari pengguna memperbarui jendela.

Di luar jendela 24 jam, pesan bebas tidak dapat dikirim — satu-satunya cara untuk menulis lagi ke pengguna (re-engage) adalah template pesan yang telah disetujui. Karena itu template adalah alat kunci untuk siaran dan pengingat di WhatsApp.

Template pesan

Template (message template) adalah pesan yang telah disetujui Meta sebelumnya yang dapat dikirim di luar jendela sesi. Pengelolaan template ada di antarmuka GetMyBot.

Di mana mengelola template

Bot → pada saluran WhatsApp, ikon "Template pesan" (📄) → dialog "Template saluran WhatsApp". Di dialog ada tombol:

  • "Buat template" — menyusun template baru.
  • "Sinkronkan" — menarik katalog template dari Meta (memperbarui status dan daftar).

Kategori template

  • MARKETING (Pemasaran) — promosi, pengumuman, siaran.
  • UTILITY (Layanan) — notifikasi atas aksi pengguna (status pesanan, pengingat).
  • AUTHENTICATION (Autentikasi) — kode konfirmasi.

Kolom template

  • Nama — huruf latin kecil, angka, dan _, hingga 512 karakter.
  • Bahasa — locale Meta.
  • Kategori — salah satu dari tiga di atas.

Untuk kategori Pemasaran dan Layanan, tambahan:

  • Header — tanpa / teks / gambar / video / dokumen. Untuk header media, diunggah file contoh.
  • Body — wajib, hingga 1024 karakter. Variabel ditandai dengan {{1}}, {{2}}, … secara berurutan dari 1 hingga N, tanpa terlewat.
  • Footer — hingga 60 karakter.
  • Tombol — hingga 10: balasan cepat, tautan (hingga 2), telepon (1), salin kode (1).
  • Untuk setiap variabel {{n}} perlu ditetapkan nilai contoh — ini persyaratan Meta untuk moderasi.

Untuk kategori Autentikasi, body ditetapkan oleh Meta sendiri; yang dapat dikonfigurasi: masa berlaku kode (1–90 menit), rekomendasi keamanan, dan teks tombol salin kode.

Moderasi

Tombol "Buat" langsung mengirim template ke moderasi Meta — tidak ada langkah terpisah "kirim untuk ditinjau". Hasilnya datang secara asinkron (via webhook), dan daftar template diperbarui otomatis. Status:

  • PENDING (Ditinjau)
  • APPROVED (Disetujui)
  • REJECTED (Ditolak) — dengan keterangan alasan
  • serta PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

Template dapat disunting pada status APPROVED, REJECTED, PAUSED. Nama dan bahasa tidak dapat diubah; pada template yang disetujui, kategori juga terkunci.

Menggunakan template dalam reaksi

Mengirim template adalah aksi reaksi:

  1. Di editor reaksi, buka "Aksi" → "Tambah aksi" → "Kirim template WhatsApp".
  2. Aksi hanya tersedia jika bot memiliki saluran WhatsApp yang mendukung template.
  3. Yang dapat dipilih hanya template yang disetujui (APPROVED).
  4. Diisi parameternya: nilai variabel {{n}} di body, header teks, header media via tautan, parameter tombol URL. Dalam parameter dapat digunakan substitusi-variabel.

Saluran pengiriman yang sebenarnya ditentukan oleh saluran peristiwa: jika peristiwa datang dari WhatsApp, template dikirim ke WhatsApp.

Dialog dan lampiran

Operator dapat membalas di dialog WhatsApp dan mengirim lampiran — gambar, video, atau dokumen — dengan memperhatikan jendela 24 jam (di luar jendela, percakapan bebas tidak tersedia). Media masuk dari pelanggan ditarik melalui proxy dan ditampilkan di dialog.

Tarif

GetMyBot mencatat percakapan WhatsApp (conversations) per kategori — marketing / utility / authentication / service. Pada versi saat ini ini hanya pencatatan untuk observabilitas (record-only): saldo tidak dipotong untuk percakapan.

Selanjutnya

  • Saluran — multisaluran dan matriks kemampuan.
  • Reaksi: dasar — cara menyusun perilaku bot.
  • Siaran — pengiriman massal (di WhatsApp — via template yang disetujui).