# Hubungkan WhatsApp secara manual

Tab **Manual Login** ditujukan untuk developer yang punya Meta app sendiri dan ingin mengatur webhook sendiri. Bila Anda tidak butuh itu, pakai [Embedded Signup](/hubungkan-channel/whatsapp).

Ini langkah di sisi tumbuh.ai. Sisi Meta (Meta app, nomor, System User, token) dijelaskan di [Manual Login: siapkan di Meta](/hubungkan-channel/whatsapp-manual-meta). Kerjakan itu lebih dulu.

## Sebelum mulai

- Anda sudah menyelesaikan [Persiapan Meta Business](/hubungkan-channel/persiapan-meta) dan [Manual Login: siapkan di Meta](/hubungkan-channel/whatsapp-manual-meta).
- Nomor Anda sudah terdaftar di Cloud API (status `CONNECTED`). tumbuh.ai tidak mendaftarkan nomor atau mengatur PIN.
- Anda tahu **WABA ID**. Lihat di Meta Business Suite, bagian WhatsApp Accounts.
- Anda punya access token System User yang tidak kedaluwarsa, dengan izin `whatsapp_business_management` dan `whatsapp_business_messaging`. tumbuh.ai tidak memperbarui token Manual Login secara otomatis.
- Dua perintah uji di langkah 4 halaman Meta sudah berhasil dengan token itu.
- Kuota channel paket Anda masih tersedia.

## Langkah

1. Buka **Platform > WhatsApp**. Klik **Add Account** bila sudah ada akun lain.
2. Pada kartu "Hubungkan WhatsApp Business", pilih tab **Manual Login**.
3. Isi **WABA ID**.
4. Isi **Access Token**.
5. Klik **Connect WABA**.
6. Setelah berhasil, kartu "Connected Successfully" menampilkan **Webhook URL** dan **Verify Token**. Salin keduanya dengan tombol salin.
7. Buka Meta App Dashboard (tombol **Open Meta Dashboard** ada di kartu yang sama).
8. Masuk ke **WhatsApp > Configuration > Webhooks**.
9. Klik **Edit** pada kolom Webhook URL.
10. Tempel Webhook URL dan Verify Token dari tumbuh.ai, lalu klik **Verify and Save**.
11. Langganan (subscribe) field webhook `messages`.
12. Kembali ke tumbuh.ai, lalu klik **Done**.

Anda bisa membuka lagi informasi ini kapan saja dari menu tiga titik pada kartu perangkat, lewat **Webhook Info**.

## Regenerate Token

Di dialog **Webhook Info** ada tombol **Regenerate Token**. Tombol ini membuat Verify Token baru dan membatalkan yang lama. Setelah itu, perbarui Verify Token di konfigurasi webhook Meta App Anda agar cocok. Bila tidak, verifikasi ulang webhook berikutnya akan gagal. Pengiriman pesan yang sedang berjalan tidak terputus.

## Catatan keamanan

Jaga kerahasiaan Webhook URL, Verify Token, dan access token Anda. Anda **tidak perlu** memberikan App Secret Meta app ke tumbuh.ai. Access token Anda disimpan terenkripsi.

## Hasil yang diharapkan

- Meta berhasil memverifikasi webhook (Verify and Save sukses).
- Kartu perangkat tampil dengan lencana **Manual** dan status **Connected**.
- Pesan masuk muncul di [OneInbox](/fitur-utama/oneinbox).

## Uji dari ujung ke ujung

Setelah **Verify and Save** berhasil dan field `messages` berlangganan, uji semuanya:

1. **Kartu perangkat.** Di **Platform > WhatsApp**, kartu nomor Anda tampil dengan lencana **Manual** dan status **Connected**. Nomor, display name, dan kualitas terisi.
2. **Pesan masuk.** Dari WhatsApp pribadi (nomor lain), kirim pesan ke nomor bisnis Anda. Pesan muncul di [OneInbox](/fitur-utama/oneinbox) dalam beberapa detik.
3. **Balasan.** Balas dari OneInbox saat jendela 24 jam masih terbuka. Pesan sampai di WhatsApp pribadi Anda.
4. **Template.** Buka [Template](/fitur-utama/template) dan klik **Sync from Meta**. Template yang sudah ada di WABA Anda muncul.
5. **Di luar jendela 24 jam.** Pesan non-template ditolak. Hanya template yang disetujui yang bisa dikirim.

Bila ada langkah yang gagal, lihat [Masalah Setup Meta](/troubleshooting/setup-meta).

## Bila token diganti atau kedaluwarsa

Buat token baru di Meta, lalu hubungkan ulang WABA yang sama lewat tab **Manual Login**. Koneksi lama diperbarui dengan token baru, dan **Verify Token baru dibuat**. Perbarui Verify Token di Meta hanya bila Anda menyimpan ulang konfigurasi webhook.

## Masalah umum

- "Verify and Save" gagal: pastikan Verify Token yang ditempel sama persis dengan yang di tumbuh.ai. Bila Anda sudah menekan **Regenerate Token**, pakai token yang baru.
- Pesan masuk tidak muncul: pastikan field `messages` sudah disubscribe.
- Koneksi gagal atau terputus: lihat [Masalah Setup Meta](/troubleshooting/setup-meta) dan [Masalah koneksi](/troubleshooting/masalah-koneksi).
- Pesan gagal terkirim dengan kode error Meta: cek [Error WhatsApp](/troubleshooting/error-whatsapp).