Bagaimana Cara Melakukan Integrasi antara Meta Coexistence dan Mekari Qontak

Article author
Learning Center Mekari
  • Diperbarui

META Coexistence (Coex) adalah fitur yang memungkinkan bisnis menggunakan WhatsApp Business App sekaligus mengakses Cloud API secara bersamaan.

Dengan demikian, tidak diperlukan penonaktifan akun yang sudah ada, serta SMB dapat tetap mempertahankan riwayat percakapan saat beralih ke solusi berbasis API.

Manfaat Utama

  • Mengirim dan menerima pesan melalui WhatsApp Business App maupun Cloud API.

  • Menyimpan riwayat percakapan individu hingga 6 bulan terakhir (tidak termasuk percakapan grup).

  • Melakukan sinkronisasi pesan media hingga 2 minggu terakhir.

  • Mendukung mirroring percakapan antara Qontak dan WhatsApp Business app.

Penting
Berikut persyaratan sebelum melakukan integrasi:
1. Akun Facebook Business yang valid.
2. Nomor telepon WhatsApp Business App yang aktif (minimal 30 hari).
3. Proses Verifikasi Meta telah diselesaikan (verifikasi Facebook business).
4. Akun Qontak dengan akses ke Dashboard Omnichannel.
5. Langganan aktif untuk META Coex.
6. Pastikan nomor telepon yang akan dihubungkan tidak terhubung ke Meta Business Suite. Klik di sini untuk memeriksa apakah nomor masih terhubung. Jika masih terhubung, hapus integrasinya melalui Meta Business Suite > Inbox > Business Platform terlebih dahulu.
4.png

Jika Anda merupakan pengguna dari WhatsApp Cloud API (aktif lebih dari 30 hari) yang ingin beralih ke Coex, mereka tidak perlu menunggu 30 hari agar akun WhatsApp Business kembali aktif setelah proses offboarding dari Cloud API. Proses offboarding dan integrasi ke Coex dapat dilakukan sesuai dengan Terms and Conditions (TnC) yang berlaku.

Di bawah ini, Anda akan mempelajari mulai dari cara melakukan integrasi, penjelasan teknis, batasan yang perlu diperhatikan, hingga contoh use case pada Meta Coexistence. Berikut penjelasannya.

A. Cara Melakukan Integrasi

  1. Masuk ke akun Mekari Qontak Omnichannel Anda, lalu pilih menu “Integrations”.
  2. Selanjutnya pada bagian WhatsApp, klik "Manage".
    1.png

  3. Kemudian pada halaman WhatsApp, klik “Add WhatsApp Coexistence”.
    2.png
  4. Anda akan diarahkan ke tampilan berikut. Klik “Continue” untuk melanjutkan.
    1.png

  5. Pilih Business portfolio, sebagai contoh, "Qontak by Mekari", kemudian pada bagian "WhatsApp Business account", klik "Connect a WhatsApp Business app". Setelah itu, klik "Next" untuk melanjutkan.
    3.png

  6. Pilih kode nomor telepon negara. Lalu isikan nomor telepon Anda dan klik “Next” untuk melanjutkan.

  7. Pastikan nama WhatsApp Business Account Anda telah sesuai, lalu klik “Next”.
    A.png

Tahap 4: Verifikasi dan Scan QR

  1. Pindai QR Code yang ditampilkan saat proses embedded signup.
    B.png
  2. Kemudian lakukan konfirmasi melalui pesan WhatsApp dari Meta.
  3. Selesaikan proses peninjauan dan berikan akses. Lalu klik “Confirm”.
    C.png
  4. Pada akun WhatsApp Anda, pilih opsi sinkronisasi: All chats, Selected chats, or None. Untuk memulainya, masuk ke menu “Settings”, lalu pilih “Account”.

  5. Kemudian pilih “Connect to the Business Platform”.
  6. Lalu klik “Connect to the Business Platform”.
  7. Pilih bagaimana chat history Anda akan dibagikan. Contoh di bawah ini adalah kondisi ketika Anda memilih “Select chats to share” atau chat history hanya dibagikan ke beberapa room chat terpilih saja. Lalu klik “Next”.

  8. Lalu pilih room chat sesuai dengan keinginan Anda dan klik ikon ‘Next’ berikut.

  9. Pindai QR code yang tersedia.

B. Penjelasan Teknis mengenai Meta Coexistence

  • Fitur yang Didukung: Sinkronisasi chat individu, berbagi kontak, dan penyimpanan riwayat chat hingga 6 bulan.

  • Fitur yang Tidak Didukung: Sinkronisasi chat grup serta sinkronisasi media penuh (hanya tersedia untuk 2 minggu terakhir).

Contoh Penggunaan: Membantu SMB beralih dari WhatsApp Business App ke Cloud API tanpa kehilangan riwayat percakapan maupun kesinambungan komunikasi.

C. Batasan Saat Ini yang Perlu Diperhatikan

Penting
Anda harus membuka aplikasi WhatsApp Business di ponsel setidaknya sekali setiap 14 hari. Jika tidak, integrasi akan mengalami disconnected atau terputus.

Fitur yang sudah ada pada Aplikasi WhatsApp Business Perubahan Fitur pada Aplikasi WhatsApp Business setelah onboarding ke Cloud API Apakah Cloud API mendukung fitur WhatsApp Business App?
Individual (1:1) chats. Tidak ada perubahan.

Ya.
Seluruh obrolan pribadi selama 6 bulan terakhir bisa disinkronkan. 

Pesan yang Anda kirim atau terima akan otomatis sama di Cloud API dan WhatsApp Business App.

Group chats. Tidak ada perubahan. Tidak.

Pesan dalam grup tidak akan tersinkron.
Phone number hiding chats. Tidak ada perubahan. Tidak.
Disappearing message. Disappearing messages tidak akan berlaku lagi di semua Individual (1:1) chats. Tidak.
View once message. View once message akan dinonaktifkan pada semua Individual (1:1) chats. Tidak
Live location message. Live location message akan dinonaktifkan pada semua Individual (1:1) chats. Tidak.
Broadcast lists. Broadcast tetap tersedia di Qontak setelah terhubung melalui Coex.  Tidak.
Voice and Video calls. Tidak ada perubahan. Tidak.
Contacts. Tidak ada perubahan. Ya.

Seluruh data kontak dapat disinkronkan.
Business tools (contoh: catalog, order, dan status). Tidak ada perubahan. Tidak.
Messaging tools (contoh: marketing messages, greeting message, away message, quick replies, dan labels). Tidak ada perubahan. Tidak.
Business profile (contoh:business name, address, dan website). Tidak ada perubahan. Tidak.
Channels. Tidak ada perubahan. Tidak.

A. WhatsApp Call
a. Outbound dan Inbound Call pada WhatsApp Business App tidak muncul di Qontak.
b. Jika pengguna melakukan panggilan melalui WhatsApp Business App, aktivitas tersebut tidak akan tercatat di Qontak Inbox.

B. WhatsApp Group
a. Seluruh aktivitas grup di WhatsApp Business App tidak akan tersinkronisasi atau tercermin di Qontak Inbox.
b. Seluruh aktivitas grup di Qontak Inbox juga tidak akan tercermin di WhatsApp Business App.

C. MM Lite
MM Lite saat ini sudah tersedia di Coex.

D. Broadcast List
Setelah terhubung melalui Coex, broadcast dilakukan melalui dashboard Qontak. Broadcast List yang sebelumnya tersedia di aplikasi WhatsApp Business tidak dapat digunakan, sehingga Anda perlu membuat Broadcast List baru di Qontak.

Tabel Aktivitas WhatsApp Business per Platform

Activity

WhatsApp Business App 

WhatsApp Business Web

WhatsApp Business Android

WhatsApp Business iOs

Windows

Mac

Windows

Mac

Linked Device - ✅ ✅ ✅ ✅ ✅
Inbound chat from customer

Tampilan chat
- ✅ ✅ ✅ ✅ ✅

Outbound chat to customer

Sender : Qontak
Receiver: WhatsApp
Tampilan chat

- ✅ ✅ ✅ ✅ ✅

Semua chat tetap akan diterima di WhatsApp Business. Limitasi tersebut hanya berlaku pada jumlah bubble message yang dapat ditampilkan di masing-masing perangkat, bukan berarti chat tidak masuk ke WhatsApp Business.

D. Batas Pengiriman Broadcast pada Nomor Coexistence

Meta menerapkan batas messaging throughput yang berbeda untuk WhatsApp Cloud API dan Meta Coexistence (Coex). Messaging throughput adalah jumlah pesan yang dapat dikirim dalam satu detik.

Berikut batas messaging throughput yang diterapkan Meta:

Kategori

Batas Messaging Throughput

WhatsApp Cloud API 80 pesan per detik (Message Per Second) secara default, dengan peningkatan otomatis hingga 1.000 MPS.
Meta Coexistence (Coex) Hingga 20 pesan per detik (MPS)

Batas messaging throughput pada nomor Coex lebih rendah dibandingkan WhatsApp Cloud API. Oleh karena itu, terdapat beberapa penyesuaian pada proses pengiriman broadcast untuk mengurangi kemungkinan terjadinya rate limit, terutama saat mengirim broadcast dalam jumlah besar.

1. Batas Pengiriman Campaign untuk Nomor Coex

Batas jumlah penerima dalam satu campaign untuk nomor Coex akan disesuaikan menjadi:

  • Nomor Coex: maksimal 3.000 penerima per campaign.

  • API Direct Send Broadcast: 100 RPM.

2. Batas Pengiriman Campaign untuk Cloud API

Batas jumlah penerima dalam satu campaign untuk nomor Cloud API tetap tidak berubah:

  • Nomor Qontak One Cloud API: maksimal 20.000 penerima per campaign.

  • Nomor Non-Qontak One Cloud API: maksimal 50.000 penerima per campaign.

E. FAQ terkait Pembatasan Akun saat Integrasi WhatsApp Coexistence

Pembatasan (restriction) pada akun WhatsApp dapat terjadi tidak lama setelah akun diintegrasikan melalui fitur WhatsApp Coexistence. Untuk menghindari hal tersebut, pastikan beberapa hal telah diperiksa sebelum melakukan integrasi. Jika akun sudah terkena pembatasan, ikuti langkah yang dijelaskan untuk mengetahui tindakan yang perlu dilakukan.

Informasi yang disampaikan di bagian ini disusun berdasarkan panduan dari Meta yang diterima oleh tim Qontak. Perlu diperhatikan bahwa keputusan terkait pembatasan maupun pemulihan akun sepenuhnya berada di pihak Meta.

5.png

a. Memahami Penyebab Batasan

  1. Kenapa akun saya dibatasi padahal belum mengirim pesan sama sekali?
    Menurut Meta, begitu proses onboarding Coexistence dikirim, Meta langsung menjalankan review integritas secara otomatis. Hasil review ini mencerminkan kondisi aktivitas akun yang sudah ada sebelumnya, bukan aktivitas pengiriman pesan yang baru.
    Artinya, pembatasan yang muncul tepat setelah integrasi umumnya berasal dari riwayat akun, business portfolio atau admin Facebook, dan bukan dari Qontak.
  2. Apakah riwayat akun WhatsApp Business App saya berpengaruh?
    Ya. Coexistence menghubungkan akun WhatsApp Business App yang sudah ada dengan WhatsApp Cloud API, sehingga aktivitas akun di aplikasi tersebut menjadi bagian dari penilaian kelayakan.
    Menurut Meta, onboarding diperkirakan akan terblokir atau dibatalkan jika:
    1. Akun WhatsApp Business App mendapat peringatan atau diblokir oleh Meta, atau masih memiliki pelanggaran kebijakan yang aktif, atau
    2. Akun, business portfolio, atau user admin yang menjalankan signup sedang dalam status dibatasi.
  3. Apakah pembatasan hanya berlaku untuk nomor yang saya integrasikan?
    Belum tentu. Menurut Meta, pemeriksaan onboarding dievaluasi di level business portfolio, bukan per nomor telepon. Jika review gagal, dampaknya bisa mengenai seluruh portfolio dan semua WABA di bawahnya, bukan hanya nomor yang sedang diintegrasikan.

b. Sebelum Integrasi

  1. Apa saja yang harus saya periksa sebelum menghubungkan nomor?
    Meta menyarankan checklist berikut untuk setiap onboarding Coexistence:
No. Hal yang perlu diperiksa  Keterangan
Aktivitas akun
1 Akun WhatsApp Business App dalam kondisi baik Tidak mendapat peringatan atau pemblokiran dari Meta serta tidak memiliki pelanggaran kebijakan yang aktif atau tidak dalam kondisi "under review or low quality/medium".
WhatsApp Manager Phone Numbers Dashboard.png
6.png
2 Business portfolio tidak dibatasi Tidak ada isu kebijakan yang belum selesai. Cek di Account Quality.
3 Admin yang melakukan signup tidak dibatasi Jika admin tersebut dibatasi secara personal, gunakan admin lain.
4 Portfolio tidak berisi akun bermasalah Jangan menghubungkan nomor ke portfolio yang sudah berisi akun yang dibatasi.
Penyiapan portfolio
5 Gunakan portfolio yang sudah mapan dan bersih Hindari membuat portfolio baru hanya untuk integrasi ini (lihat pertanyaan 7).
6 Jumlah ad account seminimal mungkin Jaga agar ad account di dalam portfolio tetap sedikit.
Proses onboarding
7 Isi website bisnis saat signup Lihat pertanyaan 6.
8 Selesaikan business verification sedini mungkin Lihat pertanyaan 5.
9 Nomor terdaftar di WhatsApp Business App Bukan aplikasi WhatsApp biasa (consumer).
10 Nomor bukan nomor yang baru didaftarkan Beri waktu agar riwayat akun terbentuk. Qontak mensyaratkan nomor aktif minimal 30 hari.
11 Negara Anda didukung untuk Coexistence Konfirmasi sebelum memulai.
  1. Apakah business verification wajib? 
    Tidak wajib untuk menghubungkan nomor, tetapi sangat disarankan sebelum integrasi. Menurut Meta, menyelesaikan business verification merupakan langkah paling efektif untuk menurunkan risiko pembatasan.
    Business verification juga diperlukan jika Anda ingin meningkatkan messaging tier ke tingkat yang lebih tinggi dan menggunakan beberapa fitur Meta lainnya.
  2. Kenapa saya harus mengisi website saat proses signup?
    Menurut Meta, jika website tidak diisi, akun yang masih baru atau belum terverifikasi dapat dikenakan pembatasan pengiriman sementara. Anda masih dapat menerima pesan, tetapi tidak dapat mengirim pesan.
    Pembatasan tersebut akan dilepas setelah:

    a. Website ditambahkan ke profil dan lolos review; atau
    b. Business verification selesai.

  3. Bolehkah saya membuat business portfolio baru khusus untuk integrasi ini? 
    Sebaiknya tidak. Menurut Meta, portfolio yang baru dibuat lebih rentan ter-flag. Jika portfolio baru terkena pembatasan, banding harus diajukan langsung oleh Anda melalui Account Quality. Pembatasan tersebut tidak dapat dilepaskan oleh Meta dari sisi partner, termasuk Qontak. 

  4. Bolehkah saya menggunakan nomor yang baru saja didaftarkan di WhatsApp Business App? 
    Tidak disarankan. Meta menyarankan agar Anda memberikan waktu untuk membentuk riwayat akun terlebih dahulu. Qontak juga mensyaratkan nomor WhatsApp Business App sudah aktif minimal 30 hari sebelum dapat dihubungkan melalui Coexistence.

c. Hal yang Harus Dihindari

  1. Apakah reset WhatsApp Business App bisa "membersihkan" masalah akun? 
    Tidak. Jangan melakukan reset penuh (WhatsApp Business App → WhatsApp biasa → WhatsApp Business App lagi). Menurut Meta, cara ini tidak mereset aktivitas akun dan justru berpotensi memutus koneksi Coexistence.

  2. Apa lagi yang sebaiknya dihindari?

    1. Menggunakan tools tidak resmi, automation, atau alur scripted untuk proses onboarding.
    2. Menghubungkan banyak nomor sekaligus tanpa memeriksa aktivitas setiap akun terlebih dahulu.

d. Jika Akun Sudah Terkena Pembatasan 

  1. Bagaimana cara mengajukan banding?
    Cara mengajukan banding bergantung pada jenis pembatasan yang dialami akun.

Yang dibatasi Cara mengajukan banding
WhatsApp Business Account (WABA) atau nomor telepon Buka WhatsApp Business App, lalu ketuk "Request a review".
Business portfolio Ajukan terpisah melalui Business Support Home / Account Quality. Banding dari aplikasi tidak memulihkan portfolio dan request ke tim Qontak untuk dibuatkan tiket ke Meta.Catatan: Request ke tim Qontak hanya dapat dilakukan untuk akun yang sudah terkoneksi ke Qontak.
  1. Apa yang terjadi setelah banding dari aplikasi berhasil? 
    Koneksi Coexistence akan terputus. Menurut Meta, setelah akun berhasil dipulihkan melalui aplikasi, akun perlu didaftarkan ulang (re-registration). Proses ini akan memutus semua perangkat yang terhubung, termasuk koneksi ke Qontak.
    Setelah akun pulih, hubungkan kembali nomor Anda melalui Qontak dengan memilih "Settings" → "Integrations" → "WhatsApp".
  2. Berapa lama proses banding?
    Proses review banding membutuhkan waktu. Meta tidak dapat menjamin hasil maupun waktu penyelesaian tertentu. 

  3. Akun saya tidak pernah melanggar kebijakan dan belum mengirim pesan, tetapi tetap dibatasi. Apa yang harus saya lakukan?
    Menurut Meta, tidak semua pembatasan disebabkan oleh masalah di sisi klien, sehingga kasus seperti ini perlu ditinjau secara individual. Hubungi tim Support Qontak melalui dengan menyertakan:
    a. WABA ID
    b. Nomor telepon yang dibatasi
    c. Business portfolio ID
    d. Perkiraan waktu saat pembatasan terjadi.
    Tim Qontak akan meneruskan kasus Anda ke Meta untuk ditinjau.

  4. Di mana saya bisa menemukan WABA ID dan business portfolio ID?
    a. Business portfolio ID: Meta Business Suite → "Settings" → "Business info".
    b. WABA ID: Meta Business Suite → "WhatsApp Manager" → pilih akun WhatsApp Anda.
  5. Apakah Qontak bisa melepaskan pembatasan akun saya? 
    Tidak. Keputusan terkait pembatasan dan pemulihan akun sepenuhnya berada di pihak Meta. Qontak dapat membantu memeriksa kondisi integrasi Anda dan meneruskan kasus ke Meta untuk kasus seperti yang dijelaskan pada pertanyaan 14.