ช่องทาง

ช่องทางคืออะไร?

ช่องทางคือแพลตฟอร์มการสื่อสารที่เอเจนต์ Neotask ของคุณใช้ส่งและรับข้อความ โดยการเชื่อมต่อช่องทาง คุณให้เอเจนต์สามารถรับฟังข้อความที่เข้ามาบนแพลตฟอร์มนั้นและตอบสนองแบบ real-time

แนวคิดสำคัญ:

การกำหนดค่าต่อเอเจนต์ -- การเชื่อมต่อช่องทางแต่ละอันกำหนดค่าที่ระดับเอเจนต์ เอเจนต์หนึ่งสามารถเชื่อมต่อกับ Slack ในขณะที่อีกตัวจัดการ Discord หรือเอเจนต์เดียวสามารถเชื่อมต่อกับหลายช่องทางพร้อมกัน
สองทิศทาง -- ช่องทางรองรับทั้งการส่งและรับข้อความ เอเจนต์สามารถตอบสนองต่อข้อความที่เข้ามา, เริ่มข้อความขาออก หรือทั้งสองอย่าง
หลายบัญชี -- คุณสามารถเชื่อมต่อหลายบัญชีสำหรับประเภทช่องทางเดียวกัน (เช่น Slack workspace สองแห่งที่ต่างกันหรืออีเมลหลายที่อยู่)

ช่องทางที่รองรับ

ช่องทาง	วิธี Auth	คุณสมบัติ
Slack	OAuth	การส่งข้อความเต็มรูปแบบ, ช่องทาง, threads, reactions, การอัพโหลดไฟล์
Discord	Bot token	การส่งข้อความ server, ช่องทาง, DM, embeds, reactions
WhatsApp	QR code	ข้อความข้อความ, ข้อความสื่อ, group chats
Telegram	Bot token	ข้อความข้อความ, กลุ่ม, ช่องทาง, inline keyboards, การแชร์ไฟล์
Signal	แอปในเครื่อง	การส่งข้อความแบบ end-to-end encrypted, group chats
Microsoft Teams	OAuth	Teams, ช่องทาง, chats, adaptive cards, การแชร์ไฟล์
Google Chat	OAuth	Spaces, ข้อความตรง, cards, การสนทนาแบบ thread
SMS	API key	การส่งข้อความข้อความขาออกและขาเข้าผ่าน provider ที่รองรับ
Email / Gmail	OAuth	ส่ง, รับ, ร่าง, ตอบกลับ, ไฟล์แนบ, การจัดการ label
Matrix	Token	การส่งข้อความแบบ federated, rooms, end-to-end encryption
Line	Token	ข้อความข้อความ, stickers, group chats, rich menus
Zalo	Token	ข้อความข้อความ, การแชร์สื่อ
IRC	Config	การเชื่อมต่อ server, ช่องทาง, ข้อความส่วนตัว
iMessage	ในเครื่อง	การส่งข้อความ native บน macOS (ต้องใช้ macOS host)

การเชื่อมต่อช่องทาง

กระบวนการเชื่อมต่อจะแตกต่างกันขึ้นอยู่กับวิธีการยืนยันตัวตนของช่องทาง

OAuth Flow

ใช้โดย: Slack, Microsoft Teams, Google Chat, Email / Gmail

เปิดแท็บ Channels ของเอเจนต์
คลิก Connect ถัดจากช่องทางที่ต้องการเพิ่ม
คุณจะถูกเปลี่ยนเส้นทางไปยังหน้าการอนุญาตของบริการ
ลงชื่อเข้าใช้บัญชีของคุณและอนุญาตให้ Neotask ขอสิทธิ์ที่ร้องขอ
หลังการอนุญาต คุณจะถูกเปลี่ยนเส้นทางกลับไปยังแดชบอร์ดและช่องทางจะปรากฏเป็นเชื่อมต่อ

สำหรับแพลตฟอร์มมือถือ มีตัวเลือก QR code ให้ใช้ สแกน QR code จากโทรศัพท์เพื่อทำการอนุญาตให้เสร็จสมบูรณ์โดยไม่ต้องลงชื่อเข้าใช้บนเบราว์เซอร์เดสก์ท็อปของคุณ

Bot Token

ใช้โดย: Discord, Telegram

สร้าง bot บนแพลตฟอร์มที่เกี่ยวข้อง:
- Discord -- สร้าง application ที่ Discord Developer Portal และสร้าง bot token
- Telegram -- ส่งข้อความให้ @BotFather บน Telegram เพื่อสร้าง bot และรับ token
เปิดแท็บ Channels ของเอเจนต์และคลิก Connect ถัดจากช่องทาง
วาง bot token ในช่อง token
คลิก Save เพื่อสร้างการเชื่อมต่อ

QR Code

ใช้โดย: WhatsApp

เปิดแท็บ Channels ของเอเจนต์และคลิก Connect ถัดจาก WhatsApp
QR code จะปรากฏบนหน้าจอ
เปิด WhatsApp บนโทรศัพท์ของคุณ ไปที่ Linked Devices และสแกน QR code
การเชื่อมต่อจะสร้างขึ้นเมื่อโทรศัพท์ยืนยันลิงก์

API Key

ใช้โดย: SMS

รับ API key จาก SMS provider ของคุณ (เช่น Twilio, Vonage)
เปิดแท็บ Channels ของเอเจนต์และคลิก Connect ถัดจาก SMS
ป้อน API key และช่องที่จำเป็นเพิ่มเติม (เช่น หมายเลขโทรศัพท์, account SID)
คลิก Save เพื่อเปิดใช้งานช่องทาง

Token

ใช้โดย: Matrix, Line, Zalo

สร้าง access token จากการตั้งค่านักพัฒนาหรือแผงการจัดการของแพลตฟอร์มที่เกี่ยวข้อง
เปิดแท็บ Channels ของเอเจนต์และคลิก Connect ถัดจากช่องทาง
วาง token ในช่อง token
คลิก Save เพื่อสร้างการเชื่อมต่อ

การกำหนดค่า Server

ใช้โดย: IRC

เปิดแท็บ Channels ของเอเจนต์และคลิก Connect ถัดจาก IRC
ป้อนที่อยู่ server, port, nickname และ (ทางเลือก) รหัสผ่าน
ระบุช่องทางที่จะเข้าร่วมเมื่อเชื่อมต่อ
คลิก Save เพื่อเชื่อมต่อ

แอปพลิเคชันในเครื่อง

ใช้โดย: Signal, iMessage

ตรวจสอบให้แน่ใจว่าแอปพลิเคชันที่จำเป็นได้รับการติดตั้งและกำลังทำงานบน host machine:
- Signal -- Signal Desktop ต้องได้รับการติดตั้งและเชื่อมต่อกับบัญชี Signal ของคุณ
- iMessage -- ต้องใช้ macOS host ที่กำหนดค่า Messages.app
เปิดแท็บ Channels ของเอเจนต์และคลิก Connect ถัดจากช่องทาง
Neotask จะตรวจจับแอปพลิเคชันในเครื่องและสร้างการเชื่อมต่อ
หากไม่ตรวจพบแอปพลิเคชัน คุณจะได้รับแจ้งให้ติดตั้งหรือกำหนดค่า

การทดสอบการเชื่อมต่อ

หลังจากเชื่อมต่อช่องทางใดก็ตาม Neotask จะรัน latency probe โดยอัตโนมัติเพื่อยืนยันการเชื่อมต่อ:

ข้อความทดสอบจะถูกส่งและรับผ่าน API ของช่องทาง
วัด round-trip latency และแสดงผล
หากการทดสอบล้มเหลว ข้อความแสดงข้อผิดพลาดจะอธิบายปัญหา (เช่น token ไม่ถูกต้อง, OAuth grant หมดอายุ, server ไม่สามารถเข้าถึงได้)

คุณสามารถรันการทดสอบการเชื่อมต่อใหม่ได้ตลอดเวลาจากการตั้งค่าช่องทาง

การดำเนินการช่องทาง

เมื่อเชื่อมต่อช่องทางแล้ว คุณสามารถจัดการได้จากแท็บ Channels ของเอเจนต์

เปิด / ปิดใช้งาน

สลับช่องทางเปิดหรือปิดโดยไม่ต้องตัดการเชื่อมต่อ เมื่อปิดใช้งาน:

เอเจนต์หยุดรับฟังข้อความบนช่องทางนั้น
ไม่มีการส่งข้อความขาออกผ่านช่องทางนั้น
ข้อมูลรับรองการเชื่อมต่อยังคงถูกเก็บไว้เพื่อให้คุณสามารถเปิดใช้งานใหม่ได้ตลอดเวลาโดยไม่ต้องกำหนดค่าใหม่

ทดสอบการเชื่อมต่อ

รันการทดสอบการเชื่อมต่อตามต้องการเพื่อยืนยันว่าช่องทางสามารถเข้าถึงได้และตอบสนอง การทดสอบ:

ส่งการร้องขอ API น้ำหนักเบาไปยังบริการของช่องทาง
วัด round-trip latency เป็นมิลลิวินาที
รายงานผลลัพธ์เป็น เชื่อมต่อ (พร้อม latency) หรือ ล้มเหลว (พร้อมรายละเอียดข้อผิดพลาด)

ดู Latency

ช่องทางที่เชื่อมต่อแต่ละอันแสดงการอ่าน latency ล่าสุดบนแท็บ Channels ซึ่งช่วยให้คุณระบุการเชื่อมต่อที่ช้าหรือเสื่อมประสิทธิภาพได้ทันที Latency จะอัพเดต:

โดยอัตโนมัติหลังการทดสอบการเชื่อมต่อแต่ละครั้ง
เป็นระยะในพื้นหลังในขณะที่ช่องทางทำงานอยู่

ตัดการเชื่อมต่อ / ออกจากระบบ

เพื่อลบการเชื่อมต่อช่องทางอย่างสมบูรณ์:

คลิก Disconnect ถัดจากช่องทาง
ยืนยันการดำเนินการในกล่องโต้ตอบ
Neotask เพิกถอนหรือทิ้งข้อมูลรับรองที่จัดเก็บ (OAuth token จะถูกเพิกถอนทาง provider ที่รองรับ)
ช่องทางจะถูกลบออกจากรายการช่องทางที่ใช้งานของเอเจนต์

เพื่อเชื่อมต่อใหม่หลังจากตัดการเชื่อมต่อ ให้ทำตามขั้นตอนการเชื่อมต่อเดิม