Les canaux de communication

Un canal est la façon dont les humains parlent à ton Worker — et dont il répond. Slack, Teams, Telegram, SMS, WhatsApp, e-mail ou la messagerie interne (Ping). Cet article explique chaque canal, comment le brancher, et ce qu'il faut préparer en amont (c'est souvent là que ça coince).

Canal ≠ intégration. Un canal est le transport : par où les messages arrivent et repartent. Une intégration est une capacité : ce que le Worker sait faire dans un service tiers. Slack peut être les deux — un canal pour lui parler, et une intégration pour qu'il agisse dans ton espace Slack.

1. Où ça se passe

  • Ouvre la fiche du Worker → onglet Profile
  • Tu vois une grille tout en bas intitulée canaux préférés ; tu en choisis un ou plusieurs et tu les configures.
Onglet Communication, grille des cartes de canaux (Ping, Slack, Teams, Telegram, SMS, Mail)

2. Les canaux, un par un

Ping — messagerie interne Delos

  • Toujours disponible, aucune configuration.
  • Le moyen le plus simple de discuter avec ton Worker directement dans Delos.

Slack

  • Clique sur la carte Slack → Connecter Slack (flux OAuth).
  • Selon ta configuration, le Worker utilise l'app Slack partagée de l'organisation ou une app dédiée.
  • Une fois connecté : pastille verte + « Connecté ».
  • À préparer : l'organisation doit avoir une intégration Slack configurée (ou créer une app dédiée).

Microsoft Teams

Deux chemins, à choisir selon tes droits Microsoft :

  1. Accès complet (recommandé) : nécessite le consentement d'un admin Microsoft. Donne accès aux fonctions avancées (annuaire, messages proactifs).
  2. Sideload (sans admin) : tu télécharges le paquet d'app Teams (.zip) et tu l'installes manuellement, puis tu lies le Worker en envoyant link <CODE> dans Teams. Fonctions limitées (bot seul).
Modal Teams avec les deux options (Accès complet / Sideload) et le bouton de téléchargement du manifeste

⚠️ Un seul Worker par organisation Teams : connecter un nouveau Worker déconnecte le précédent.

Telegram

  • Clique sur la carte Telegram → colle le token de bot fourni par @BotFather.
  • Création du bot : sur Telegram, écris à @BotFather, commande /newbot, récupère le token (ex : 123456789:AAE…).
  • Delos valide le token et installe le webhook automatiquement.
  • Un bot par Worker (un même bot ne peut pas servir plusieurs Workers).

⚠️ Règle Telegram : un bot ne peut pas démarrer une conversation. L'utilisateur doit envoyer /start au bot en premier. → un guide détaillé existe : Connecter ton Worker à Telegram.

SMS

  • Disponible uniquement si le Worker a un numéro de téléphone attribué (via Twilio) et que la capacité téléphone est activée.
  • Aucune config manuelle une fois le numéro provisionné.

WhatsApp

  • S'appuie sur le numéro de téléphone (Twilio), qui doit être enregistré comme expéditeur WhatsApp (vérification par code OTP).
  • Se configure côté téléphone/admin, pas comme une simple carte de canal.

E-mail / Mail

  • Disponible si une adresse e-mail est attribuée au Worker.
  • Deux options : une boîte Delos (sous-domaine réservé de l'organisation) ou une boîte externe connectée en OAuth (Google / Microsoft).
Carte de canal à l'état connecté (ex : Telegram affichant @bot_username)

3. Comment le Worker reçoit et répond

  • Entrant : le service (Slack, Teams, Telegram, Twilio, mail) envoie le message à Delos via un webhook. Le message est enregistré et déclenche le Worker.
  • Sortant : le Worker rédige sa réponse et la renvoie par le même canal (pas d'étape séparée).
  • Proactif : selon le canal et les permissions, le Worker peut aussi initier un message (sauf restrictions, ex : Telegram qui exige un /start préalable).

4. Tableau récapitulatif des prérequis

Canal À préparer avant que ça marche
Ping Rien — toujours actif
Slack Intégration Slack de l'organisation, ou app dédiée
Teams Consentement admin Microsoft (complet) ou installation manuelle du paquet (sideload)
Telegram Créer un bot via @BotFather et coller son token
SMS Un numéro Twilio attribué au Worker
WhatsApp Numéro Twilio + enregistrement expéditeur WhatsApp (OTP)
Mail Boîte Delos (sous-domaine) ou boîte externe connectée (OAuth)

5. Les pièges classiques

  1. Aucun canal sélectionné → le Worker ne reçoit rien. Coche au moins un canal (idéalement dès la création).
  2. Teams sans consentement admin → tu restes en mode « fonctions limitées ». Pour le proactif et l'annuaire, il faut l'accord de l'admin Microsoft.
  3. Telegram silencieux → l'utilisateur n'a pas fait /start, ou le mauvais token a été collé.
  4. SMS/WhatsApp grisés → aucun numéro n'est attribué au Worker (à faire dans la partie téléphone).
  5. Mail qui ne part pas → l'expéditeur n'est pas vérifié (sous-domaine Delos non réservé, ou boîte externe non connectée).

À retenir : choisis le canal là où tes utilisateurs sont déjà. Ping pour tester en interne, Slack/Teams pour l'équipe, Telegram/WhatsApp/SMS/Mail pour l'externe.