Gestion de projet
Everhour dans votre produit et vos agents IA, via une API
Le toolkit Everhour couvre les clients et leurs budgets, les projets, la recherche de tâches, les enregistrements de temps, les factures et les membres de l'équipe. Un produit ou un agent IA enregistre le temps et le facture à partir des enregistrements, sans construire l'intégration Everhour ni stocker ses identifiants.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/everhour_create_client/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Fonctionnement
Du client connecté au premier appel à Everhour.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Everhour. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Everhour.
Saisie du temps depuis votre produit
Recherchez la tâche par son nom et créez un enregistrement de temps pour un jour quand l'utilisateur termine son travail dans votre outil ou indique à un agent combien de temps cela a pris.
Facturer le temps suivi
Dans un outil d'agence, créez une facture pour un client à partir du temps suivi sur une période, puis marquez-la comme envoyée ou payée par une mise à jour.
Suivi de budget par un agent
Laissez un agent IA lire les clients et projets avec la consommation du budget et prévenir l'équipe avant que le budget d'un client soit épuisé.
Tools
15 tools Everhour
- Lister les clientsGETListe les clients de l'équipe en une seule réponse, avec les ids de leurs projets et le budget avec sa consommation en cours. L'argent est en centimes et le temps en secondes.
- Créer un clientPOSTCrée un client. Les noms ne sont pas dédupliqués, consultez donc List clients d'abord. Liez à ce client les projets dont le temps est facturé.
- Mettre à jour un clientPUTModifie un client. Seuls les champs envoyés changent. Pour lier un nouveau projet, envoyez la liste complète de projects, y compris les ids déjà liés que montre List clients.
- Mettre à jour le budget d'un clientPUTCrée ou remplace le budget d'un client. Envoyez le budget complet, car les mises à jour partielles ne sont pas prises en charge. Quand le seuil est atteint, les administrateurs de l'équipe reçoivent un e-mail.
- Lister les projetsGETListe les projets auxquels l'utilisateur a accès, avec l'id du client, le type de facturation, les tarifs et le budget avec sa consommation. Les ids portent le préfixe de l'intégration, comme as:1234567890 pour Asana ou ev:1234567890 pour les projets créés dans Everhour. Les pages commencent à 1, et une page plus courte que limit est la dernière.
- Rechercher des tâchesGETRecherche des tâches par nom dans tous les projets ou dans un seul. Renvoie les ids des tâches, comme ev:3000010034, que demandent les outils d'enregistrement du temps, avec les ids des projets, le statut et les totaux de temps en secondes.
- Lister les enregistrements de tempsGETListe les enregistrements de temps de toute l'équipe sur une période, les deux jours inclus. Sans from et to, ne renvoie qu'aujourd'hui. Chaque enregistrement a le temps en secondes, l'id de l'utilisateur, dont le nom vient de List users, la date, la tâche avec les ids de ses projets et isInvoiced. Une page plus courte que limit est la dernière.
- Créer un enregistrement de tempsPOSTEnregistre du temps sur une tâche pour un jour. Un utilisateur a au plus un enregistrement par tâche et par jour : renvoyer le même utilisateur, la même tâche et la même date met à jour la durée de cet enregistrement au lieu d'en créer un autre.
- Mettre à jour un enregistrement de tempsPUTModifie un enregistrement de temps par son id. time est obligatoire à chaque appel, envoyez donc la durée actuelle pour la conserver.
- Supprimer un enregistrement de tempsDELETESupprime un enregistrement de temps en mettant sa durée à zéro. L'historique de l'enregistrement est conservé, et il n'apparaît plus dans List time records.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Everhour
Dois-je intégrer l'API Everhour moi-même ?
Non. Connect fournit 15 tools Everhour décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Everhour ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
