Intégration Zapier
Intégration Zapier
Connectez Working Timer à des milliers d'applications avec Zapier. Vous pouvez, par exemple, créer une entrée de travail à partir d'un événement de calendrier, d'un formulaire, d'une ligne de feuille de calcul ou d'une tâche terminée.
L'intégration utilise l'API publique Working Timer. Vous n'avez pas à communiquer votre mot de passe Working Timer à Zapier.
Prérequis
- Un compte Working Timer avec un abonnement ou un essai Public API actif
- Un abonnement Zapier payant incluant API by Zapier ou Webhooks by Zapier
- L'ID du profil Working Timer qui recevra les entrées
Important : Traitez la clé API comme un mot de passe. Ne la placez pas dans le nom, les notes, l'URL ou un champ du Zap susceptible d'apparaître dans l'historique.
1. Créer une clé API
- Ouvrez le portail API Working Timer, sélectionnez Sign In et connectez-vous.
- Dans API Dashboard, sous API Keys, sélectionnez New Key.
- Saisissez un nom comme
Zapier, puis sélectionnez Create. - Copiez immédiatement la clé commençant par
wt_ak_. Elle ne s'affiche qu'une fois.
Si vous la perdez, révoquez-la et créez-en une nouvelle.
2. Trouver l'ID du profil
- Ouvrez la référence API.
- Sélectionnez Authorize et saisissez la clé dans le champ ApiKey.
- Ouvrez
GET /api/v1/Profile, sélectionnez Try it out, puis Execute. - Repérez le profil dans la réponse et copiez son
id.
L'ID est un GUID semblable à a1b2c3d4-1234-5678-9abc-1234567890ab.
3. Connecter API by Zapier
- Dans Zapier, ouvrez Apps, sélectionnez Add connection, puis API by Zapier.
- Pour Authentication type, choisissez Static Headers (API key).
- Dans Headers, ajoutez une ligne :
X-Api-Key: wt_ak_votre_cle_api
- Définissez Connection name sur
Working Timer. - Définissez Domain filter sur
api.workingtimer.com. - Utilisez comme Test URL
https://api.workingtimer.com/api/v1/Profile?pageSize=1. - Sélectionnez Yes, Continue to API by Zapier.
API by Zapier est actuellement en version bêta. Si cette option n'est pas disponible, utilisez la méthode Webhooks ci-dessous.
4. Créer votre premier Zap
- Créez un Zap et choisissez un déclencheur : nouvel événement, tâche, formulaire ou ligne de feuille, par exemple.
- Ajoutez API by Zapier, choisissez l'action API Request, puis la connexion Working Timer.
- Définissez Method sur
POSTet URL surhttps://api.workingtimer.com/api/v1/WorkRecord. - Saisissez dans Body :
{
"profileId": "ID_DU_PROFIL",
"year": 2026,
"month": 7,
"day": 31,
"clockIn": 540,
"clockOut": 1020,
"breakMinutes": 30,
"recordType": "common",
"isPaid": true,
"note": "Créé par Zapier"
}
- Remplacez
ID_DU_PROFIL, associez les valeurs du déclencheur et utilisez d'abord Formatter by Zapier si une conversion est nécessaire. - Sélectionnez Test step. Une requête réussie renvoie
201. Vérifiez l'entrée dans Working Timer, puis publiez le Zap.
clockIn et clockOut sont des minutes depuis minuit : 08:00 = 480, 09:00 = 540, 17:00 = 1020. Pour un service de nuit, clockOut peut dépasser 1440.
Alternative : Webhooks by Zapier
Ajoutez Webhooks by Zapier avec l'événement POST. Définissez l'URL sur https://api.workingtimer.com/api/v1/WorkRecord, Payload Type sur JSON, ajoutez les données ci-dessus et les en-têtes X-Api-Key avec votre clé et Content-Type avec application/json. Un test réussi renvoie 201.
Autres requêtes utiles
- Profils :
GET https://api.workingtimer.com/api/v1/Profile - Entrées :
GET https://api.workingtimer.com/api/v1/WorkRecord - Mise à jour :
PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id} - Suppression :
DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}
Consultez la référence API pour les autres endpoints.
Dépannage
- 401 Unauthorized — la clé est absente, incomplète ou révoquée. L'en-tête doit être exactement
X-Api-Key. - 403 Forbidden — activez ou renouvelez l'abonnement ou l'essai Public API.
- 400 Bad Request — vérifiez le JSON, la date et les valeurs numériques en minutes.
- Profile was not found — vérifiez que
profileIdappartient au même compte. - 429 Too Many Requests — une limite API est atteinte ; réessayez plus tard et consultez l'utilisation.
- Entrées en double — consultez l'historique Zapier et utilisez un filtre ou un ID source unique avant l'action.
Pour retirer l'accès, sélectionnez Revoke pour la clé Zapier dans API Dashboard.