tumbuh.ai
Hubungkan Channel

Manual Login: siapkan di Meta

Halaman ini untuk Anda yang memilih jalur Manual Login: bisnis Anda memiliki Meta app sendiri. Kerjakan semuanya di sisi Meta lebih dulu, baru lanjut ke WhatsApp: Manual Login untuk menyambungkan ke tumbuh.ai.

Bila Anda tidak butuh kendali penuh atas Meta app, pakai Embedded Signup. Jalur itu tidak membutuhkan halaman ini.

Nama menu Meta sering berubah. Contoh perintah di bawah memakai Graph API v23.0. Pakai versi terbaru yang tertulis di dokumentasi Meta bila berbeda.

Urutan kerja

  1. Selesaikan Persiapan Meta Business (portfolio, pembayaran, nomor, kebijakan).
  2. Buat Meta app dan tambahkan produk WhatsApp.
  3. Daftarkan nomor di Cloud API.
  4. Buat System User dan token yang tidak kedaluwarsa.
  5. Uji token dengan dua perintah sederhana.
  6. Sambungkan ke tumbuh.ai (panduan).
  7. Atur webhook di Meta dan berlangganan WABA ke app Anda.
  8. Uji dari ujung ke ujung.

1. Buat Meta app

  1. Buka Meta for Developers, lalu My Apps > Create App.
  2. Pilih use case Connect with customers through WhatsApp.
  3. Saat diminta, pilih Business Portfolio yang sama dengan portfolio bisnis Anda.
  4. Setelah app jadi, buka App settings > Basic. Catat App ID. App Secret bersifat rahasia dan tidak perlu diberikan ke tumbuh.ai.
  5. Pastikan app terhubung ke Business Portfolio Anda. Hubungan ini juga yang dipakai saat Business Verification.

Apakah perlu App Review? Menurut dokumentasi Meta, app yang hanya melayani bisnis Anda sendiri umumnya tidak membutuhkan App Review atau Advanced Access. Bila app Anda juga melayani bisnis lain, Advanced Access dan Business Verification menjadi wajib.

Mode app. Selama app berstatus Development, sebagian webhook tidak dikirim oleh Meta. Ubah app ke Live setelah webhook Anda terverifikasi (langkah 7). Meta dapat meminta data dasar app saat beralih ke Live, misalnya URL kebijakan privasi, ikon, dan kategori. Isi sesuai formulir Meta.

2. Daftarkan nomor di Cloud API

tumbuh.ai tidak mendaftarkan nomor dan tidak mengatur PIN untuk jalur Manual Login. Nomor harus sudah aktif di Cloud API sebelum Anda menyambungkannya.

  1. Di App Dashboard, buka WhatsApp > API Setup, lalu tambahkan nomor telepon Anda.
  2. Verifikasi nomor dengan kode yang dikirim lewat SMS atau panggilan telepon.
  3. Isi display name sesuai pedoman Meta dan tunggu persetujuannya.
  4. Daftarkan nomor ke Cloud API dengan PIN verifikasi dua langkah 6 digit:
TerminalCode
curl -X POST "https://graph.facebook.com/v23.0/<PHONE_NUMBER_ID>/register" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"messaging_product":"whatsapp","pin":"<PIN_6_DIGIT>"}'

Catatan:

  • Bila verifikasi dua langkah sudah aktif di nomor itu, pakai PIN yang sudah ada. Bila belum, PIN yang Anda kirim menjadi PIN verifikasi dua langkah. Simpan PIN ini di tempat aman.
  • Meta membatasi permintaan register: 10 kali per nomor dalam 72 jam. Bila terlampaui, Meta menjawab error 133016.
  • Menambahkan nomor ke WABA saja belum menyelesaikan pendaftaran ke Cloud API. Langkah register tetap perlu.

Periksa hasilnya:

TerminalCode
curl -G "https://graph.facebook.com/v23.0/<PHONE_NUMBER_ID>" \
  -d "fields=display_phone_number,status,name_status,quality_rating" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Yang Anda inginkan: status bernilai CONNECTED dan name_status bernilai APPROVED (atau AVAILABLE_WITHOUT_REVIEW). Bila name_status masih menunggu review, atau nomornya ditolak atau kedaluwarsa, selesaikan dulu di WhatsApp Manager.

3. Buat System User dan token

Gunakan System User, bukan token pribadi Anda. Token pribadi Meta kedaluwarsa dalam hitungan jam, dan tumbuh.ai tidak memperbarui token Manual Login secara otomatis. Token yang kedaluwarsa memutus koneksi.

  1. Buka Business Settings > Users > System Users lalu Add.
  2. Beri nama (misalnya tumbuh-ai) dan pilih peran Admin. Admin otomatis mengakses semua WABA di portfolio. Peran Employee juga bisa, tetapi akses ke WABA harus diberikan satu per satu.
  3. Pilih System User itu, klik Add Assets, lalu berikan akses Full control ke dua aset:
    • Apps: Meta app yang Anda buat.
    • WhatsApp accounts: WABA yang akan dihubungkan.
  4. Klik Generate token, lalu:
    • Pilih Meta app Anda.
    • Pilih masa berlaku yang tidak kedaluwarsa bila Meta menyediakannya. Bila hanya ada opsi dengan masa berlaku, catat tanggalnya dan jadwalkan penggantian sebelum itu.
    • Centang izin whatsapp_business_management, whatsapp_business_messaging, dan business_management.
  5. Salin token segera dan simpan di pengelola rahasia perusahaan Anda. Perlakukan seperti kata sandi.

Periksa token

Buka Access Token Debugger milik Meta dan tempel token Anda. Pastikan:

  • App adalah Meta app Anda.
  • Type adalah System User.
  • Expires adalah Never (atau tanggal yang Anda catat tadi).
  • Scopes memuat whatsapp_business_management dan whatsapp_business_messaging.

4. Uji dengan dua perintah

Saat Anda menyambungkan di tumbuh.ai, sistem memeriksa dua hal ini ke Meta: apakah WABA bisa dibaca, dan apakah daftar nomornya bisa dibaca. Jalankan keduanya sendiri lebih dulu. Bila keduanya berhasil, koneksi di tumbuh.ai lolos validasi.

TerminalCode
curl -G "https://graph.facebook.com/v23.0/<WABA_ID>" \
  -d "fields=id,name" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

curl -G "https://graph.facebook.com/v23.0/<WABA_ID>/phone_numbers" \
  -d "fields=id,display_phone_number,status" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Hasil dan artinya:

HasilArtiPerbaikan
Data WABA dan daftar nomor munculSiap disambungkanLanjut ke langkah 5
Error 190Token tidak valid atau kedaluwarsaBuat token baru (langkah 3)
Error 200 atau 10System User belum diberi akses ke WABA, atau izin kurangUlangi Add Assets dan periksa izin token
Daftar nomor kosongWABA valid tetapi belum ada nomorSelesaikan langkah 2

5. Sambungkan ke tumbuh.ai

Lanjut ke WhatsApp: Manual Login. Anda memasukkan WABA ID dan Access Token langsung di dashboard tumbuh.ai, lalu mendapat Webhook URL dan Verify Token.

Satu WABA hanya bisa terhubung ke satu bisnis di tumbuh.ai. Bila WABA itu sudah dipakai akun lain, koneksi ditolak dengan WABA_ALREADY_CONNECTED.

6. Atur webhook di Meta

Setelah tumbuh.ai memberi Webhook URL dan Verify Token:

  1. Di App Dashboard buka WhatsApp > Configuration.
  2. Pada bagian Webhook, klik Edit.
  3. Tempel Callback URL (Webhook URL dari tumbuh.ai) dan Verify Token, lalu klik Verify and Save.
  4. Pada Webhook fields, berlangganan field messages.

Beberapa hal yang perlu Anda tahu:

  • Callback URL sama untuk semua pelanggan tumbuh.ai. Yang membedakan akun Anda adalah Verify Token, yang unik per akun. Salin keduanya dari dashboard, jangan menebak URL.
  • Field messages cukup untuk pesan masuk dan status pengiriman. Perubahan status template diperbarui lewat tombol Sync from Meta di halaman Template.
  • Meta memanggil URL Anda dengan permintaan GET berisi hub.mode, hub.challenge, dan hub.verify_token. tumbuh.ai menjawabnya otomatis. Bila Verify and Save gagal, lihat Masalah Setup Meta.

7. Berlangganan WABA ke app Anda

Selain field webhook di App Dashboard, WABA harus berlangganan ke Meta app Anda. tumbuh.ai memeriksa dan mendaftarkannya otomatis sekitar satu jam setelah koneksi. Untuk langsung aktif, lakukan sendiri:

TerminalCode
curl -X POST "https://graph.facebook.com/v23.0/<WABA_ID>/subscribed_apps" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Periksa bahwa app Anda terdaftar:

TerminalCode
curl "https://graph.facebook.com/v23.0/<WABA_ID>/subscribed_apps" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Setelah itu, bila app Anda masih berstatus Development, ubah ke Live (lihat langkah 1).

8. Uji dari ujung ke ujung

Lakukan pengujian di WhatsApp: Manual Login.

Checklist siap produksi (sisi Meta)

  • Business Portfolio Anda admin, dan Business Verification sudah diajukan.
  • Metode pembayaran WhatsApp Business Platform aktif.
  • Meta app terhubung ke Business Portfolio dan berstatus Live.
  • Nomor berstatus CONNECTED, display name disetujui, dan PIN verifikasi dua langkah tersimpan.
  • System User punya Full control atas app dan WABA.
  • Token tidak kedaluwarsa (atau tanggal penggantian sudah dijadwalkan), dan lolos Access Token Debugger.
  • Callback URL tervalidasi (Verify and Save berhasil) dan field messages berlangganan.
  • WABA berlangganan ke app Anda (subscribed_apps).
  • App Secret dan token tersimpan di pengelola rahasia, tidak dibagikan lewat chat atau email.

Sumber resmi Meta

Last modified on
Hubungkan WhatsAppWhatsApp: Manual Login