Kanalen

Wat zijn Kanalen?

Kanalen zijn de communicatieplatformen die uw Neotask-agents gebruiken om berichten te verzenden en te ontvangen. Door een kanaal te verbinden, geeft u een agent de mogelijkheid om te luisteren naar inkomende berichten op dat platform en in realtime te reageren.

Belangrijke concepten:

• Per-agent configuratie -- Elke kanaalverbinding wordt op agentniveau geconfigureerd. Een agent kan verbonden zijn met Slack terwijl een andere Discord afhandelt, of een enkele agent kan tegelijkertijd met meerdere kanalen verbonden zijn.
• Bidirectioneel -- Kanalen ondersteunen zowel het verzenden als ontvangen van berichten. Agents kunnen reageren op inkomende berichten, uitgaande berichten initieren, of beide.
• Multi-account -- U kunt meerdere accounts verbinden voor hetzelfde kanaaltype (bijv. twee verschillende Slack-werkruimten of meerdere e-mailadressen).

Ondersteunde Kanalen

Een Kanaal Verbinden

Het verbindingsproces varieert afhankelijk van de authenticatiemethode van het kanaal.

OAuth-stroom

Gebruikt door: Slack, Microsoft Teams, Google Chat, Email / Gmail

1. Open het tabblad Kanalen van de agent.
2. Klik op Verbinden naast het kanaal dat u wilt toevoegen.
3. U wordt doorgestuurd naar de autorisatiepagina van de dienst.
4. Log in met uw account en verleen Neotask de gevraagde machtigingen.
5. Na autorisatie wordt u teruggeleid naar het dashboard en verschijnt het kanaal als verbonden.

Voor mobiele platformen is een QR-code optie beschikbaar. Scan de QR-code vanaf uw telefoon om de autorisatie te voltooien zonder dat u hoeft in te loggen op uw desktopbrowser.

Bot-token

Gebruikt door: Discord, Telegram

1. Maak een bot aan op het betreffende platform:
   • Discord -- Maak een applicatie aan op het Discord Developer Portal en genereer een bot-token.
   • Telegram -- Stuur een bericht naar @BotFather op Telegram om een bot aan te maken en een token te ontvangen.
2. Open het tabblad Kanalen van de agent en klik op Verbinden naast het kanaal.
3. Plak het bot-token in het tokenveld.
4. Klik op Opslaan om de verbinding tot stand te brengen.

QR-code

Gebruikt door: WhatsApp

1. Open het tabblad Kanalen van de agent en klik op Verbinden naast WhatsApp.
2. Er verschijnt een QR-code op het scherm.
3. Open WhatsApp op uw telefoon, ga naar Gekoppelde Apparaten en scan de QR-code.
4. De verbinding wordt tot stand gebracht zodra uw telefoon de koppeling bevestigt.

API-sleutel

Gebruikt door: SMS

1. Verkrijg een API-sleutel van uw SMS-provider (bijv. Twilio, Vonage).
2. Open het tabblad Kanalen van de agent en klik op Verbinden naast SMS.
3. Voer uw API-sleutel en eventuele aanvullende vereiste velden in (bijv. telefoonnummer, account-SID).
4. Klik op Opslaan om het kanaal te activeren.

Token

Gebruikt door: Matrix, Line, Zalo

1. Genereer een toegangstoken vanuit de ontwikkelaarsinstellingen of het beheerderspaneel van het betreffende platform.
2. Open het tabblad Kanalen van de agent en klik op Verbinden naast het kanaal.
3. Plak het token in het tokenveld.
4. Klik op Opslaan om de verbinding tot stand te brengen.

Serverconfiguratie

Gebruikt door: IRC

1. Open het tabblad Kanalen van de agent en klik op Verbinden naast IRC.
2. Voer het serveradres, de poort, de bijnaam en (optioneel) een wachtwoord in.
3. Geef de kanalen op om bij het verbinden deel te nemen.
4. Klik op Opslaan om te verbinden.

Lokale Applicatie

Gebruikt door: Signal, iMessage

1. Zorg ervoor dat de vereiste applicatie is geinstalleerd en draait op de hostmachine:
   • Signal -- Signal Desktop moet geinstalleerd en gekoppeld zijn aan uw Signal-account.
   • iMessage -- Vereist een macOS-host met Messages.app geconfigureerd.
2. Open het tabblad Kanalen van de agent en klik op Verbinden naast het kanaal.
3. Neotask detecteert de lokale applicatie en brengt een verbinding tot stand.
4. Als de applicatie niet wordt gedetecteerd, wordt u gevraagd deze te installeren of te configureren.

Verbindingstest

Na het verbinden van een kanaal voert Neotask automatisch een latentietest uit om de verbinding te verifieren:

• Er wordt een testbericht verzonden en ontvangen via de API van het kanaal.
• De round-triplatentie wordt gemeten en weergegeven.
• Als de test mislukt, beschrijft een foutmelding het probleem (bijv. ongeldig token, verlopen OAuth-toekenning, onbereikbare server).

U kunt de verbindingstest op elk moment opnieuw uitvoeren vanuit de instellingen van het kanaal.

Kanaalbewerkingen

Zodra een kanaal is verbonden, kunt u het beheren vanuit het tabblad Kanalen van de agent.

In-/Uitschakelen

Schakel een kanaal aan of uit zonder het te ontkoppelen. Wanneer uitgeschakeld:

• De agent stopt met luisteren naar berichten op dat kanaal.
• Er worden geen uitgaande berichten via het kanaal verzonden.
• De verbindingsinloggegevens blijven bewaard zodat u op elk moment opnieuw kunt inschakelen zonder opnieuw te configureren.

Connectiviteit Testen

Voer een on-demand connectiviteitstest uit om te verifieren dat het kanaal bereikbaar en responsief is. De test:

• Stuurt een lichtgewicht API-verzoek naar de dienst van het kanaal.
• Meet de round-triplatentie in milliseconden.
• Rapporteert het resultaat als Verbonden (met latentie) of Mislukt (met foutdetails).

Latentie Bekijken

Elk verbonden kanaal toont zijn meest recente latentiemeting op het tabblad Kanalen. Dit helpt u trage of verslechterde verbindingen in een oogopslag te identificeren. Latentie wordt bijgewerkt:

• Automatisch na elke verbindingstest.
• Periodiek op de achtergrond terwijl het kanaal actief is.

Ontkoppelen / Uitloggen

Om een kanaalverbinding volledig te verwijderen:

1. Klik op Ontkoppelen naast het kanaal.
2. Bevestig de actie in het dialoogvenster.
3. Neotask trekt de opgeslagen inloggegevens in of verwijdert ze (OAuth-tokens worden ingetrokken aan de providerzijde waar ondersteund).
4. Het kanaal wordt verwijderd uit de lijst met actieve kanalen van de agent.

Om na het ontkoppelen opnieuw te verbinden, volgt u de oorspronkelijke verbindingsstappen opnieuw.