Gambaran Umum Connections

Apa itu Connections?

Connections adalah pusat pengelolaan channel komunikasi yang digunakan CRMAI untuk menerima dan mengirim pesan pelanggan.

Dari halaman ini, pengguna workspace bisa:

Menghubungkan nomor WhatsApp.
Menghubungkan bot Telegram.
Menghubungkan akun Instagram Business atau Creator lewat Meta OAuth atau kredensial manual.
Menetapkan koneksi ke satu atau lebih Divisi.
Menandai koneksi sebagai pengirim default.
Mengatur pesan sambutan, perpisahan, dan pesan saat tidak tersedia (away).
Melampirkan media ke pesan otomatis.
Menggunakan variabel teks atau pesan interaktif.
Melihat status koneksi saat ini.
Membuka QR code atau pairing code WhatsApp saat diperlukan.
Refresh, connect, disconnect, atau logout dari sebuah koneksi.
Mengambil riwayat pesan WhatsApp untuk provider yang didukung.
Mengedit atau menghapus koneksi yang sudah ada.

Penting: Opsi yang tersedia tergantung pada channel yang dipilih, provider, status koneksi, konfigurasi workspace, dan permission pengguna.

Mengakses Connections

Login ke CRMAI.
Buka dashboard workspace.
Buka Connections dari menu navigasi.
Halaman menampilkan heading Channels, filter channel, dan kartu koneksi yang sudah dikonfigurasi.

URL: /{locale}/dashboard/connections — contoh: /en/dashboard/connections

Path /connections juga digunakan sebagai rute callback OAuth Instagram. Setelah autentikasi, CRMAI mengarahkan ke halaman Connections yang sebenarnya.

Permission yang dibutuhkan

Permission	Fungsi
`connections:create`	Membuat koneksi channel baru.
`connections:edit`	Mengedit koneksi yang sudah ada atau mengubah konfigurasinya.
`connections:delete`	Menghapus koneksi yang sudah ada.

Jika kamu tidak bisa melihat atau menggunakan aksi koneksi, minta administrator workspace untuk meninjau role dan permission kamu.

Channel yang didukung

Halaman Connections saat ini menyediakan filter channel berikut:

All
WhatsApp
Telegram
Instagram

Perbandingan channel

Channel	Metode koneksi	Kredensial	QR/pairing code	Field terkait webhook
WhatsApp	Merapi atau Merbabu	Tidak ada field kredensial manual	QR code atau pairing code	Tidak ditampilkan di form setup WhatsApp
Telegram	Telegram Bot	Bot token dan webhook secret	Tidak digunakan	Webhook URL opsional
Instagram	Instagram Meta	Page access token, IG user ID, App ID opsional	Tidak digunakan	Dikelola lewat integrasi Meta/OAuth

Email saat ini belum tersedia sebagai channel yang bisa dipilih di UI Connections.

Kartu koneksi

Setiap koneksi yang dikonfigurasi muncul sebagai kartu, menampilkan:

Nama koneksi.
Ikon channel atau foto profil.
Status saat ini.
Ikon shield jika koneksi ini adalah koneksi default.
Identifier koneksi.
Identifier alternatif.
Tanggal dibuat.
Tombol refresh/state saat kartu di-hover atau fokus.
Aksi QR code atau pairing-code saat WhatsApp membutuhkan autentikasi.

Klik kartu untuk membuka dialog konfigurasi koneksi. Hindari klik tombol refresh saat kamu bermaksud membuka editor — refresh adalah aksi terpisah.

Status koneksi

Status	Arti
`CONNECTED`	Channel terhubung dan tersedia.
`DISCONNECTED`	Channel saat ini tidak terhubung.
`PENDING`	Permintaan koneksi sedang diproses.
`QRCODE`	Koneksi menunggu autentikasi QR code.
`ERROR`	Koneksi mengalami error.

Deployment tertentu bisa menampilkan nilai status tambahan dari backend. Jika muncul nilai yang tidak familiar, gunakan aksi refresh state dan hubungi administrator workspace jika status tidak berubah.

Troubleshooting umum

Pesan otomatis tidak terkirim — periksa:

Apakah bagian terkait sudah diaktifkan.
Apakah teks pesan tidak kosong.
Apakah tipe pesan yang dipilih didukung oleh provider.
Apakah jadwal/timezone sudah benar.
Apakah target penerima mencakup pelanggan uji coba.
Apakah cooldown mencegah pesan berulang.
Apakah koneksi saat ini berstatus CONNECTED.

Field kredensial tersimpan tampak kosong — field kredensial memang sengaja di-mask untuk koneksi yang sudah ada. Isi kredensial pengganti hanya jika kamu benar-benar ingin memperbaruinya. Membiarkan field tidak diubah akan mempertahankan kredensial yang tersimpan.

Pesan tidak ter-routing ke tim yang tepat

Buka konfigurasi koneksi.
Tinjau divisi target yang dipilih.
Pastikan divisi yang dituju sudah dipilih.
Simpan koneksi.
Uji dengan pesan baru.

Rekomendasi keamanan dan operasional

Perlakukan bot token, access token, webhook secret, dan pairing code sebagai data sensitif.
Jangan sertakan kredensial asli di screenshot, dokumentasi, tiket, atau pesan chat.
Gunakan koneksi terpisah untuk fungsi bisnis terpisah saat tim, divisi, atau pelaporan membutuhkan pemisahan yang jelas.
Pilih satu koneksi default per alur pengiriman yang dimaksud.
Uji pesan sambutan, perpisahan, away, dan interaktif sebelum diaktifkan untuk semua pelanggan.
Gunakan nama koneksi yang bermakna supaya operator bisa cepat mengenali channel yang benar.
Tinjau opsi Delete related tickets? dengan cermat sebelum menghapus koneksi.
Disconnect atau logout channel sebelum mengubah detail autentikasi saat UI menonaktifkan field tersebut.
Gunakan role workspace dengan hak akses paling minim yang masih memungkinkan aksi koneksi yang dibutuhkan.

Lanjut ke: Setup WhatsApp · Setup Telegram · Setup Instagram · Automated Messages