Channels

Channels क्या हैं?

Channels वे communication platforms हैं जिनका उपयोग आपके Neotask agents संदेश भेजने और प्राप्त करने के लिए करते हैं। Channel जोड़कर, आप किसी agent को उस platform पर आने वाले संदेशों के लिए सुनने और real time में respond करने की क्षमता देते हैं।

मुख्य अवधारणाएं:

• Per-agent configuration -- प्रत्येक channel connection agent level पर configured है। एक agent Slack से जुड़ा हो सकता है जबकि दूसरा Discord handle करता है, या एक ही agent एक साथ कई channels से जुड़ा हो सकता है।
• Bidirectional -- Channels संदेश भेजने और प्राप्त करने दोनों का समर्थन करते हैं। Agents आने वाले संदेशों का जवाब दे सकते हैं, outbound संदेश शुरू कर सकते हैं, या दोनों।
• Multi-account -- आप एक ही channel type के लिए कई accounts जोड़ सकते हैं (जैसे दो अलग Slack workspaces या कई email addresses)।

समर्थित Channels

Channel जोड़ना

Connection प्रक्रिया channel की authentication विधि के आधार पर भिन्न होती है।

OAuth Flow

उपयोग: Slack, Microsoft Teams, Google Chat, Email / Gmail

1. agent का Channels tab खोलें।
2. जोड़ने वाले channel के बगल में Connect click करें।
3. आपको service के authorization page पर redirect किया जाएगा।
4. अपने account से sign in करें और Neotask को अनुरोधित permissions दें।
5. authorization के बाद, आपको dashboard पर redirect किया जाता है और channel connected दिखाई देता है।

Mobile platforms के लिए, एक QR code option उपलब्ध है। अपने desktop browser पर sign in की आवश्यकता के बिना authorization पूर्ण करने के लिए अपने फ़ोन से QR code scan करें।

Bot Token

उपयोग: Discord, Telegram

1. संबंधित platform पर bot बनाएं:
   • Discord -- Discord Developer Portal पर application बनाएं और bot token generate करें।
   • Telegram -- Telegram पर @BotFather को message करके bot बनाएं और token प्राप्त करें।
2. agent का Channels tab खोलें और channel के बगल में Connect click करें।
3. bot token को token field में paste करें।
4. Connection establish करने के लिए Save click करें।

QR Code

उपयोग: WhatsApp

1. agent का Channels tab खोलें और WhatsApp के बगल में Connect click करें।
2. screen पर एक QR code दिखाई देगा।
3. अपने फ़ोन पर WhatsApp खोलें, Linked Devices पर जाएं, और QR code scan करें।
4. आपके फ़ोन द्वारा link की पुष्टि करने पर connection establish हो जाता है।

API Key

उपयोग: SMS

1. अपने SMS provider से API key प्राप्त करें (जैसे Twilio, Vonage)।
2. agent का Channels tab खोलें और SMS के बगल में Connect click करें।
3. अपनी API key और कोई भी अतिरिक्त आवश्यक fields (जैसे phone number, account SID) दर्ज करें।
4. Channel activate करने के लिए Save click करें।

Token

उपयोग: Matrix, Line, Zalo

1. संबंधित platform की developer settings या admin panel से access token generate करें।
2. agent का Channels tab खोलें और channel के बगल में Connect click करें।
3. token को token field में paste करें।
4. Connection establish करने के लिए Save click करें।

Server Configuration

उपयोग: IRC

1. agent का Channels tab खोलें और IRC के बगल में Connect click करें।
2. server address, port, nickname, और (वैकल्पिक रूप से) पासवर्ड दर्ज करें।
3. connect पर join करने वाले channels निर्दिष्ट करें।
4. Connect करने के लिए Save click करें।

Local Application

उपयोग: Signal, iMessage

1. सुनिश्चित करें कि required application host machine पर installed और running है:
   • Signal -- Signal Desktop installed होना चाहिए और आपके Signal account से linked होना चाहिए।
   • iMessage -- Messages.app configured के साथ macOS host आवश्यक है।
2. agent का Channels tab खोलें और channel के बगल में Connect click करें।
3. Neotask local application का पता लगाएगा और connection establish करेगा।
4. यदि application का पता नहीं चलता, तो आपसे इसे install या configure करने के लिए कहा जाएगा।

Connection Testing

किसी भी channel को connect करने के बाद, Neotask automatically connection verify करने के लिए latency probe चलाता है:

• Channel के API के माध्यम से एक test message भेजा और प्राप्त किया जाता है।
• Round-trip latency मापी और प्रदर्शित की जाती है।
• यदि test fail होता है, एक error message समस्या का वर्णन करता है (जैसे invalid token, expired OAuth grant, unreachable server)।

आप channel की settings से किसी भी समय connection test फिर से चला सकते हैं।

Channel Operations

एक बार channel connect होने के बाद, आप इसे agent के Channels tab से प्रबंधित कर सकते हैं।

Enable / Disable

बिना disconnect किए channel को on या off toggle करें। Disabled होने पर:

• Agent उस channel पर संदेशों के लिए सुनना बंद कर देता है।
• इसके माध्यम से कोई outbound संदेश नहीं भेजे जाते।
• Connection credentials preserved हैं ताकि आप बिना reconfiguration के किसी भी समय re-enable कर सकें।

Test Connectivity

यह verify करने के लिए on-demand connectivity test चलाएं कि channel reachable और responsive है। Test:

• Channel की service को एक lightweight API request भेजता है।
• Round-trip latency milliseconds में मापता है।
• परिणाम Connected (latency के साथ) या Failed (error details के साथ) के रूप में रिपोर्ट करता है।

Latency देखें

प्रत्येक connected channel Channels tab पर अपनी सबसे recent latency reading प्रदर्शित करता है। यह आपको एक नज़र में slow या degraded connections की पहचान करने में मदद करता है। Latency अपडेट होती है:

• प्रत्येक connection test के बाद automatically।
• Channel active रहते हुए background में periodically।

Disconnect / Logout

Channel connection को पूरी तरह remove करने के लिए:

1. Channel के बगल में Disconnect click करें।
2. dialog में action confirm करें।
3. Neotask stored credentials revoke या discard करता है (OAuth tokens को जहां supported है provider side पर revoke किया जाता है)।
4. Channel agent के active channels list से remove हो जाता है।

Disconnect के बाद reconnect करने के लिए, मूल connection steps फिर से follow करें।