Intégration domotique TickTick, gratuite et open source
Affiche vos tâches TickTick et permet aux scènes d'en créer ou de réagir à leurs échéances.
Publiée par cicoub13
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Nécessite Gladys 5.1 ou plus récent. Cette intégration se compose d'un widget de tableau de bord et de déclencheurs et d'actions de scène, arrivés avec Gladys 5.1 : sur une version antérieure, elle ne peut pas être installée.
Retrouvez vos tâches TickTick dans Gladys : un widget de tableau de bord avec les tâches du jour et celles en retard, une action de scène pour créer une tâche (depuis un bouton, une commande vocale, un capteur…), une autre pour lire vos tâches à voix haute ou les envoyer en notification, et un déclencheur de scène qui part quand une tâche arrive à échéance.
Prérequis
- Un compte TickTick (gratuit ou Premium).
- Un accès Internet depuis la machine qui fait tourner Gladys : l'intégration utilise l'API cloud de TickTick.
Connecter votre compte
- Ouvrez le site développeur de TickTick, connectez-vous avec votre compte TickTick et cliquez sur New App. Le nom n'a pas d'importance, par exemple « Gladys ».
- Ouvrez la nouvelle application et cliquez sur Edit. Dans OAuth
redirect URL, collez l'URI de redirection affichée dans l'écran de
configuration de Gladys, sous le bouton Connecter (en général
https://my.gladysassistant.com/redirect/oauth), puis enregistrez. Sans elle, TickTick répond « At least one redirect_uri must be registered with the client ». - Copiez le Client ID et le Client secret de l'application dans l'écran de configuration de Gladys et cliquez sur Enregistrer, en bas du formulaire.
- Ensuite seulement, cliquez sur Connecter : le bouton n'enregistre pas le formulaire, et l'intégration ne voit que les valeurs enregistrées. TickTick vous demande d'autoriser l'accès à vos tâches. Acceptez. Vous revenez dans Gladys et le statut passe à connecté.
L'accès accordé dure plusieurs mois. Quand TickTick y met fin, le statut de l'intégration l'indique : cliquez à nouveau sur Connecter.
Configuration
| Champ | Description |
|---|---|
| Client ID / secret | Ceux de votre application développeur TickTick. |
| Compte TickTick | Le bouton Connecter, une fois le Client ID et le secret enregistrés. |
| Fréquence d'actualisation | Fréquence de lecture de TickTick : 1 minute, 5 minutes (par défaut) ou 15 minutes. |
| Heure des tâches sans heure | Heure (0-23, 9 par défaut) à laquelle le déclencheur « Tâche TickTick à échéance » part pour une tâche qui a un jour mais pas d'heure. |
Tester la connexion vérifie l'accès et indique le nombre de listes trouvées. Le bouton relance aussi l'actualisation après un accès refusé, une fois le problème corrigé.
Widget de tableau de bord
Ajoutez le widget Tâches TickTick à un tableau de bord. Il affiche :
- deux compteurs : tâches en retard et tâches du jour ;
- jusqu'à 8 tâches, les retards d'abord, avec leur liste, leur échéance et leur priorité. Touchez une tâche pour voir ses notes et un lien pour l'ouvrir dans TickTick ;
- une ligne indiquant combien d'autres tâches n'ont pas pu être affichées.
Le réglage Tâches affichées de chaque widget permet de choisir entre Aujourd'hui et en retard (par défaut), Aujourd'hui, En retard et 7 prochains jours et en retard.
Les tâches sans date ne sont jamais affichées. Les tâches se terminent dans TickTick, pas depuis le widget.
Scènes
Déclencheur : Tâche TickTick à échéance
Se déclenche quand une tâche non terminée arrive à échéance : à son heure pour
une tâche avec une heure, à l'Heure des tâches sans heure pour une tâche
qui n'a qu'un jour. Filtres facultatifs : la priorité, et la liste (son
nom exact, Inbox pour la boîte de réception).
Variables pour les actions suivantes : title, list_name, priority
(none, low, medium, high), due_date (AAAA-MM-JJ), due_time
(HH:MM, vide pour une tâche sur la journée), all_day et content (les
notes de la tâche).
La planification suit l'actualisation : une tâche créée ou déplacée moins d'une période d'actualisation avant son échéance peut être manquée. Une tâche déjà échue au démarrage de Gladys ne déclenche rien.
Action : Créer une tâche TickTick
- Titre (obligatoire, peut utiliser les variables de la scène) ;
- Liste : nom d'une liste TickTick, sans tenir compte des majuscules. Vide ou inconnue : la boîte de réception ;
- Échéance : sans date, aujourd'hui ou demain, avec une Heure
d'échéance facultative (
18:30) ; sans heure, la tâche porte sur la journée ; - Priorité : aucune, basse, moyenne ou haute.
Sorties : task_id et list_name (la liste où la tâche a été créée).
Action : Lister les tâches TickTick
Lit les tâches d'une période (mêmes choix que le widget) depuis la dernière
actualisation. Sorties : count, titles (une tâche par ligne, avec son heure
si elle en a une), et pour la première tâche next_title, next_list,
next_due_date et next_due_time. Exemple : chaque matin à 7 h 30, si count
est supérieur à 0, envoyer « Aujourd'hui : {{titles}} » en notification.
Dépannage
| Message | Que faire |
|---|---|
| Connectez votre compte TickTick | Rien n'est encore connecté : suivez « Connecter votre compte ». |
| Aucun Client ID enregistré / Aucun Client secret enregistré | Renseignez-les et cliquez sur Enregistrer avant de cliquer sur Connecter. |
| Erreur au lancement de la connexion (affiché par Gladys) | Gladys n'affiche pas la cause : elle est dans les journaux de l'intégration (« TickTick connection failed »). Le plus souvent, le Client ID n'a pas été enregistré. |
| TickTick a refusé l'accès | L'accès a été révoqué ou a expiré : cliquez à nouveau sur Connecter. L'actualisation attend d'ici là. |
| L'autorisation TickTick a expiré ou ne correspond pas | Plus de 15 minutes se sont écoulées sur la page TickTick, ou l'intégration a redémarré entre-temps : cliquez à nouveau sur Connecter. |
| TickTick : At least one redirect_uri must be registered | Votre application développeur n'a pas d'OAuth redirect URL : indiquez l'URI de redirection affichée dans Gladys (étape 2). |
| TickTick indique que l'URL de redirection est invalide | L'OAuth redirect URL de votre application développeur doit être exactement l'URI de redirection affichée dans Gladys. |
| TickTick est injoignable / n'a pas répondu à temps | Vérifiez la connexion Internet de la machine Gladys. L'intégration réessaie à chaque actualisation. |
| TickTick limite le nombre de requêtes | Choisissez une fréquence d'actualisation plus longue. |
Les journaux de l'intégration (onglet Supervision de l'intégration) donnent le détail de chaque erreur ; votre jeton n'y apparaît jamais.
Paramètres de configuration
Voici les paramètres demandés par TickTick dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter votre compte TickTick | section | Non | 1. Sur le site développeur de TickTick, créez une application (Manage Apps > New App). 2. Dans ses réglages, indiquez comme OAuth redirect URL l'URI de redirection affichée sous le bouton Connecter. 3. Copiez ici son Client ID et son Client secret et cliquez sur Enregistrer (en bas du formulaire). 4. Ensuite seulement, cliquez sur Connecter. |
| Client ID | string | Non | |
| Client secret | secret | Non | |
| Cliquez sur Enregistrer avant Connecter | section | Non | Le bouton Connecter n'enregistre pas le formulaire : après avoir saisi le Client ID et le Client secret, cliquez d'abord sur Enregistrer en bas du formulaire, puis revenez ici et cliquez sur Connecter. |
| Compte TickTick | oauth2 | Non | |
| Réglages | section | Non | Fréquence de lecture de TickTick, et heure à laquelle le déclencheur « Tâche à échéance » part pour les tâches sans heure. |
| Fréquence d'actualisation | select | Non | |
| Heure des tâches sans heure | number | Non | Heure de la journée (0-23) à laquelle le déclencheur « Tâche à échéance » part pour une tâche sur la journée. |
Comment installer TickTick dans Gladys
- Dans Gladys, ouvrez Intégrations : TickTick apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/cicoub13/gladys-ticktick:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/cicoub13/gladys-ticktick.
TickTick nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
TickTick est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par cicoub13, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation