Checklist Pindah Provider WhatsApp API ke Jalinara: 6 Hal yang Perlu Dicek

Oleh Jalinara · 2026-07-27 · 5 menit baca

Ringkasan singkat: Panduan 6 langkah generik buat siapa pun yang mau pindah provider WhatsApp API ke Jalinara, dari cek endpoint dan autentikasi sampai kenapa histori kontak biasanya nggak ikut pindah otomatis.

Pindah provider WhatsApp API bukan cuma soal ganti nama vendor di invoice. Ada endpoint yang berubah, token yang harus digenerate ulang, dan risiko pesan customer nyangkut kalau ada yang kelewatan. Checklist ini generik, berlaku mau kamu pindah dari provider mana pun ke Jalinara, karena masalahnya memang selalu mirip: bagian mana yang berubah, dan bagaimana caranya supaya nggak ada yang putus di tengah jalan.

1. Petakan Endpoint Lama ke Endpoint Jalinara

Langkah paling dasar: cari tahu di kode kamu, di mana saja request kirim pesan ke provider lama dipanggil. Biasanya ada di satu atau dua fungsi terpusat (kalau kodenya rapi) atau tersebar di banyak tempat (kalau belum sempat dirapikan). Semua pemanggilan itu perlu diarahkan ke endpoint Jalinara: POST https://app.jalinara.id/send. Kalau kamu pakai banyak service terpisah (misalnya satu buat notifikasi transaksi, satu buat broadcast promo), catat semua satu per satu. Jangan andalkan ingatan, karena ini bagian yang paling sering ada yang kelewatan.

Titik integrasi yang paling sering kelewatan biasanya bukan yang utama, tapi yang nyempil: notifikasi OTP saat checkout, update status pesanan dari sistem logistik, atau tombol "kirim manual" yang dipakai tim CS dari panel admin. Semua ini kadang manggil API provider lama lewat jalur yang terpisah dari jalur utama. Tim teknis biasanya inget jalur utama (misalnya notifikasi transaksi), tapi lupa ada dua atau tiga service kecil lain yang jalan sendiri-sendiri.

2. Ganti Skema Autentikasi

Tiap provider punya cara autentikasi sendiri: ada yang pakai API key di query string, ada yang di body request, ada yang custom header. Jalinara pakai format standar: header Authorization: Bearer <token>. Ini kelihatan sepele, tapi kalau kode lama kamu masih nyisipin API key lama di query string atau body, request ke Jalinara bakal ditolak dan errornya kadang nggak jelas nunjuk ke masalah autentikasi. Cek dulu format yang benar di dokumentasi sebelum nge-debug hal lain.

3. Cek Ulang Format Nomor Tujuan

Ini yang paling gampang lolos dari perhatian. Provider lama mungkin menerima nomor dengan awalan 08, atau malah fleksibel nerima dua-duanya. Jalinara, seperti kebanyakan API WhatsApp, mengharapkan format internasional yang diawali 62, bukan 08. Kalau database kontak kamu masih nyimpen nomor dengan format 08xxx, siapkan fungsi konversi sebelum data itu dikirim ke endpoint baru. Salah format nomor biasanya bukan bikin error langsung, tapi bikin pesan gagal terkirim ke nomor yang sebenarnya valid.

4. Uji Webhook Baru dari Nol: Jangan Asumsikan Sama

Ini bagian yang paling sering bikin kaget. Struktur payload webhook status pengiriman dan pesan masuk beda-beda antar provider: nama field, format timestamp, bahkan urutan status (terkirim, dibaca, gagal) bisa berbeda. Jangan asumsikan payload dari Jalinara identik dengan provider lama, walaupun konsepnya kelihatan sama. Cara paling aman: pasang endpoint webhook baru di environment staging, kirim beberapa pesan test, lalu log mentahan payload yang masuk sebelum kamu mulai parsing. Detail soal struktur payload dan cara handle pesan masuk ada di panduan webhook Jalinara. Baca itu dulu sebelum nulis ulang parser kamu.

5. Jalankan Berdampingan Dulu, Baru Cutover Penuh

Godaan terbesar waktu migrasi adalah langsung matikan provider lama begitu integrasi baru "kelihatannya jalan". Jangan. Pilih sebagian kecil trafik dulu (bisa nomor test internal, bisa segmen customer tertentu yang risikonya rendah kalau ada masalah) dan jalankan dua provider berdampingan selama beberapa hari. Kalau ada yang salah (format pesan ketuker, webhook telat, rate limit beda), dampaknya kebatasi ke segmen kecil itu, bukan ke seluruh basis pelanggan kamu. Baru setelah itu stabil, cutover penuh.

Nggak ada angka baku soal berapa persen trafik yang aman buat uji paralel, tapi patokan yang wajar: mulai dari nomor test internal punya tim sendiri selama 1-2 hari, lanjut ke segmen kecil customer riil (bisa 5-10% dari volume harian) selama 2-3 hari, baru cutover penuh kalau nggak ada anomali di webhook atau lonjakan tingkat gagal selama periode itu.

6. Histori Kontak dan Label Biasanya Tidak Ikut Pindah

Ini yang paling sering dilupakan karena bukan masalah teknis integrasi, tapi masalah data. Label pelanggan, tag segmentasi, dan riwayat percakapan yang kamu bangun bertahun-tahun itu hidup di sistem provider lama, dan nggak ada mekanisme otomatis yang memindahkannya ke provider baru manapun, termasuk Jalinara. Kalau data itu penting buat operasional kamu (misalnya buat targeting broadcast), rencanakan proses ekspor-impor manual dari awal, jangan nunggu H-1 migrasi baru sadar datanya nggak ada.

Satu Hal yang Perlu Kamu Tahu Soal Koneksi Jalinara

Sebelum checklist di atas kamu jalankan, penting untuk tahu satu hal: koneksi WhatsApp di Jalinara berbasis pendekatan WhatsApp Web (scan QR atau pairing dari nomor pemilik), bukan WhatsApp Business API resmi dari Meta. Jalinara juga tidak berafiliasi dengan Meta Platforms, Inc. Ini bukan kekurangan yang disembunyikan: ini relevan buat ekspektasi kamu soal cara kerja koneksinya, terutama kalau sebelumnya kamu terbiasa dengan provider yang pakai jalur API resmi. Kalau pertimbangan ini penting buat kamu, ada baiknya baca dulu cara memilih WhatsApp API yang andal dan sisi keamanan API WhatsApp supaya keputusan pindahnya berdasarkan pertimbangan yang lengkap, bukan cuma harga.

Libatkan Tim Non-Teknis Juga

Migrasi provider WhatsApp API sering diperlakukan sebagai proyek IT semata, padahal ada dampak ke tim yang nggak megang kode. Tim customer service perlu tahu kalau ada perubahan format nomor atau template pesan, supaya mereka nggak bingung waktu ada laporan "pesan nggak sampai" di hari-hari awal migrasi. Tim marketing yang biasa jadwalin broadcast promo perlu tahu kapan cutover terjadi, supaya nggak kebetulan taruh kampanye besar tepat di hari yang sama. Komunikasi ini kelihatan sepele, tapi sering jadi sumber kepanikan dadakan waktu migrasi jalan dan ada yang komplain padahal penyebabnya cuma soal informasi yang nggak sampai ke orang yang tepat.

Setelah Checklist Ini Selesai

Kalau keenam poin di atas sudah kamu cek satu-satu (endpoint, autentikasi, format nomor, webhook, uji paralel, dan rencana data), migrasi biasanya nggak butuh proses yang dramatis. Yang bikin migrasi provider WhatsApp API berantakan itu jarang karena teknologinya sulit; lebih sering karena ada satu langkah yang dilewat karena dianggap "nanti aja dicek belakangan".

Migrasi provider yang mulus itu bukan soal secepat apa kamu cutover, tapi seberapa kecil dampaknya kalau ada yang salah di tengah jalan.

Poin Penting

Endpoint kirim pesan Jalinara: POST https://app.jalinara.id/send — petakan semua tempat di kode yang manggil endpoint provider lama, termasuk jalur kecil seperti OTP dan notifikasi logistik.
Autentikasi Jalinara pakai header Authorization: Bearer , beda dengan provider yang naruh API key di query string atau body request.
Format nomor tujuan wajib format internasional berawalan 62, bukan 08 — siapkan fungsi konversi kalau database kontak masih pakai format lama.
Struktur payload webhook beda antar provider, jangan asumsikan sama. Uji dulu di staging sebelum menulis ulang parser.
Jalankan provider lama dan Jalinara berdampingan di sebagian kecil trafik dulu (nomor test, lalu 5-10% volume harian) sebelum cutover penuh.
Histori kontak, label, dan tag pelanggan tidak ikut pindah otomatis — siapkan proses ekspor-impor manual dari awal.

Pertanyaan yang sering ditanyakan

Apakah histori chat dan kontak otomatis pindah waktu ganti provider WhatsApp API?

Tidak. Histori percakapan, label, dan tag pelanggan tersimpan di sistem provider lama, dan tidak ada mekanisme otomatis yang memindahkannya ke provider baru mana pun, termasuk Jalinara. Kamu perlu rencanakan proses ekspor data secara manual, lalu impor ke Jalinara sesuai kebutuhan.

Berapa lama proses migrasi provider WhatsApp API biasanya berlangsung?

Tergantung kompleksitas integrasi, tapi kalau endpoint, autentikasi, format nomor, dan webhook sudah dicek dari awal, sebagian besar tim bisa selesai dalam hitungan hari. Yang memperlambat biasanya bukan sisi teknis, tapi keputusan menunda uji coba paralel.

Apakah koneksi WhatsApp Jalinara sama dengan WhatsApp Business API resmi dari Meta?

Tidak. Jalinara memakai pendekatan WhatsApp Web, yaitu scan QR atau pairing dari nomor pemilik, dan tidak berafiliasi dengan Meta Platforms, Inc. Penting diketahui sejak awal supaya ekspektasi kamu soal cara kerja koneksinya sesuai kenyataan.

Kenapa webhook dari provider baru tidak bisa langsung pakai parser lama?

Karena struktur payloadnya, mulai dari nama field sampai format timestamp dan urutan status pengiriman, berbeda antar provider meskipun konsepnya mirip. Uji webhook baru di staging dulu, log payload mentahnya, baru sesuaikan parser berdasarkan struktur yang benar-benar diterima.

Apa risiko kalau langsung cutover penuh tanpa uji paralel dulu?

Kalau ada kesalahan konfigurasi seperti format nomor salah, webhook belum sinkron, atau rate limit berbeda, dampaknya langsung kena ke seluruh basis pelanggan, bukan cuma segmen kecil. Uji paralel di sebagian trafik dulu supaya masalah ketahuan sebelum skalanya besar.

Apakah format nomor 08 tetap bisa dipakai di Jalinara?

Endpoint Jalinara mengharapkan format internasional berawalan 62. Kalau data kontak kamu masih tersimpan dengan awalan 08, siapkan fungsi konversi format nomor sebelum data itu dikirim ke endpoint pengiriman pesan.