Canaux

Que sont les canaux ?

Les canaux sont les plateformes de communication que vos agents Neotask utilisent pour envoyer et recevoir des messages. En connectant un canal, vous donnez a un agent la capacite d'ecouter les messages entrants sur cette plateforme et de repondre en temps reel.

Concepts cles :

• Configuration par agent -- Chaque connexion de canal est configuree au niveau de l'agent. Un agent peut etre connecte a Slack tandis qu'un autre gere Discord, ou un seul agent peut etre connecte a plusieurs canaux simultanement.
• Bidirectionnel -- Les canaux prennent en charge l'envoi et la reception de messages. Les agents peuvent repondre aux messages entrants, initier des messages sortants, ou les deux.
• Multi-compte -- Vous pouvez connecter plusieurs comptes pour le meme type de canal (par ex., deux espaces de travail Slack differents ou plusieurs adresses email).

Canaux supportes

Connecter un canal

Le processus de connexion varie selon la methode d'authentification du canal.

Flux OAuth

Utilise par : Slack, Microsoft Teams, Google Chat, Email / Gmail

1. Ouvrez l'onglet Canaux de l'agent.
2. Cliquez sur Connecter a cote du canal que vous souhaitez ajouter.
3. Vous serez redirige vers la page d'autorisation du service.
4. Connectez-vous avec votre compte et accordez a Neotask les permissions demandees.
5. Apres l'autorisation, vous etes redirige vers le tableau de bord et le canal apparait comme connecte.

Pour les plateformes mobiles, une option de code QR est disponible. Scannez le code QR depuis votre telephone pour completer l'autorisation sans avoir besoin de vous connecter sur votre navigateur de bureau.

Token bot

Utilise par : Discord, Telegram

1. Creez un bot sur la plateforme respective :
   • Discord -- Creez une application sur le Discord Developer Portal et generez un token bot.
   • Telegram -- Envoyez un message a @BotFather sur Telegram pour creer un bot et recevoir un token.
2. Ouvrez l'onglet Canaux de l'agent et cliquez sur Connecter a cote du canal.
3. Collez le token bot dans le champ de token.
4. Cliquez sur Enregistrer pour etablir la connexion.

Code QR

Utilise par : WhatsApp

1. Ouvrez l'onglet Canaux de l'agent et cliquez sur Connecter a cote de WhatsApp.
2. Un code QR apparaitra a l'ecran.
3. Ouvrez WhatsApp sur votre telephone, allez dans Appareils lies et scannez le code QR.
4. La connexion est etablie une fois que votre telephone confirme le lien.

Cle API

Utilise par : SMS

1. Obtenez une cle API de votre fournisseur SMS (par ex., Twilio, Vonage).
2. Ouvrez l'onglet Canaux de l'agent et cliquez sur Connecter a cote de SMS.
3. Entrez votre cle API et tous les champs supplementaires requis (par ex., numero de telephone, account SID).
4. Cliquez sur Enregistrer pour activer le canal.

Token

Utilise par : Matrix, Line, Zalo

1. Generez un token d'acces depuis les parametres developpeur ou le panneau d'administration de la plateforme respective.
2. Ouvrez l'onglet Canaux de l'agent et cliquez sur Connecter a cote du canal.
3. Collez le token dans le champ de token.
4. Cliquez sur Enregistrer pour etablir la connexion.

Configuration serveur

Utilise par : IRC

1. Ouvrez l'onglet Canaux de l'agent et cliquez sur Connecter a cote d'IRC.
2. Entrez l'adresse du serveur, le port, le pseudonyme et (optionnellement) un mot de passe.
3. Specifiez les canaux a rejoindre a la connexion.
4. Cliquez sur Enregistrer pour se connecter.

Application locale

Utilise par : Signal, iMessage

1. Assurez-vous que l'application requise est installee et en cours d'execution sur la machine hote :
   • Signal -- Signal Desktop doit etre installe et lie a votre compte Signal.
   • iMessage -- Necessite un hote macOS avec Messages.app configure.
2. Ouvrez l'onglet Canaux de l'agent et cliquez sur Connecter a cote du canal.
3. Neotask detectera l'application locale et etablira une connexion.
4. Si l'application n'est pas detectee, vous serez invite a l'installer ou la configurer.

Test de connexion

Apres la connexion de tout canal, Neotask execute automatiquement une sonde de latence pour verifier la connexion :

• Un message de test est envoye et recu via l'API du canal.
• La latence aller-retour est mesuree et affichee.
• Si le test echoue, un message d'erreur decrit le probleme (par ex., token invalide, autorisation OAuth expiree, serveur injoignable).

Vous pouvez relancer le test de connexion a tout moment depuis les parametres du canal.

Operations sur les canaux

Une fois un canal connecte, vous pouvez le gerer depuis l'onglet Canaux de l'agent.

Activer / Desactiver

Basculez un canal on ou off sans le deconnecter. Lorsqu'il est desactive :

• L'agent arrete d'ecouter les messages sur ce canal.
• Aucun message sortant n'est envoye a travers celui-ci.
• Les identifiants de connexion sont preserves pour que vous puissiez reactiver a tout moment sans reconfigurer.

Tester la connectivite

Executez un test de connectivite a la demande pour verifier que le canal est joignable et reactif. Le test :

• Envoie une requete API legere au service du canal.
• Mesure la latence aller-retour en millisecondes.
• Rapporte le resultat comme Connecte (avec latence) ou Echoue (avec details de l'erreur).

Voir la latence

Chaque canal connecte affiche sa lecture de latence la plus recente dans l'onglet Canaux. Cela vous aide a identifier les connexions lentes ou degradees d'un coup d'oeil. La latence est mise a jour :

• Automatiquement apres chaque test de connexion.
• Periodiquement en arriere-plan pendant que le canal est actif.

Deconnecter / Deconnexion

Pour supprimer completement une connexion de canal :

1. Cliquez sur Deconnecter a cote du canal.
2. Confirmez l'action dans la boite de dialogue.
3. Neotask revoque ou supprime les identifiants stockes (les tokens OAuth sont revoques cote fournisseur lorsque c'est supporte).
4. Le canal est retire de la liste des canaux actifs de l'agent.

Pour reconnecter apres la deconnexion, suivez a nouveau les etapes de connexion originales.