Configuration des canaux

Vue d'ensemble

Les canaux (Channels) permettent de connecter l'Agent de l'espace de travail à des plateformes de messagerie instantanée externes. Les utilisateurs peuvent interagir directement avec l'Agent dans des outils de communication sociaux ou d'entreprise tels que Telegram, WhatsApp, DingTalk, etc.

La configuration des canaux s'effectue dans le composant IMSettings côté APP.

Page de configuration des canaux-CN

Canaux implémentés (14+ plateformes)

Messagerie instantanée mondiale

Canal	Caractéristiques	Prise en charge des groupes
Telegram	Prise en charge des groupes + messages privés, pièces jointes, surveillance Webhook	Oui
WhatsApp	Double fournisseur (EL + Meta), appairage par scan de QR code	—
Line	Messagerie instantanée pour la région Asie-Pacifique	—

Collaboration d'entreprise

Canal	Caractéristiques	Prise en charge des groupes
Teams	Intégration Microsoft Teams	Oui
Slack	Intégration de l'espace de travail Slack	Oui
Discord	Intégration de serveur communautaire	Oui
DingTalk	Application d'entreprise + Webhook	Oui

Plateformes sociales

Canal	Caractéristiques
Instagram	Plateforme sociale Meta
Facebook	Plateforme sociale Meta

Plateformes de service client

Canal	Caractéristiques
Intercom	Plateforme de communication client
LiveChat	Service client en ligne
LiveDesk	Système de tickets de service client

Automatisation et CRM

Canal	Caractéristiques
Zapier	Plateforme de workflows automatisés
Zoho SalesIQ	Service client CRM

Pour la liste complète des canaux et la matrice des capacités multimodales, veuillez consulter la Liste des canaux.

Processus d'intégration

Étapes générales

Configurer les identifiants : dans IMSettings, saisissez la clé API / le Token / l'URL Webhook requis par le canal
Vérification de la connectivité : le système exécute automatiquement le ConnectivityCheck
Résultat de la vérification :

Statut	Signification	Action
pass	Connexion normale	Peut être mis en ligne directement
warn	Certaines fonctionnalités sont limitées	Vérifiez la configuration
fail	Échec de la connexion	Vérifiez les identifiants et le réseau

Mise en ligne : activez le canal une fois la vérification réussie

Exemple de configuration Telegram

Créez un Bot Telegram dans BotFather et obtenez le Bot Token
Dans IMSettings, sélectionnez Telegram et collez le Token
Le système configure automatiquement le Webhook
Le canal est utilisable une fois la vérification de la connectivité réussie

Exemple de configuration WhatsApp

Dans IMSettings, sélectionnez WhatsApp
Le système génère un QR code (mode linked-device)
Scannez le QR code pour appairer depuis l'application mobile WhatsApp
Reconnexion automatique une fois l'appairage réussi

Prise en charge des messages multimodaux

Certains canaux prennent en charge l'envoi et la réception de messages multimodaux :

Capacité	Description
Réception d'images	Les images envoyées par l'utilisateur dans la messagerie instantanée sont transmises à l'Agent
Réception de fichiers	Les documents/fichiers envoyés par l'utilisateur sont transmis à l'Agent
Envoi de texte	Les réponses textuelles de l'Agent sont poussées vers la messagerie instantanée
Envoi d'images	Les images générées par l'Agent sont poussées vers la messagerie instantanée
Envoi de fichiers	Les fichiers générés par l'Agent sont poussés vers la messagerie instantanée

Pour connaître les différences spécifiques des capacités multimodales de chaque canal, veuillez consulter la Matrice des capacités multimodales des canaux.

Affichage des conversations

Les conversations provenant des canaux de messagerie instantanée affichent l'icône de la plateforme correspondante (par exemple l'icône Telegram, l'icône WeChat) dans la liste des sessions Work, ce qui aide l'utilisateur à distinguer la source des messages.

Guide de configuration détaillé

Étapes de configuration de Telegram

Dans Telegram, recherchez @BotFather et envoyez /newbot
Suivez les instructions pour définir le nom du Bot, et obtenez un Bot Token au format 123456:ABCdef...
Ouvrez l'APP → Paramètres → Canaux → sélectionnez Telegram
Collez le Bot Token dans le champ de configuration
Cliquez sur Enregistrer, le système configure automatiquement le Webhook
Le canal est utilisable une fois que la vérification de la connectivité affiche pass
Retrouvez votre Bot dans Telegram, envoyez un message, et l'Agent répondra automatiquement

Astuce : le Bot Telegram prend en charge deux modes : groupe et messages privés. Après avoir ajouté le Bot à un groupe, vous pouvez déclencher une réponse de l'Agent en le mentionnant avec @BotName.

Étapes de configuration de WhatsApp

Ouvrez l'APP → Paramètres → Canaux → sélectionnez WhatsApp
La page affiche un QR code (mode linked-device)
Ouvrez l'application mobile WhatsApp → Paramètres → Appareils connectés → Connecter un appareil
Scannez le QR code avec votre téléphone
Une fois l'appairage réussi, le système maintient automatiquement la connexion (reconnexion automatique en cas de coupure)

Remarque : le mode linked-device de WhatsApp nécessite que l'application WhatsApp sur le téléphone reste connectée. Si le téléphone se déconnecte, la connexion sera interrompue.

Étapes de configuration de DingTalk

Créez une application interne d'entreprise sur la plateforme ouverte DingTalk
Obtenez l'AppKey et l'AppSecret de l'application
Configurez l'URL Webhook de réception des messages (fournie par le système)
Ouvrez l'APP → Paramètres → Canaux → sélectionnez DingTalk
Renseignez l'AppKey, l'AppSecret et la configuration Webhook
Enregistrez et testez la connexion

Points d'attention concernant les messages des canaux

Point d'attention	Description
Latence des messages	Les messages des canaux doivent transiter par le chemin plateforme de messagerie instantanée → backend → Agent → backend → plateforme de messagerie instantanée, avec généralement une latence de 2 à 5 secondes
Limite de longueur du texte	Chaque plateforme a une limite de longueur de message différente (par exemple 4096 caractères pour Telegram) ; les réponses trop longues sont automatiquement segmentées et envoyées
Limites de format	Certains canaux ne prennent pas en charge le Markdown (comme WhatsApp) ; les réponses de l'Agent sont automatiquement rétrogradées en texte brut
Envoi de fichiers	Les canaux qui ne prennent pas en charge les fichiers téléversent le fichier vers le stockage cloud et envoient un lien de téléchargement
Contexte de conversation	La conversation de chaque utilisateur de canal constitue une session indépendante ; l'Agent mémorise l'historique des conversations d'un même utilisateur

Documents connexes

Liste des canaux et matrice des capacités — liste complète des canaux
Vue d'ensemble des conversations Work — affichage des messages de canaux dans Work