Channel chat
Ajak Smooth Agent-mu ngobrol dari Telegram, WhatsApp, Slack, Matrix, LINE, WeChat Work, dan Discord. Hanya kamu yang dijawab, setiap chat punya percakapannya sendiri.
| Channel | Arah | Cara terhubung | Yang dibutuhkan |
|---|---|---|---|
| Telegram | dua arah, tombol izin | long-polling (tanpa port terbuka) | token bot dari @BotFather |
| dua arah | webhook Meta Cloud API | token, phone-number id, verify token | |
| Slack | dua arah | webhook Events API (bertanda tangan) | bot token, signing secret |
| Matrix | dua arah | long-polling /sync, homeserver apa saja | access token bot |
| LINE | dua arah | webhook Messaging API (bertanda tangan) | channel access token + secret |
| WeChat Work | kirim saja | webhook group robot | URL robot |
| Discord | kirim saja | webhook channel | URL webhook |
Menyalakan channel
Pilih di wizard, atau sebut langsung:
smooth-agent setup --channels telegram,slack
smooth-agent channels list # yang sudah dikonfigurasi
smooth-agent channels test telegram "halo" # kirim pesan tes
smooth-agent daemon # jalankan channel + tugas terjadwalRahasia disimpan di ~/.smooth-agent/.env; config hanya menyebut nama variabelnya:
[channels]
enabled = ["telegram"]
webhook_port = 8808 # untuk WhatsApp, Slack, dan LINE
[channels.telegram]
token_env = "TELEGRAM_BOT_TOKEN"
owners = ["123456789"] # kirim pesan sekali ke bot: ia membalas dengan ID-mu
auto_approve = false # true = jalankan tool tanpa tekan tombol
voice_replies = "auto" # off | auto | always (butuh [tts] dan ffmpeg)Perilakunya
- Hanya pemilik. Siapa pun yang tidak ada di
ownershanya mendapat balasan singkat "agent ini privat" beserta ID-nya. - Satu percakapan per chat, disimpan di
smooth.dbdan dilanjutkan setelah restart. - Satu pesan setiap kali. Giliran diproses berurutan, jadi penyedia model tidak dibanjiri permintaan paralel.
- Progres langsung. Satu pesan menampilkan langkah-langkahnya (
$ git pull,read app.py,search …) dan hilang saat jawaban datang. - Izin. Di Telegram ada tombol ✅ Allow / ❌ Deny. Di channel dua arah lain, balas
yesatauno(bisa jugaya,oke,gas,gak,batal). Tidak dijawab berarti tidak. - File masuk, file keluar. Kirim foto, PDF, file Office, atau arsip; minta laporan dan ia mengirim balik
.docxatau.xlsxsungguhan. - Suara. Pesan suara ditranskrip (
[stt]); denganvoice_replies = "auto"pesan suara dibalas suara juga.
Perintah di chat
| Perintah | Fungsinya |
|---|---|
/new | Percakapan baru (yang lama tetap tersimpan dan bisa dicari) |
/status | Model, sesi, dan memori |
/model <nama> | Ganti model untuk chat ini |
/stop | Hentikan yang sedang dikerjakan agent |
/help | Bantuan |
Setup per channel
Telegram
- Buat bot lewat @BotFather dan salin token-nya ke
.envsebagaiTELEGRAM_BOT_TOKEN. - Jalankan daemon, kirim pesan sekali ke bot-mu, lalu masukkan ID yang ia balas ke
owners.
Tidak perlu port terbuka.
Meta WhatsApp Cloud API. Arahkan webhook ke https://<host-mu>/webhook/whatsapp dengan verify_token yang kamu pilih.
[channels.whatsapp]
token_env = "WHATSAPP_TOKEN"
phone_id = "123456789012345"
verify_token = "rahasia-pilihanmu"
owners = ["628123456789"]Slack
Buat Slack app, aktifkan Event Subscriptions ke https://<host-mu>/webhook/slack (message.im), lalu install ke workspace-mu.
[channels.slack]
token_env = "SLACK_BOT_TOKEN" # xoxb-…
signing_secret_env = "SLACK_SIGNING_SECRET"
owners = ["U0123ABCD"]Matrix
Bisa di homeserver apa saja. Undang bot ke sebuah room dan ia bergabung (hanya undangan dari owner).
[channels.matrix]
homeserver = "https://matrix.org"
token_env = "MATRIX_TOKEN"
owners = ["@kamu:matrix.org"]LINE
LINE Messaging API, webhook https://<host-mu>/webhook/line.
[channels.line]
token_env = "LINE_CHANNEL_TOKEN"
secret_env = "LINE_CHANNEL_SECRET"
owners = ["U1234567890abcdef"]WeChat Work dan Discord (alert)
Untuk mengirim hasil dan alert ke grup atau channel:
[channels.wechat]
webhook_url_env = "WECHAT_ROBOT_URL"
[channels.discord]
webhook_url_env = "DISCORD_WEBHOOK_URL"Terakhir diperbarui: