Coroid dispose de bots pour les plateformes Slack, Discord, Telegram et SMS. Configurez-les dans cette section : Paramètres → Connexions → Canaux.
Ce que chacun d'eux permet aujourd'hui :
| Plateforme | Les messages deviennent des demandes | Reçoit les mises à jour |
|---|---|---|
| Slack | Oui, grâce à une automatisation d'événements | Mises à jour des tâches, via un webhook entrant |
| Telegram | Oui, grâce à une automatisation d'événements | Non |
| Discord | Non | Non |
| SMS | Non | Non |
Vous pouvez enregistrer un bot Discord ou SMS, mais aucun n'est utilisé pour le moment. La même page contient également des ponts de canaux qui ne fonctionnent pas encore. Consultez Ponts de canal.
Robots de plateforme
Le bot est l'identité que Coroid utilise sur la plateforme. Installez-le une fois par espace de travail ou serveur et accordez-lui l'accès aux canaux qu'il doit lire. Les bots Slack et Telegram sont nécessaires pour que l'automatisation d'événements puisse lire les messages.
Si un bot Slack est retiré d'un canal, Coroid ne pourra plus lire ce canal, sans aucune notification. Si les messages Slack cessent de se transformer en demandes, vérifiez que le bot est toujours présent dans le canal.
Seuls les propriétaires et administrateurs peuvent ajouter, modifier ou supprimer un bot. Chaque plateforme envoie ses événements vers une URL de webhook sur le passerelle API, que Coroid affiche pour chaque bot. Coroid rejette toute livraison non signée avec le secret du bot.
Démarrer un travail depuis un canal
Un message Slack ou Telegram peut donner lieu à une demande de travail. Les messages Discord et SMS ne le permettent pas.
Un message se transforme en demande grâce à une automatisation d'événements. Cela est utile pour les demandes du type « Quelqu'un peut-il simplement corriger ce problème ? » qui, autrement, ne seraient jamais prises en compte comme des tâches à traiter.
Le message correspondant est transmis à Qualification sous forme de demande. Qualification l’examine, recherche les doublons et détermine ce qu’elle doit devenir. Rien n’est créé avant qu’elle ne soit validée. Voir Modes de démarrage du travail.
Coroid ne relie pas les comptes Slack ou Telegram aux comptes Coroid, si bien que toute personne pouvant publier dans une conversation correspondante peut soumettre une demande. C’est pourquoi le travail issu d’une conversation ne démarre jamais de lui-même. Une tâche admissible est créée et attend que quelqu’un la démarre, et un plan attend son approbation.
Consultez Déclencheurs et destinations.
Slack
- Configure le bot Slack dans cette section : Robots de plateforme. Il nécessite le jeton du bot et le secret de signature de l'application Slack.
- Dans votre application Slack, envoyez les messages de canal et les mentions d'application vers l'URL du webhook
indiquée par Coroid :
https://api.coroid.ai/api/v1/webhooks/slack/events. - Invitez le bot dans chaque canal qu'il doit lire.
- Activez Slack dans Contrôle qualité → Par défaut organisationnel → Avant le début du travail → Origine des demandes. Seuls les propriétaires et les administrateurs peuvent activer une origine, et uniquement après la connexion du bot.
Activer Slack ajoute une automatisation qui enregistre les messages correspondants comme demandes. Elle apparaît dans Usine → Automatisations, où vous pouvez modifier son filtre. Désactiver Slack interrompt l'automatisation tout en conservant son filtre.
Le filtre de l'automatisation détermine quels messages sont pris en compte. Il commence par correspondre aux
messages contenant cette mention : @coroidUn filtre peut également limiter l'automatisation à un seul canal ou aux messages publiés par des bots, comme les alertes.
Coroid exécute au maximum 10 automatisations Slack par minute pour un canal.
Telegram
- Ajoutez le bot Telegram dans cette section : Robots de plateforme. Coroid enregistre son webhook auprès de Telegram et le protège avec un secret de webhook. Si vous laissez ce secret vide, Coroid en génère automatiquement un.
- Ajoutez le bot au groupe ou attribuez-lui le rôle d'administrateur du canal.
- Activez Telegram dans Contrôle qualité → Paramètres par défaut de l'organisation → Avant le début du travail → Origine des demandes. Son automatisation est répertoriée dans Usine → Automatisations, où vous pouvez modifier son filtre.
- Dans le chat, commencez chaque demande par cette commande :
/coroid.
Le mode de confidentialité de Telegram, activé par défaut, permet au bot de voir les commandes mais pas les messages ordinaires. Un filtre peut également limiter l'automatisation à un seul chat grâce à son identifiant de chat. Le bot ignore les messages directs sauf si le filtre les autorise.
N'importe qui peut ajouter votre bot à un autre groupe et y déposer des demandes. Pour éviter cela, limitez l'automatisation à votre chat ou empêchez le bot de rejoindre les groupes avec cette commande BotFather : /setjoingroups.
Coroid accepte au maximum 10 messages correspondants par minute provenant d’une même conversation. Si l’automatisation est limitée à un seul projet, ses demandes sont envoyées à ce projet.
Ponts de canal
Un pont relie un canal à une session avec l'assistant de chat.
La communication avec l'assistant via un pont n'est pas possible. En effet, le pont ne transmet pas les messages à l'assistant, ce qui l'empêche de démarrer ou d'orienter les tâches.
Mises à jour dans un canal
Slack est la seule plateforme de messagerie à recevoir les mises à jour. Coroid publie des messages dans un canal Slack lorsqu'une tâche est terminée, échoue ou est escaladée, ainsi qu'au moment d'une nouvelle tentative ou en cas d'échec pour résoudre un conflit de fusion. Ces messages sont envoyés via un webhook entrant Slack connecté à votre organisation, et non par le biais du bot Slack. Aucun écran de configuration ne permet encore de relier ce webhook.
Discord, Telegram et SMS ne reçoivent aucune mise à jour. Toutes les autres notifications arrivent dans le portail. Consultez Notifications.