Intégrations Slack et Mattermost

TeeckIn peut envoyer des notifications à Slack ou Mattermost lorsque des événements de Timer, de tâche et de pointage se produisent. Vos équipes restent ainsi au courant de l’avancement du travail, sans aucune mise à jour de statut manuelle.

Vous pouvez configurer des intégrations dans deux portées :

• Personnelle — configurée sur votre propre compte, elle se déclenche pour votre activité dans votre contexte personnel. Vous les gérez ici.
• Organisation — configurée par un administrateur ou un propriétaire sur une organisation, elle se déclenche pour l’activité des membres de cette organisation. Les membres ne peuvent ni les créer ni les modifier. Consultez la documentation Équipes pour plus de détails.

L’administrateur d’une organisation à laquelle vous appartenez peut activer une politique qui supprime les intégrations personnelles pour les événements émis pendant que vous travaillez au sein de cette organisation. Lorsque cela se produit, une bannière jaune apparaît sur votre page d’intégrations indiquant quelle organisation les supprime.

Important : la suppression est limitée à cette seule organisation. Vos intégrations personnelles continuent de se déclencher pour :

• Les événements de votre contexte personnel (non associés à une organisation).
• Les événements d’autres organisations auxquelles vous appartenez et qui n’ont pas activé cette politique.

Rien n’est supprimé. Si l’administrateur désactive la politique ultérieurement, vos intégrations recommencent automatiquement à se déclencher pour cette organisation.

1. Accédez à Paramètres → Intégrations
2. Cliquez sur « Ajouter une intégration »
3. Saisissez un nom (par ex. « Mises à jour client »)
4. Choisissez la plateforme (Slack ou Mattermost)
5. Collez votre URL de webhook
6. Sélectionnez les événements à notifier :
   • Timer démarré — lorsqu’un Timer démarre
   • Timer arrêté — lorsqu’un Timer s’arrête (durée incluse)
   • Tâche démarrée — lorsqu’une tâche de la liste passe « en cours »
   • Tâche en pause — lorsqu’une tâche de la liste est mise en pause
   • Tâche terminée — lorsqu’une tâche de la liste est terminée
   • Tâche ignorée — lorsqu’une tâche de la liste est ignorée (devenue inutile)
   • Tâche supprimée — lorsqu’une tâche de la liste est supprimée
   • Tâche assignée — lorsqu’une tâche est assignée à un membre de l’équipe (organisation uniquement)
   • Pointage enregistré — lorsqu’un pointage est ajouté manuellement (sans le Timer)
   • Pointage modifié — lorsque l’heure de début ou de fin d’un pointage change (affiche la durée avant et après)
   • Pointage supprimé — lorsqu’un pointage est supprimé

   Activer « Tâche démarrée » enrichit aussi les notifications « Timer démarré » avec le contexte de la tâche en cours (par ex. « Timer démarré sur Project Alpha — En cours : Corriger le bug de connexion »).

7. Choisissez un filtre :
   • Tous les Topics — notifie pour n’importe quel Topic
   • Topics spécifiques — uniquement les Topics sélectionnés
   • Catégories spécifiques — tous les Topics des catégories sélectionnées
8. Cliquez sur « Créer l’intégration »

Chaque intégration suit ses tentatives de distribution récentes. Cliquez sur l’icône d’horloge d’une carte d’intégration pour consulter l’historique de distribution.

L’historique affiche :

• Distribué — message envoyé avec succès
• En attente — message en file d’attente, nouvelle tentative imminente
• Échec — le message n’a pas pu être distribué après 5 tentatives

En cas d’échec de distribution, le message d’erreur aide à diagnostiquer des problèmes tels que des URL de webhook invalides ou des problèmes réseau. TeeckIn réessaie automatiquement les distributions ayant échoué jusqu’à 5 fois, avec des intervalles de 5 minutes entre les tentatives.

TeeckIn envoie des messages avec le contexte de qui a fait quoi et sur quel Topic :

Par défaut, les messages sont publiés en tant que « TeeckIn Bot » avec l'avatar horloge TeeckIn. Vous pouvez personnaliser les deux par intégration : définissez un nom de bot et une URL d'image HTTPS publique pour l'avatar dans le formulaire de l'intégration (Slack et Mattermost uniquement). Laissez les champs vides pour conserver les valeurs par défaut.

En option, les messages d'arrêt du minuteur peuvent inclure le temps facturable total pas encore facturé (un champ « Pas encore facturé »). Le total suit le filtre de l'intégration : avec des sujets ou catégories spécifiques sélectionnés, il les additionne tous, et avec « Tous les sujets » il couvre tout votre espace de travail. Comme une intégration est généralement le canal d'un client, cela se lit comme « combien de travail reste à facturer pour ce client » à chaque arrêt de minuteur. Il compte les entrées facturables terminées non liées à une facture (les factures annulées libèrent à nouveau leur temps), et c'est désactivé par défaut — activez « Inclure le total non facturé à l'arrêt d'un minuteur » dans le formulaire de l'intégration.

Pour éviter le spam de messages, TeeckIn regroupe les événements au sein d’une fenêtre configurable (par défaut : 10 secondes). Plusieurs événements survenant dans cette fenêtre sont combinés en un seul message.

Vous pouvez ajuster la fenêtre de regroupement de 5 à 60 secondes lors de la création ou de la modification d’une intégration. Des fenêtres plus longues signifient moins de messages, mais des mises à jour moins en temps réel.

Par défaut, les intégrations notifient à la fois l’activité humaine et celle des agents IA. Si vous préférez ne voir que l’activité humaine, décochez « Inclure les événements des agents IA » lors de la configuration de l’intégration.

Lorsque des agents IA déclenchent des événements, les messages affichent leur identité (par ex. « Claude » ou le nom personnalisé de votre agent) avec un badge « Agent IA » pour une attribution claire.