Lewati ke konten utama

Migrasi Chatwoot

Memindahkan data dari Chatwoot ke Custelio bersifat eksperimental dan belum layak produksi sampai migration drill lulus penuh. Ikuti alur wajib di bawah ini; kontrak payload dan endpoint mengikuti OpenAPI, bukan halaman ini.

Tujuan​

Data Chatwoot hanya dipindahkan bila backup tersedia, dry run lulus, dan rekonsiliasi mencocokkan sumber dengan target.

Untuk siapa​

Operator dan account owner yang menjalankan migration runner dan memiliki akses ke data sumber Chatwoot.

Prasyarat​

  • Backup penuh database target dan snapshot data sumber sudah tersedia lebih dulu.
  • Target menjalankan seluruh migration berurutan, dengan skema yang mendukung entitas yang akan dipindahkan.
  • Izin operator tersedia; jangan memakai kredensial akun lain.

Alur kerja migrasi​

  1. Ambil backup database target dan snapshot sumber sebelum langkah apa pun. Tanpa backup yang bisa dipulihkan, jangan lanjut.
  2. Jalankan dry run pada data non-produksi atau sandbox, lalu evaluasi hasil pemindahan label, kontak, dan percakapan sebelum menulis ke produksi.
  3. Bila dry run belum mencakup semua entitas, jangan menganggap migrasi lengkap; gunakan daftar cakupan yang jelas.
  4. Lakukan rekonsiliasi antara sumber dan target: jumlah entitas, identitas, dan keterkaitan harus cocok; jelaskan setiap selisih.
  5. Lanjutkan ke produksi hanya setelah dry run, backup, dan rekonsiliasi memenuhi kriteria. Dokumentasikan perintah dan hasilnya, termasuk migrate, pause, resume, dan status.
  6. Migrasi tidak otomatis sukses hanya karena job-nya terbuat.

Tanda berhasil​

Entitas di Custelio sesuai dengan sumber Chatwoot, tidak ada error SQL selama pemindahan data, dan status hasil migrasi tercatat.

Jika terjadi masalah​

  • Error SQL saat migrasi: hentikan proses, periksa apakah skema target mendukung entitas yang dipindahkan, perbaiki, lalu ulangi dry run.
  • Migrasi gagal diam-diam: rekonsiliasi wajib menangkap selisih sebelum migrasi ditandai selesai; jangan biarkan data hilang tanpa jejak.
  • Hasil tidak konsisten: pulihkan dari backup, lalu ulangi dari awal.

Batasan​

Fitur migrasi lanjutan belum dirilis dan tidak dikembangkan mendahului penyelesaian core. Ketidaksesuaian data atau dry run yang gagal menjadi blocker, bukan status opsional. Alur rollback terbatas pada titik yang dijelaskan di sini dan harus diuji.

Tugas terkait​