Integrasi WhatsApp Business API: Panduan E-commerce Brasil 2026

E-commerce Brasil berjalan di atas empat platform dominan: VTEX (pasar menengah dan perusahaan besar), Tray (UKM hingga pasar menengah), Nuvemshop (UKM), dan Loja Integrada (UKM). Setiap platform memerlukan pola integrasi spesifik untuk menghubungkan WhatsApp Business API untuk pemulihan keranjang yang ditinggalkan, konfirmasi pesanan, pembaruan pengiriman, pengiriman NF-e, dan checkout Pix di dalam percakapan WhatsApp. Panduan ini menjelaskan pengaturan konektor bawaan untuk keempat platform Brasil tersebut ditambah Shopify Brasil dan WooCommerce, lengkap dengan contoh kode dan pemetaan peristiwa demi peristiwa.

Jawaban Cepat: Bagaimana WhatsApp Business API Berintegrasi dengan Platform E-commerce Brasil?

Untuk empat platform e-commerce dominan Brasil, konektor bawaan melalui Message Central's WhatsAppNow menangani integrasi secara menyeluruh: VTEX melalui aplikasi VTEX IO, Tray melalui jembatan webhook REST, Nuvemshop melalui integrasi App Store, dan Loja Integrada melalui API langsung. Konektor menerima peristiwa platform (keranjang ditinggalkan, pesanan dibuat, pembayaran dikonfirmasi, dikirim) dan memicu template WhatsApp serta pembuatan tagihan Pix sesuai kebutuhan. Pengaturan biasanya memakan waktu 2-5 hari kerja. Untuk platform tanpa konektor bawaan (Shopify Brasil, WooCommerce, Magento kustom), integrasi REST API dengan jembatan webhook adalah jalur standar — biasanya 1-2 minggu pekerjaan teknik. Lihat platform WhatsApp Business API di Brasil.

Empat Platform E-commerce Brasil yang Penting

VTEX

Platform e-commerce asli Brasil dengan jejak pasar perusahaan besar dan menengah terbesar di Brasil. Digunakan oleh Magazine Luiza, Coca-Cola, Walmart Brasil, Whirlpool, dan banyak merek besar. Dibangun di atas VTEX IO (platform pengembangan berbasis TypeScript) dengan kemampuan headless commerce penuh. Konektor WhatsApp bawaan melalui aplikasi VTEX IO tersedia melalui Message Central. Paling cocok untuk peritel Brasil skala menengah hingga perusahaan besar.

Tray

Platform e-commerce Brasil yang dimiliki oleh Locaweb, berfokus pada UKM hingga pasar menengah. Integrasi omnichannel yang kuat dengan marketplace (Mercado Livre, Amazon Brasil). REST API untuk langganan peristiwa produk, pesanan, dan keranjang. Konektor WhatsApp bawaan melalui Message Central via jembatan webhook. Paling cocok untuk toko online Brasil skala UKM hingga menengah.

Nuvemshop

Platform e-commerce SaaS yang berfokus pada Amerika Latin (sebelumnya Tiendanube), dengan kehadiran kuat di Argentina dan Brasil. Ekosistem App Store dengan ratusan integrasi bawaan. Konektor WhatsApp tersedia melalui Message Central sebagai Aplikasi Nuvemshop. Paling cocok untuk penjual multi-negara SMB di Amerika Latin.

Loja Integrada

Platform e-commerce SMB Brasil dengan strategi tingkat gratis yang kuat. Ratusan ribu toko Brasil aktif. API REST untuk peristiwa keranjang dan pesanan. Integrasi langsung dengan Message Central. Paling cocok untuk penjual SMB dan usaha mikro Brasil.

Integrasi VTEX dengan API Bisnis WhatsApp

Aplikasi VTEX IO adalah jalur integrasi yang direkomendasikan untuk API Bisnis WhatsApp. Message Central menyediakan aplikasi VTEX IO yang telah dipublikasikan yang menangani alur peristiwa standar:

• Peristiwa keranjang ditinggalkan (dari Konfigurasi Formulir Pesanan): memicu urutan pemulihan WhatsApp 3 sentuhan (1 jam, 24 jam, 72 jam)
• Peristiwa pesanan dibuat: memicu templat konfirmasi pesanan melalui kategori utilitas WhatsApp
• Peristiwa pembayaran dikonfirmasi: memicu tanda terima pembayaran + templat pengiriman NF-e
• Peristiwa pesanan dikirim: memicu templat kode pelacakan dengan perkiraan pengiriman
• Peristiwa pesanan terkirim: memicu permintaan NPS atau ulasan setelah penundaan 72 jam

Penyiapan: Lihat dokumentasi pengembang VTEX.

Integrasi Tray dengan API Bisnis WhatsApp

Tray menggunakan langganan webhook untuk integrasi berbasis peristiwa. Message Central menyediakan jembatan webhook yang mendengarkan peristiwa Tray dan memicu templat WhatsApp yang sesuai:

• Berlangganan webhook Tray untuk: order_created, order_paid, order_shipped, order_delivered, cart_abandoned (jika didukung oleh paket Tray Anda)
• Konfigurasi titik akhir webhook dan rahasia tanda tangan Message Central di admin Tray
• Petakan setiap peristiwa ke templat Portugis Brasil yang disetujui Meta
• Uji dengan pesanan sandbox sebelum tayang langsung

Waktu penyiapan: 1-2 hari kerja untuk pemetaan peristiwa standar. Alur kustom (logika segmentasi spesifik, pemicu upsell) menambah 2-3 hari lagi.

Integrasi Nuvemshop dengan API Bisnis WhatsApp

Nuvemshop menggunakan model App Store.

• Instal aplikasi Message Central WhatsApp Now dari App Store Nuvemshop
• Berikan izin yang diperlukan (baca pesanan, baca pelanggan, baca produk, kirim notifikasi)
• Konfigurasi kunci API Bisnis WhatsApp dari dasbor Message Central
• Pilih templat Portugis Brasil mana yang akan dipicu pada peristiwa Nuvemshop yang mana
• Aktifkan — biasanya tayang langsung dalam 1-2 hari

Untuk toko Nuvemshop di Argentina, Meksiko, dan Kolombia, konektor yang sama mendukung perutean WhatsApp multi-negara dengan ID pengirim lokal.

Integrasi Loja Integrada dengan API Bisnis WhatsApp

Loja Integrada menyediakan API REST untuk peristiwa pesanan dan keranjang. Integrasi dengan API Bisnis WhatsApp Message Central:

• Hasilkan kunci API Loja Integrada di panel admin
• Konfigurasi konektor Message Central dengan kredensial Loja Integrada
• Petakan peristiwa pesanan/keranjang ke templat WhatsApp
• Untuk keranjang yang ditinggalkan, konfigurasikan waktu urutan pemulihan (1 jam, 24 jam, 72 jam)
• Untuk konfirmasi pesanan, lampirkan pembuatan tagihan Pix untuk pesanan yang belum dibayar

Toko Loja Integrada SMB biasanya aktif dalam 1-2 hari. Toko dengan volume lebih tinggi mungkin memerlukan persetujuan templat khusus (siklus persetujuan Meta 4 jam melalui pra-penyaringan Message Central).

Integrasi Shopify Brasil dan WooCommerce

Untuk bisnis di Brasil yang menggunakan Shopify atau WooCommerce, integrasi REST API adalah solusinya:

Shopify Brasil

Gunakan Shopify Webhooks untuk peristiwa berikut: checkouts/create, checkouts/update, orders/create, orders/paid, orders/fulfilled. Konfigurasi endpoint HTTPS di Message Central API yang menerima dan mengubah payload Shopify menjadi pengiriman templat WhatsApp. Shopify Brasil mendukung harga BRL dan terintegrasi dengan PSP Brasil (Mercado Pago, PagSeguro) untuk Pix.

WooCommerce

Gunakan WooCommerce REST API + langganan webhook. Jembatan webhook kustom diperlukan jika tidak ada plugin Message Central WooCommerce yang tersedia. Pekerjaan rekayasa tipikal: 1-2 minggu.

Pemetaan Integrasi Per Peristiwa

Untuk semua platform, pemetaan peristiwa ke WhatsApp standar adalah:

Keranjang ditinggalkan (1 jam): Templat pemasaran, pengingat lembut, tanpa diskon. Termasuk gambar produk dan tombol kembali ke keranjang sekali ketuk.

Keranjang ditinggalkan (24 jam): Templat pemasaran dengan diskon 5-10% atau gratis ongkir. Opsi pembuatan tagihan Pix dalam percakapan yang sama.

Keranjang ditinggalkan (72 jam): Templat pemasaran dengan diskon akhir 10-15%. Sentuhan terakhir, tidak ada pesan lebih lanjut setelah ini untuk keranjang belanja spesifik ini.

Pesanan dibuat (belum dibayar): Templat utilitas dengan ringkasan pesanan dan tagihan Pix untuk pembayaran.

Pembayaran dikonfirmasi: Templat utilitas dengan tanda terima pembayaran, nomor pesanan, tanggal pengiriman yang diharapkan.

NF-e dibuat: Templat utilitas dengan lampiran PDF NF-e atau tautan unduhan.

Pesanan dikirim: Templat utilitas dengan nama kurir, kode pelacakan, perkiraan pengiriman.

Pesanan terkirim: Kategori layanan, NPS pasca-pengiriman atau permintaan ulasan (setelah penundaan 24-72 jam).

Pertimbangan LGPD dan Persetujuan Templat

Setiap jenis acara dipetakan ke kategori percakapan Meta dengan persyaratan LGPD yang berbeda:

• Pesan keranjang yang ditinggalkan: kategori pemasaran — membutuhkan persetujuan eksplisit WhatsApp berdasarkan LGPD
• Konfirmasi pesanan, tanda terima pembayaran, pengiriman, NF-e: kategori utilitas — termasuk dalam dasar hukum pelaksanaan kontrak, tidak memerlukan persetujuan terpisah
• Permintaan NPS/ulasan: kategori layanan jika dalam jendela 24 jam, pemasaran jika di luar (membutuhkan persetujuan)

Lihat panduan kepatuhan LGPD WhatsApp Business.

Kesalahan Integrasi Umum

Kesalahan 1: Mengirim pesan keranjang yang ditinggalkan tanpa opt-in WhatsApp

‍Opt-in email tidak mencakup WhatsApp berdasarkan LGPD. Solusi: kumpulkan opt-in WhatsApp saat checkout (kotak centang yang tidak dicentang secara otomatis).

Kesalahan 2: Mencampuradukkan kategori utilitas dan pemasaran

‍Mengirim penawaran promosi dalam templat utilitas akan ditolak oleh Meta dan merusak Peringkat Kualitas. Solusi: pertahankan konten transaksional di utilitas, konten promosi di pemasaran.

Kesalahan 3: Kurangnya idempoten pada penangan webhook

‍Percobaan ulang webhook dari VTEX, Tray, Nuvemshop dapat memicu peristiwa yang sama berkali-kali. Solusi: terapkan kunci idempoten.

Kesalahan 4: Mengirim NF-e segera setelah konfirmasi pembayaran

‍Pix diselesaikan dalam hitungan detik, tetapi pemenuhan mungkin belum mencatat pesanan. Solusi: penyangga 30-60 detik.

Referensi Otoritas Eksternal

Dokumentasi pengembang VTEX. Dokumentasi API Tray Brazil. Dokumentasi pengembang Nuvemshop. Dokumentasi Meta WhatsApp Cloud API. Spesifikasi BACEN Pix.

Pertanyaan yang Sering Diajukan

Berapa lama waktu yang dibutuhkan untuk integrasi WhatsApp Business API dengan platform e-commerce Brasil?

Untuk empat platform utama Brasil dengan konektor bawaan, integrasi biasanya memakan waktu 2-5 hari kerja. VTEX melalui aplikasi VTEX IO: 2-3 hari. Tray melalui jembatan webhook: 1-2 hari. Nuvemshop melalui App Store: 1-2 hari. Loja Integrada melalui REST API: 1-2 hari. Platform tanpa konektor bawaan (Shopify Brasil, WooCommerce, Magento kustom) biasanya membutuhkan 1-2 minggu pekerjaan teknis.

Platform e-commerce Brasil mana yang mendukung integrasi native WhatsApp Business API?

Keempat platform dominan Brasil semuanya mendukung integrasi native WhatsApp Business API: VTEX, Tray, Nuvemshop, dan Loja Integrada. Shopify Brasil dan WooCommerce didukung melalui integrasi REST API (membutuhkan jembatan webhook kustom). Platform lain (Vnda, Linx, Magento kustom) dapat berintegrasi melalui pola webhook + REST API.

Apakah saya memerlukan persetujuan (opt-in) LGPD terpisah untuk pesan keranjang yang ditinggalkan dibandingkan konfirmasi pesanan?

Ya untuk keranjang yang ditinggalkan, tidak untuk konfirmasi pesanan. Pesan keranjang yang ditinggalkan diklasifikasikan oleh Meta sebagai kategori pemasaran dan oleh LGPD sebagai pemasaran langsung, yang memerlukan persetujuan (opt-in) WhatsApp eksplisit. Konfirmasi pesanan, tanda terima pembayaran, notifikasi pengiriman, dan pengiriman NF-e adalah kategori utilitas berdasarkan dasar hukum pelaksanaan kontrak, tidak memerlukan persetujuan (opt-in) terpisah.

Bisakah saya mengintegrasikan pembayaran Pix di dalam percakapan WhatsApp melalui platform e-commerce saya?

Ya. Untuk keempat platform utama Brasil, integrasi Message Central mendukung pembuatan tagihan Pix di dalam percakapan WhatsApp. Ketika pelanggan merespons pesan keranjang yang ditinggalkan dengan niat membeli, konektor akan menghasilkan kode QR Pix dan Kode BR di dalam percakapan. Pelanggan membayar melalui aplikasi perbankan mereka dan platform e-commerce menerima konfirmasi pembayaran melalui webhook PSP. Lihat Panduan pembayaran Pix.

Berapa perkiraan upaya rekayasa yang dibutuhkan untuk integrasi WhatsApp Business API dengan VTEX?

Untuk VTEX, integrasi melalui aplikasi Message Central WhatsApp IO membutuhkan waktu 2-3 hari kerja secara menyeluruh: instal aplikasi dari VTEX App Store, konfigurasikan kunci API, petakan event ke template (keranjang ditinggalkan, pesanan dibuat, pembayaran dikonfirmasi, dikirim, diterima), uji dengan pesanan sandbox, dan mulai beroperasi. Alur kustom (logika segmentasi spesifik, pemicu upsell, perutean multi-toko) akan menambah 2-5 hari kerja rekayasa lainnya.

Langkah Selanjutnya

Untuk mengintegrasikan WhatsApp Business API dengan platform e-commerce Brasil Anda, mulailah dengan halaman platform WhatsApp Business API di Brasil. Untuk integrasi Pix guna menutup penjualan di dalam percakapan, lihat panduan pembayaran Pix. Untuk strategi pemulihan keranjang yang ditinggalkan, lihat panduan pemulihan keranjang. Untuk Iklan Klik-ke-WhatsApp guna mengisi funnel Anda, lihat panduan CTWA. Untuk kepatuhan LGPD, lihat panduan LGPD.