Dokumentasi WhatsApp Business API Indonesia

Integrasi AI

Hubungkan Claude ke Hooks (MCP)

Kendalikan workspace WhatsApp Business Anda langsung lewat Claude, asisten AI dari Anthropic — cukup hubungkan sekali, tanpa perlu berpindah dashboard.

Siapa yang bisa menggunakan ini?

Hanya pengguna dengan peran owner atau admin pada workspace Hooks Anda yang bisa menghubungkan dan mengelola akses Claude.

Cara menghubungkan

claude.ai (versi web)

Buka Settings → Connectors → Add custom connector, lalu tempel URL https://hooks.tab.co.id/mcp dan setujui permintaan akses.

Claude Desktop

Gunakan connector yang sama seperti di atas. Setelah menghubungkan, keluar sepenuhnya dari aplikasi (Cmd+Q di Mac) lalu buka kembali. Ikon Hooks bisa butuh beberapa menit untuk muncul karena cache aplikasi.

Claude Code / konfigurasi manual

Buat token akses di /setting/mcp (format hks_mcp_...), lalu tambahkan konfigurasi berikut ke mcpServers pada file konfigurasi MCP Anda:

{
  "mcpServers": {
    "hooks": {
      "url": "https://hooks.tab.co.id/mcp",
      "headers": {
        "Authorization": "Bearer hks_mcp_xxxxxxxx"
      }
    }
  }
}

Apa yang bisa dilakukan Claude?

Membaca data workspace Anda: saldo, kontak, template, riwayat broadcast, laporan, dan sesi chat.
Mengelola kontak (tambah, ubah, cari).
Jika Anda mengizinkan: mengirim pesan/broadcast, mengelola template, dan membalas sesi chat pelanggan (CSW).

Keamanan & batasan

Setiap token memiliki batas frekuensi permintaan (rate limit).
Broadcast lewat Claude dibatasi jumlah penerimanya.
Ada batas pengeluaran (spend) ke Meta untuk mencegah tagihan tak terduga.
Setiap pengiriman berbayar butuh konfirmasi Anda — Claude menampilkan pratinjau, Anda menyetujui, baru terkirim.
Mencabut token akan langsung memutus akses Claude ke akun Anda.

Cara mencabut akses

Buka /setting/mcp, lalu hapus token yang ingin dicabut. Efeknya langsung — sesi Claude yang sedang berjalan akan langsung kehilangan akses.

Pertanyaan singkat

Kenapa izin baru yang saya berikan belum aktif? Coba sambungkan ulang connector-nya (hapus lalu tambahkan kembali) agar Claude membaca ulang izin terbaru.
Ikon Hooks belum muncul di Claude Desktop? Ini karena cache aplikasi Claude — tunggu beberapa menit atau buka ulang aplikasinya.
Apakah pemakaian ini kena biaya? Membaca data selalu gratis. Membalas sesi chat (CSW) gratis untuk 1.000 balasan pertama per nomor tiap bulan, lalu dikenakan tarif dari saldo. Pengiriman template dan broadcast kategori Marketing, Utility, dan Authentication berbayar sejak pesan pertama — kecuali penerima dari iklan Click-to-WhatsApp yang masih dalam jendela gratis — dan GAGAL terkirim bila saldo di bawah Rp5.000 tanpa toleransi. Template kategori Service memakai kuota 1.000 balasan gratis yang sama. Selalu butuh konfirmasi Anda lebih dulu.

Zona waktu

Semua waktu di Hooks memakai WIB (Asia/Jakarta, UTC+7), sama dengan jam server.

Input: send_at dikirim Y-m-d H:i:s dalam WIB, misalnya 2026-10-06 14:00:00. ISO-8601 dengan offset juga diterima dan dikonversi ke WIB (2026-10-06T07:00:00Z = 14:00 WIB). Tanggal tanpa jam (misalnya 2026-10-06) ditolak dengan HTTP 422 dan error_code INVALID_SEND_AT. Kosong atau waktu yang sudah lewat berarti kirim sekarang.
Placeholder variabel: Nilai variabel yang masih berisi placeholder seperti {{1}} ditolak dengan HTTP 422 dan error_code PARAM_UNRESOLVED_PLACEHOLDER sebelum saldo dipotong. Contoh: {"key":"1","type":"text","value":"{{1}}"} → {"success":false,"data":{"error_code":"PARAM_UNRESOLVED_PLACEHOLDER"},"message":"Variabel {{1}} masih berisi placeholder. ..."}.
Respons API: send_at, start_at, done_at, created_at, updated_at dikirim sebagai Y-m-d H:i:s tanpa offset dan selalu WIB.
Webhook: message.send_at dan timestamp memakai ISO-8601 dengan offset +07:00.

Perubahan · 6 Oktober 2026

message.send_at di webhook sebelumnya berlabel +00:00 padahal angkanya sudah WIB. Sekarang berlabel +07:00; angkanya tidak berubah. Jika sistem Anda mengonversi offset tersebut, hapus koreksi +7 jam yang mungkin pernah Anda tambahkan. Selain itu, send_at yang hanya berisi tanggal (tanpa jam) kini ditolak; sebelumnya dibaca sebagai 00:00 WIB sehingga pesan bisa terkirim langsung.
Respons non-2xx (408, 429, 5xx) dan timeout pada webhook kini dicoba ulang setelah 30 detik, 2 menit, dan 10 menit (hingga 3 kali ulang, total 4 percobaan); 4xx lainnya tidak dicoba ulang. Setiap event punya X-Hooks-Event-Id yang stabil (juga event_id di body); event yang sama bisa terkirim lebih dari sekali, jadi lakukan dedupe berdasarkan id tersebut, dan juga berdasarkan message.id. X-Hooks-Delivery-Attempt menunjukkan nomor percobaan. Balas 2xx dalam 5 detik.
Pada POST /broadcast/whatsapp/bulk, parameters kini opsional; kosongkan atau kirim {} untuk template tanpa variabel.

Referensi API

Semua endpoint API V2

Autentikasi, base URL, dan setiap endpoint lengkap dengan contoh request dan respons. Pilih bagian di menu kiri.

Authentication Base URL Broadcast Webhook Unduh Koleksi Postman