WhatsApp

Panduan ini menjelaskan cara mengintegrasikan Agen Quickchat AI dengan WhatsApp. Prosesnya terbagi menjadi 2 langkah sederhana:

• Langkah 0 - Prasyarat
• Langkah 1 - Hubungkan WhatsApp

Jika mengalami masalah integrasi atau membutuhkan bantuan, buka Pemecahan masalah & FAQ atau hubungi kami.

Alat penyiapan opsional

• Periksa prasyarat penyiapan WhatsApp. Cocokkan detail nomor dan penyedia yang Anda nyatakan dengan persyaratan penyiapan dalam dokumentasi. Alat ini tidak mengakses atau menghubungkan akun WhatsApp.

• Periksa jendela layanan WhatsApp. Periksa jendela 24 jam berdasarkan waktu pesan masuk dan balasan beserta selisih zona waktu yang diberikan. Alat ini tidak memverifikasi template, persetujuan, atau izin akun, dan tidak mengirim pesan.

• Perkirakan biaya penggunaan. Hitung kredit model Quickchat AI serta total terpisah untuk rincian biaya yang diberikan. Alat ini tidak mencari tarif penyedia, menggabungkan kredit dengan uang, atau memeriksa akun Anda.

Menonton video

Play

Langkah 0 - Prasyarat

A. Nomor telepon bisnis

Tentukan nomor telepon yang akan digunakan untuk WhatsApp. Anda dapat membaca dokumentasi WhatsApp atau mengikuti FAQ di bawah:

Nomor apa yang dapat digunakan di WhatsApp Cloud API?

• Gunakan nomor telepon khusus bisnis yang dapat menerima SMS atau panggilan suara untuk verifikasi.
• Nomor harus valid, milik Anda, dan memiliki kode negara serta kode area.

Bisakah menggunakan nomor yang sudah digunakan di WhatsApp Messenger?

• Tidak. Anda tetap dapat menggunakan nomor tersebut untuk panggilan dan SMS, tetapi bukan di WhatsApp Messenger.
• Jika nomor sudah digunakan di WhatsApp Messenger, hapus terlebih dahulu. Jangan lupa mencadangkan riwayat obrolan WhatsApp.
• Nomor yang diblokir harus dibuka blokirnya sebelum didaftarkan.

Bisakah menggunakan nomor yang sudah digunakan di WhatsApp Business App?

• Alur koneksi Quickchat AI saat ini belum menyediakan jalur Coexistence yang terverifikasi untuk nomor WhatsApp Business App yang sudah ada. Meta menjelaskan cara kerja penggunaan berdampingan pada integrasi yang didukung dalam panduan onboarding Business App.
• Jika perlu mempertahankan nomor, akun Business App, dan riwayat obrolan yang ada, kirim email ke support@quickchat.ai sebelum melanjutkan. Jangan menghapus atau memutus koneksi akun Business App, maupun memigrasikan nomornya, sebagai langkah pemecahan masalah.

Bisakah menggunakan nomor telepon baru?

• Ya, jika tidak ingin menggunakan nomor saat ini, dapatkan nomor baru (SIM fisik atau nomor virtual). Anda dapat membeli nomor virtual dari layanan seperti Hushed.

B. Informasi bisnis

Siapkan detail berikut (akan Anda masukkan selama alur integrasi Meta):

• Nama bisnis
• Situs web bisnis
• Kategori bisnis
• Deskripsi bisnis

Perhatian

Meskipun beberapa kolom tampak opsional, isi dengan akurat. Informasi yang hilang atau tidak akurat dapat menunda persetujuan atau menyebabkan pembatasan akun.

Langkah 1 - Hubungkan WhatsApp

Buka aplikasi Quickchat AI → External Apps → WhatsApp → klik tombol Connect WhatsApp, lalu ikuti pop-up Meta:

Anda juga dapat memulai dari ChatGPT, Claude, atau aplikasi AI lain yang terhubung: minta tautan untuk menghubungkan Agen ini ke WhatsApp. Tautan berlaku selama 10 menit dan hanya sekali pakai, khusus untuk akun Quickchat yang memintanya. Buka di browser yang masuk ke akun tersebut, ikuti penyiapan Meta, dan selesaikan pemilihan akun atau nomor saat Quickchat terbuka kembali. Lalu minta aplikasi AI memeriksa penyiapan dan kirim pesan WhatsApp sungguhan untuk memastikan balasan AI diterima. Uji setiap nomor aktif jika menghubungkan lebih dari satu. Anda menyetujui akses Meta di browser tanpa membagikan token dalam obrolan.

1. Masuk ke akun Meta (Facebook).
2. Tinjau izin yang akan dibagikan kepada Quickchat AI (akses WhatsApp Business Account dan portofolio bisnis), lalu lanjutkan.
3. Berikan detail bisnis yang akurat (Business Portfolio, Business Name, Business Website, Country, dan sebagainya).
4. Buat atau pilih WhatsApp Business Account.
5. Pilih nama tampilan dan kategori WhatsApp Business.
6. Tambahkan nomor telepon bisnis dan verifikasi melalui SMS/panggilan sesuai petunjuk.
7. Klik Confirm untuk memberikan akses yang diperlukan kepada Quickchat AI.
8. Saat Meta mengonfirmasi penyiapan selesai, klik Finish. Pop-up menampilkan konfirmasi Quickchat AI bahwa akun WhatsApp sudah terhubung, lalu menutup otomatis.

Jika Meta memberikan akses ke lebih dari satu akun, panel WhatsApp menampilkan Choose your WhatsApp Business Account, bukan langsung menghubungkan. Pilih akun tempat Agen AI harus menjawab lalu klik Use this account. Jika menghubungkan ulang, konfigurasi WhatsApp saat ini tidak berubah sampai Anda mengonfirmasi.

Kembali di aplikasi Quickchat AI, panel WhatsApp menampilkan Finish setup sampai pertukaran pesan yang berhasil terverifikasi pada nomor bisnis Anda sendiri. Jika panel belum diperbarui setelah sekitar 30 detik, klik ikon muat ulang.

Koneksi ke Meta dan penerimaan pesan baru merupakan sebagian proses penyiapan. Panel menampilkan langkah berikutnya untuk setiap nomor yang diaktifkan:

• Waiting for your first message: kirim pesan WhatsApp dari ponsel lain ke nomor yang ditampilkan, lalu klik Refresh. Pastikan Anda mengirim ke nomor bisnis yang akan digunakan pelanggan.
• Waiting for the AI reply to be delivered: Quickchat telah menerima pesan, tetapi WhatsApp belum mengonfirmasi pengiriman balasan AI. Periksa apakah balasan diterima di ponsel lain. Jika belum, periksa kredit AI dan peringatan pada panel, lalu kirim pesan uji lagi.
• AI reply delivered: WhatsApp mengonfirmasi bahwa balasan AI atas pesan masuk telah terkirim pada nomor bisnis ini.
• Verification needs attention: atasi peringatan koneksi, pastikan nomor tujuan tetap aktif, lalu kirim pesan uji baru.
• Display name: setiap nomor di bagian bawah panel menampilkan status nama tampilannya dari Meta (Approved, Pending review, Declined, Expired, atau No display name). Peninjauan yang sedang berlangsung tidak memerlukan tindakan dan biasanya selesai dalam beberapa hari. Jika ditolak, kedaluwarsa, atau belum ada, Anda diminta mengajukan nama tampilan di WhatsApp Manager.
• Meta test number: nomor +1 555 dari Meta dan nomor sandbox tidak memverifikasi aktivasi nomor bisnis Anda. Tambahkan nomor sendiri di WhatsApp Manager, aktifkan di Quickchat, lalu uji nomor tersebut.

Panel menampilkan Live ketika setiap nomor bisnis yang diaktifkan memiliki pertukaran pesan terverifikasi dan pemeriksaan koneksi dalam kondisi baik. Jika mengaktifkan beberapa nomor bisnis, uji masing-masing. Pertukaran berhasil dengan nomor uji, template yang terkirim, atau pemberitahuan batas pesan tidak menyelesaikan pemeriksaan ini.

Tips

Biarkan integrasi aktif selama pengujian. Kirim pesan dari ponsel lain ke setiap nomor bisnis yang dituju, pastikan balasan AI diterima, lalu klik Refresh. Percakapan juga seharusnya muncul di Inbox aplikasi Quickchat AI. Koneksi lama dapat meminta pertukaran pesan uji baru untuk memverifikasi pengiriman; koneksi tetap dapat menerima dan membalas pesan selama Anda menyelesaikan langkah ini.

Jika masih ada langkah onboarding Meta, selesaikan melalui Setup guidance di WhatsApp Manager. Quickchat AI juga mengirim pengingat melalui email kepada pemilik akun jika langkah penyiapan Meta belum selesai.

Pemecahan masalah & FAQ

Bagaimana harga WhatsApp Business API dihitung?

• WhatsApp menganggap balasan terhadap pertanyaan pelanggan yang dimulai pengguna (pesan masuk) sebagai pesan layanan. Pesan ini memungkinkan bisnis menangani pertanyaan masuk, baik melalui staf manusia maupun bot AI percakapan.
• Saat pengguna mengirim pesan ke bisnis, jendela layanan pelanggan 24 jam terbuka. Selama jendela ini, bisnis dapat merespons dengan pesan layanan tanpa biaya. Jendela ini dimulai ulang setiap kali pengguna mengirim pesan.
• Di luar 24 jam, Anda harus menggunakan Message Templates yang disetujui (Marketing, Utility, Authentication, dan sebagainya) dan membayar per pesan sesuai tarif pesan WhatsApp Business Platform.
• Meta mengategorikan dan menagih percakapan. Pastikan WhatsApp Business Account memiliki metode pembayaran yang valid untuk pesan yang dimulai bisnis atau menggunakan template.

Tombol Connect WhatsApp tidak bekerja. Pop-up Meta tidak muncul.

• Jika browser memblokir pop-up, izinkan pop-up untuk aplikasi Quickchat AI dan klik Try again. Anda juga dapat mengeklik Continue on Meta in this tab untuk menyelesaikan penyiapan yang sama tanpa pop-up.

Quickchat couldn’t confirm the WhatsApp connection

Quickchat menampilkan pesan pemulihan ini ketika jendela Meta tidak mengembalikan hasil dan Quickchat tetap tidak dapat memverifikasi koneksi. Ini tidak membuktikan bahwa Meta tidak membuat perubahan.

1. Pastikan Anda adalah Admin Meta Business yang memiliki WhatsApp Business Account. Jika bukan, minta Admin menghubungkannya dari login Facebook mereka.
2. Klik Try again. Jika pemblokir mengganggu jendela Meta, gunakan jendela privat dengan ekstensi dijeda, atau klik Continue on Meta in this tab.
3. Jika nomor aktif di WhatsApp Messenger, hapus dari sana terlebih dahulu atau gunakan nomor lain. Jika aktif di WhatsApp Business App, berhenti di sini dan kirim email ke support@quickchat.ai sebelum melanjutkan. Alur koneksi Quickchat AI saat ini belum menyediakan jalur Coexistence yang terverifikasi. Jangan menghapus atau memutus koneksi akun Business App, maupun memigrasikan nomornya, untuk mengatasi pesan ini.
4. Jika WhatsApp Business Account menggunakan Aircall, Twilio, 360dialog, MessageBird, atau penyedia lain, tambahkan Quickchat AI sebagai mitra di Meta Business Settings:
   1. Buka Meta Business Settings lalu Accounts → WhatsApp Accounts.
   2. Pilih WhatsApp Business Account, buka Partners, lalu klik Add Partners.
   3. Masukkan Business ID Quickchat AI: 270696274483463.
   4. Berikan izin Manage WhatsApp accounts, kembali ke Quickchat AI, lalu muat ulang status.

Putuskan koneksi penyedia lain hanya jika Meta tidak mengizinkan kedua mitra pada akun tersebut. Jika ragu, hubungi dukungan sebelum memutus koneksi penyedia pesan yang aktif.

Verifikasi nomor gagal.

• Pastikan nomor dapat menerima SMS atau panggilan suara.
• Pesan umum Ineligible atau tooltip This number can’t be shared with this app tidak menunjukkan penyebabnya maupun apakah persyaratan coexistence Meta terpenuhi. Kirim email ke support@quickchat.ai dengan pesan persisnya dan langkah tempat pesan itu muncul.
• Jika nomor digunakan di WhatsApp Business App dan Anda perlu mempertahankan akun serta riwayatnya, hubungi dukungan sebelum melanjutkan. Jangan menghapus atau memutus koneksi akun, maupun memigrasikan nomor, untuk mencoba menghilangkan kesalahan.

Saya menghubungkan akun yang salah.

• Reconnect mempertahankan akun yang sudah terhubung. Untuk memindahkan Agen AI ke WhatsApp Business Account lain, klik Disconnect pada panel WhatsApp, lalu Connect WhatsApp lagi dan pilih akun Meta Business serta WhatsApp Account yang benar pada jendela Meta.

We could not tell which WhatsApp Business Account to connect

• Login Meta Anda memiliki beberapa WhatsApp Business Account dengan nomor telepon, dan Quickchat tidak dapat menentukan akun yang dimaksud. Kirim email ke support@quickchat.ai dengan nomor yang ingin dihubungkan, dan kami akan menyelesaikan penyiapan untuk Anda.

Pesan tidak muncul di Inbox Quickchat AI.

• Pastikan pop-up menampilkan pesan konfirmasi terakhir: “WhatsApp account connected!”.
• Periksa kembali bahwa Anda menautkan WhatsApp Account yang diinginkan dan memilih Agen AI yang benar.
• Kartu Waiting for your first message menunjukkan nomor tempat Agen AI menjawab. Pastikan Anda mengirim pesan ke nomor tersebut dan nomornya diaktifkan di panel, lalu klik Refresh.
• Jika mengirim pesan setelah 24 jam tanpa pesan dari pengguna, gunakan template yang disetujui dan pastikan metode pembayaran diatur di WhatsApp Manager.

Balasan WhatsApp AI saya gagal terkirim.

Jika balasan AI tidak dapat dikirim, Quickchat AI menampilkan peringatan “WhatsApp replies are failing” pada panel WhatsApp di External Apps dan notifikasi pada dasbor. Penyebab paling umum dan solusinya:

• Nama tampilan pada nomor uji Meta belum disetujui: Meta menahan balasan dari nomor +1 555 yang disediakannya sampai nama tampilan disetujui. Peringatan nama tampilan pada panel menjadi merah dan menyebut nomornya. Tunggu peninjauan selesai (biasanya beberapa hari), atau jika ditolak, ajukan nama tampilan baru di WhatsApp Manager, lalu kirim pesan uji. Nama tampilan nomor Anda sendiri yang masih ditinjau tidak dengan sendirinya menghalangi balasan; panel menampilkannya sebagai catatan.
• Koneksi kedaluwarsa atau dicabut: koneksi WhatsApp sudah tidak valid. Buka panel WhatsApp dan klik Reconnect agar balasan dapat dikirim kembali.
• Nomor dibatasi: Meta membatasi nomor karena penilaian kualitas atau masalah kebijakan. Periksa status di WhatsApp Manager untuk memulihkan pengiriman.
• Business Account dikunci (kesalahan 131031): Meta memblokir balasan dari WhatsApp Business Account. Kesalahan pengiriman di Inbox dan panel WhatsApp menjelaskan pembatasan tersebut. Buka Business Support Home, pilih akun WhatsApp, pilih pelanggaran, lalu klik Request Review: Meta hanya membuka kunci akun melalui peninjauan ini. Menghubungkan ulang Quickchat tidak menghapus pembatasan.

Peringatan lain hilang otomatis ketika balasan kembali berhasil dikirim. Peringatan akun terkunci tetap muncul sampai pesan pengunjung sungguhan yang baru mendapatkan balasan AI yang benar-benar terkirim, karena Meta dapat menerima balasan tetapi kemudian gagal mengirimkannya. Jika hanya nomor uji Meta (+1 555) yang aktif, balasan AI berikutnya yang berhasil dikirim akan menghapus peringatan. Support AI juga dapat menjelaskan kegagalan akun terkunci terbaru yang tersimpan, tetapi bukti historis tidak membuktikan akun masih terkunci.

Pesan template atau yang dimulai bisnis gagal.

• Pastikan Message Templates Anda disetujui dan metode pembayaran aktif di WhatsApp Manager.
• Pengirim baru mulai dengan batas pengiriman pesan yang meningkat berdasarkan kualitas dan verifikasi. Jika mencapai batas pesan yang dimulai bisnis, lihat panduan Messaging Limits Meta.
• Periksa batas pengiriman pesan dan penilaian kualitas di WhatsApp Manager jika pengiriman dibatasi.

Bagaimana cara membuat tautan WhatsApp dan tombol “Chat on WhatsApp” sendiri?

• Ikuti tutorial WhatsApp ini.
• Atau unduh desain tombol merek WhatsApp dan gunakan salah satu skrip berikut:

<!-- WhatsApp inline button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

atau

<!-- WhatsApp floating button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

Bagaimana cara membuat kode QR WhatsApp sendiri?

• Buka WhatsApp Manager → Phone numbers → pilih nomor telepon bisnis → Message links → Create Message Link.
• Anda juga dapat menemukannya di aplikasi seluler WhatsApp Business. Ikuti tutorial WhatsApp ini.

Apakah saya perlu memutus koneksi akun WhatsApp Business App untuk memperbaiki penyiapan?

• Tidak. Jangan menghapus atau memutus koneksi akun Business App, maupun memigrasikan nomornya, sebagai langkah pemecahan masalah. Alur koneksi Quickchat AI saat ini belum menyediakan jalur Coexistence yang terverifikasi untuk mempertahankan konfigurasi aplikasi dan riwayat yang ada.
• Kirim email ke support@quickchat.ai sebelum mengubah akun Business App yang aktif. Panduan onboarding Business App Meta menjelaskan coexistence untuk integrasi yang didukung; panduan itu tidak mengonfirmasi ketersediaannya untuk konfigurasi Quickchat AI Anda.

Akses apa yang diperoleh Quickchat AI ke WhatsApp Business Account kami?

• Akses API dengan cakupan terbatas, bukan kepemilikan akun. WhatsApp Business Account (WABA) berada di Meta Business Manager Anda sendiri. Dalam model WABA Sharing Meta, aset tetap milik Anda dan Quickchat AI ditambahkan sebagai mitra yang aksesnya dapat dicabut kapan saja melalui Business Manager.
• Kami dapat mengirim dan menerima pesan melalui Cloud API serta menerima peristiwa pesan melalui webhook selama integrasi aktif.
• Kami tidak dapat menutup, memindahkan, atau mengganti identitas merek akun, mengubah penagihan, maupun menghapus administrator Anda.

Perlu bantuan?

Mengobrol dengan Support AI Quickchat di WhatsApp:
📱 +1 302-405-9992: Mulai obrolan

Atau pindai kode QR: