Channel

Apa Itu Channel?

Channel adalah platform komunikasi yang digunakan agen Neotask Anda untuk mengirim dan menerima pesan. Dengan menghubungkan channel, Anda memberi agen kemampuan untuk mendengarkan pesan masuk di platform tersebut dan merespons secara real time.

Konsep utama:

Konfigurasi per agen -- Setiap koneksi channel dikonfigurasi di tingkat agen. Satu agen dapat terhubung ke Slack sementara yang lain menangani Discord, atau satu agen dapat terhubung ke beberapa channel secara bersamaan.
Bidirectional -- Channel mendukung pengiriman dan penerimaan pesan. Agen dapat merespons pesan masuk, menginisiasi pesan keluar, atau keduanya.
Multi-akun -- Anda dapat menghubungkan beberapa akun untuk jenis channel yang sama (misalnya, dua workspace Slack yang berbeda atau beberapa alamat email).

Channel yang Didukung

Channel	Metode Auth	Fitur
Slack	OAuth	Pesan penuh, channel, thread, reaksi, upload file
Discord	Bot token	Pesan server, channel, DM, embed, reaksi
WhatsApp	Kode QR	Pesan teks, pesan media, chat grup
Telegram	Bot token	Pesan teks, grup, channel, keyboard inline, berbagi file
Signal	Aplikasi lokal	Pesan terenkripsi end-to-end, chat grup
Microsoft Teams	OAuth	Tim, channel, chat, adaptive card, berbagi file
Google Chat	OAuth	Space, pesan langsung, card, percakapan berthread
SMS	API key	Pesan teks keluar dan masuk melalui penyedia yang didukung
Email / Gmail	OAuth	Kirim, terima, draft, balas, lampiran, manajemen label
Matrix	Token	Pesan federasi, ruang, enkripsi end-to-end
Line	Token	Pesan teks, stiker, chat grup, menu kaya
Zalo	Token	Pesan teks, berbagi media
IRC	Config	Koneksi server, channel, pesan pribadi
iMessage	Lokal	Pesan native macOS (memerlukan host macOS)

Menghubungkan Channel

Proses koneksi bervariasi tergantung metode autentikasi channel.

Alur OAuth

Digunakan oleh: Slack, Microsoft Teams, Google Chat, Email / Gmail

Buka tab Channels agen.
Klik Connect di samping channel yang ingin ditambahkan.
Anda akan diarahkan ke halaman otorisasi layanan.
Masuk dengan akun Anda dan berikan izin yang diminta ke Neotask.
Setelah otorisasi, Anda diarahkan kembali ke dashboard dan channel muncul sebagai terhubung.

Untuk platform mobile, opsi kode QR tersedia. Pindai kode QR dari ponsel Anda untuk menyelesaikan otorisasi tanpa perlu masuk di browser desktop Anda.

Bot Token

Digunakan oleh: Discord, Telegram

Buat bot di platform masing-masing:
- Discord -- Buat aplikasi di Discord Developer Portal dan hasilkan bot token.
- Telegram -- Kirim pesan ke @BotFather di Telegram untuk membuat bot dan menerima token.
Buka tab Channels agen dan klik Connect di samping channel.
Tempel bot token ke field token.
Klik Save untuk membuat koneksi.

Kode QR

Digunakan oleh: WhatsApp

Buka tab Channels agen dan klik Connect di samping WhatsApp.
Kode QR akan muncul di layar.
Buka WhatsApp di ponsel Anda, buka Linked Devices, dan pindai kode QR.
Koneksi terjalin setelah ponsel Anda mengkonfirmasi tautan.

API Key

Digunakan oleh: SMS

Dapatkan kunci API dari penyedia SMS Anda (misalnya, Twilio, Vonage).
Buka tab Channels agen dan klik Connect di samping SMS.
Masukkan kunci API Anda dan field tambahan yang diperlukan (misalnya, nomor telepon, account SID).
Klik Save untuk mengaktifkan channel.

Token

Digunakan oleh: Matrix, Line, Zalo

Hasilkan token akses dari pengaturan developer atau panel admin platform masing-masing.
Buka tab Channels agen dan klik Connect di samping channel.
Tempel token ke field token.
Klik Save untuk membuat koneksi.

Konfigurasi Server

Digunakan oleh: IRC

Buka tab Channels agen dan klik Connect di samping IRC.
Masukkan alamat server, port, nickname, dan (opsional) kata sandi.
Tentukan channel yang akan di-join saat terhubung.
Klik Save untuk terhubung.

Aplikasi Lokal

Digunakan oleh: Signal, iMessage

Pastikan aplikasi yang diperlukan terinstal dan berjalan di mesin host:
- Signal -- Signal Desktop harus terinstal dan ditautkan ke akun Signal Anda.
- iMessage -- Memerlukan host macOS dengan Messages.app yang dikonfigurasi.
Buka tab Channels agen dan klik Connect di samping channel.
Neotask akan mendeteksi aplikasi lokal dan membuat koneksi.
Jika aplikasi tidak terdeteksi, Anda akan diminta untuk menginstal atau mengkonfigurasinya.

Pengujian Koneksi

Setelah menghubungkan channel apa pun, Neotask secara otomatis menjalankan probe latensi untuk memverifikasi koneksi:

Pesan tes dikirim dan diterima melalui API channel.
Latensi round-trip diukur dan ditampilkan.
Jika tes gagal, pesan error menjelaskan masalahnya (misalnya, token tidak valid, grant OAuth kedaluwarsa, server tidak dapat dijangkau).

Anda dapat menjalankan ulang tes koneksi kapan saja dari pengaturan channel.

Operasi Channel

Setelah channel terhubung, Anda dapat mengelolanya dari tab Channels agen.

Aktifkan / Nonaktifkan

Hidupkan atau matikan channel tanpa memutusnya. Saat dinonaktifkan:

Agen berhenti mendengarkan pesan di channel tersebut.
Tidak ada pesan keluar yang dikirim melaluinya.
Kredensial koneksi dipertahankan sehingga Anda dapat mengaktifkan kembali kapan saja tanpa konfigurasi ulang.

Uji Konektivitas

Jalankan tes konektivitas sesuai permintaan untuk memverifikasi channel dapat dijangkau dan responsif. Tes ini:

Mengirim permintaan API ringan ke layanan channel.
Mengukur latensi round-trip dalam milidetik.
Melaporkan hasil sebagai Connected (dengan latensi) atau Failed (dengan detail error).

Lihat Latensi

Setiap channel yang terhubung menampilkan pembacaan latensi terbaru di tab Channels. Ini membantu Anda mengidentifikasi koneksi yang lambat atau terdegradasi secara sekilas. Latensi diperbarui:

Secara otomatis setelah setiap tes koneksi.
Secara berkala di latar belakang saat channel aktif.

Putuskan / Logout

Untuk menghapus koneksi channel sepenuhnya:

Klik Disconnect di samping channel.
Konfirmasi tindakan di dialog.
Neotask mencabut atau membuang kredensial yang tersimpan (token OAuth dicabut di sisi penyedia jika didukung).
Channel dihapus dari daftar channel aktif agen.

Untuk menghubungkan kembali setelah memutus, ikuti langkah-langkah koneksi asli lagi.