Kanały

Czym są kanały?

Kanały to platformy komunikacyjne, z których korzystają agenci Neotask do wysyłania i odbierania wiadomości. Podłączając kanał, dajesz agentowi możliwość nasłuchiwania przychodzących wiadomości na tej platformie i odpowiadania w czasie rzeczywistym.

Kluczowe pojęcia:

• Konfiguracja per agent -- Każde połączenie kanału jest konfigurowane na poziomie agenta. Jeden agent może być podłączony do Slacka, podczas gdy inny obsługuje Discorda, lub jeden agent może być podłączony do wielu kanałów jednocześnie.
• Dwukierunkowe -- Kanały obsługują zarówno wysyłanie, jak i odbieranie wiadomości. Agenci mogą odpowiadać na przychodzące wiadomości, inicjować wiadomości wychodzące lub robić jedno i drugie.
• Wiele kont -- Możesz podłączyć wiele kont dla tego samego typu kanału (np. dwa różne obszary robocze Slack lub kilka adresów e-mail).

Obsługiwane kanały

Podłączanie kanału

Proces połączenia różni się w zależności od metody uwierzytelniania kanału.

Przepływ OAuth

Używany przez: Slack, Microsoft Teams, Google Chat, E-mail / Gmail

1. Otwórz kartę Kanały agenta.
2. Kliknij Połącz obok kanału, który chcesz dodać.
3. Zostaniesz przekierowany na stronę autoryzacji usługi.
4. Zaloguj się na swoje konto i przyznaj Neotask żądane uprawnienia.
5. Po autoryzacji zostaniesz przekierowany z powrotem do panelu sterowania, a kanał pojawi się jako podłączony.

Dla platform mobilnych dostępna jest opcja kodu QR. Zeskanuj kod QR swoim telefonem, aby dokończyć autoryzację bez konieczności logowania się w przeglądarce desktopowej.

Token bota

Używany przez: Discord, Telegram

1. Utwórz bota na odpowiedniej platformie:
   • Discord -- Utwórz aplikację w Discord Developer Portal i wygeneruj token bota.
   • Telegram -- Wyślij wiadomość do @BotFather na Telegramie, aby utworzyć bota i otrzymać token.
2. Otwórz kartę Kanały agenta i kliknij Połącz obok kanału.
3. Wklej token bota w pole tokenu.
4. Kliknij Zapisz, aby ustanowić połączenie.

Kod QR

Używany przez: WhatsApp

1. Otwórz kartę Kanały agenta i kliknij Połącz obok WhatsApp.
2. Na ekranie pojawi się kod QR.
3. Otwórz WhatsApp na swoim telefonie, przejdź do Połączone urządzenia i zeskanuj kod QR.
4. Połączenie zostaje ustanowione po potwierdzeniu połączenia przez telefon.

Klucz API

Używany przez: SMS

1. Uzyskaj klucz API od swojego dostawcy SMS (np. Twilio, Vonage).
2. Otwórz kartę Kanały agenta i kliknij Połącz obok SMS.
3. Wprowadź klucz API i wszelkie dodatkowe wymagane pola (np. numer telefonu, SID konta).
4. Kliknij Zapisz, aby aktywować kanał.

Token

Używany przez: Matrix, Line, Zalo

1. Wygeneruj token dostępu z ustawień programisty lub panelu administracyjnego odpowiedniej platformy.
2. Otwórz kartę Kanały agenta i kliknij Połącz obok kanału.
3. Wklej token w pole tokenu.
4. Kliknij Zapisz, aby ustanowić połączenie.

Konfiguracja serwera

Używany przez: IRC

1. Otwórz kartę Kanały agenta i kliknij Połącz obok IRC.
2. Wprowadź adres serwera, port, pseudonim i opcjonalnie hasło.
3. Podaj kanały, do których dołączyć po połączeniu.
4. Kliknij Zapisz, aby się połączyć.

Aplikacja lokalna

Używany przez: Signal, iMessage

1. Upewnij się, że wymagana aplikacja jest zainstalowana i uruchomiona na maszynie hosta:
   • Signal -- Signal Desktop musi być zainstalowany i połączony z Twoim kontem Signal.
   • iMessage -- Wymaga hosta macOS ze skonfigurowaną aplikacją Messages.app.
2. Otwórz kartę Kanały agenta i kliknij Połącz obok kanału.
3. Neotask wykryje lokalną aplikację i ustanowi połączenie.
4. Jeśli aplikacja nie zostanie wykryta, zostaniesz poproszony o jej zainstalowanie lub skonfigurowanie.

Testowanie połączenia

Po podłączeniu dowolnego kanału Neotask automatycznie uruchamia sondę opóźnienia, aby zweryfikować połączenie:

• Wiadomość testowa jest wysyłana i odbierana przez API kanału.
• Mierzone i wyświetlane jest opóźnienie w obie strony.
• Jeśli test się nie powiedzie, komunikat o błędzie opisuje problem (np. nieprawidłowy token, wygasłe uprawnienie OAuth, nieosiągalny serwer).

Test połączenia możesz uruchomić ponownie w dowolnym momencie z ustawień kanału.

Operacje na kanałach

Po podłączeniu kanału możesz nim zarządzać z karty Kanały agenta.

Włączanie / wyłączanie

Przełączaj kanał bez rozłączania go. Po wyłączeniu:

• Agent przestaje nasłuchiwać wiadomości na tym kanale.
• Żadne wiadomości wychodzące nie są przez niego wysyłane.
• Poświadczenia połączenia są zachowane, więc możesz je ponownie włączyć w dowolnym momencie bez ponownej konfiguracji.

Testowanie łączności

Uruchom test łączności na żądanie, aby sprawdzić, czy kanał jest osiągalny i responsywny. Test:

• Wysyła lekkie żądanie API do usługi kanału.
• Mierzy opóźnienie w milisekundach.
• Raportuje wynik jako Połączony (z opóźnieniem) lub Błąd (ze szczegółami błędu).

Wyświetlanie opóźnienia

Każdy podłączony kanał wyświetla swój ostatni pomiar opóźnienia na karcie Kanały. Pomaga to szybko identyfikować wolne lub zdegradowane połączenia. Opóźnienie jest aktualizowane:

• Automatycznie po każdym teście połączenia.
• Okresowo w tle, gdy kanał jest aktywny.

Rozłączanie / wylogowywanie

Aby całkowicie usunąć połączenie kanału:

1. Kliknij Rozłącz obok kanału.
2. Potwierdź operację w oknie dialogowym.
3. Neotask odwołuje lub usuwa przechowywane poświadczenia (tokeny OAuth są odwoływane po stronie dostawcy tam, gdzie jest to obsługiwane).
4. Kanał jest usuwany z listy aktywnych kanałów agenta.

Aby ponownie się połączyć po rozłączeniu, wykonaj ponownie pierwotne kroki połączenia.