Інтеграція із Zapier

Вступ Перші кроки Таймер — Облік робочого часу Панель керування Місячна таблиця Річна статистика Додавання та редагування записів Проєкти Види діяльності Шаблони Профіль та налаштування оплати Експорт та звіти про роботу Геозони Налаштування застосунку Синхронізація та резервні копії Режим кіоску (Термінал) Сповіщення та нагадування Запити на відпустку Файли та сховище Premium та підписки Інтеграція із Zapier

Інтеграція із Zapier

Підключіть Working Timer до тисяч застосунків через Zapier. Наприклад, можна створювати запис робочого часу з події календаря, форми, рядка таблиці або виконаного завдання.

Інтеграція використовує публічний API Working Timer. Передавати Zapier пароль від Working Timer не потрібно.

Що потрібно

  • Обліковий запис Working Timer з активним планом або пробним періодом Public API
  • Платний план Zapier з API by Zapier або Webhooks by Zapier
  • ID профілю Working Timer, до якого додаватимуться записи

Важливо: Ставтеся до API-ключа як до пароля. Не додавайте його до назви, нотатки, URL чи поля Zap, яке може з'явитися в історії завдань.

1. Створення API-ключа

  1. Відкрийте портал Working Timer API, натисніть Sign In та ввійдіть.
  2. В API Dashboard, у розділі API Keys, натисніть New Key.
  3. Введіть назву, наприклад Zapier, і натисніть Create.
  4. Одразу скопіюйте ключ, що починається з wt_ak_. Він відображається лише один раз.

Якщо ключ утрачено, відкличте його та створіть новий.

2. Пошук ID профілю

  1. Відкрийте довідник API.
  2. Натисніть Authorize і введіть ключ у поле ApiKey.
  3. Відкрийте GET /api/v1/Profile, натисніть Try it out, а потім Execute.
  4. Знайдіть профіль у відповіді та скопіюйте його id.

ID має формат GUID, наприклад a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Підключення через API by Zapier

  1. У Zapier відкрийте Apps, натисніть Add connection і виберіть API by Zapier.
  2. У Authentication type виберіть Static Headers (API key).
  3. У Headers додайте один рядок:
X-Api-Key: wt_ak_vash_api_kliuch
  1. Укажіть Connection name: Working Timer.
  2. Укажіть Domain filter: api.workingtimer.com.
  3. У Test URL введіть https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Натисніть Yes, Continue to API by Zapier.

API by Zapier є бета-функцією. Якщо вона недоступна, скористайтеся способом Webhooks нижче.

4. Створення першого Zap

  1. Створіть Zap і виберіть тригер, наприклад нову подію, завдання, форму або рядок таблиці.
  2. Додайте API by Zapier, виберіть API Request і підключення Working Timer.
  3. Укажіть Method POST і URL https://api.workingtimer.com/api/v1/WorkRecord.
  4. У Body введіть:
{
  "profileId": "ID_PROFILU",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Створено через Zapier"
}
  1. Замініть ID_PROFILU, зіставте значення тригера та за потреби спочатку перетворіть їх через Formatter by Zapier.
  2. Натисніть Test step. Успішний запит повертає 201. Перевірте запис у Working Timer і опублікуйте Zap.

clockIn і clockOut — це хвилини від опівночі: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Для нічної зміни clockOut може перевищувати 1440.

Альтернатива: Webhooks by Zapier

Додайте Webhooks by Zapier із подією POST. Укажіть URL https://api.workingtimer.com/api/v1/WorkRecord, Payload Type JSON, наведені вище дані та заголовки X-Api-Key з вашим ключем і Content-Type зі значенням application/json. Успішний тест повертає 201.

Інші корисні запити

  • Профілі: GET https://api.workingtimer.com/api/v1/Profile
  • Записи: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Оновлення: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Видалення: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Інші endpoints наведено в довіднику API.

Усунення проблем

  • 401 Unauthorized — ключ відсутній, неповний або відкликаний. Заголовок має називатися точно X-Api-Key.
  • 403 Forbidden — активуйте або поновіть план чи пробний період Public API.
  • 400 Bad Request — перевірте JSON, дату й числові значення хвилин.
  • Profile was not found — переконайтеся, що profileId належить тому самому обліковому запису.
  • 429 Too Many Requests — досягнуто ліміту API; повторіть пізніше та перевірте використання.
  • Дублікати — перевірте історію Zapier і додайте перед дією фільтр або унікальний ID джерела.

Щоб забрати доступ, натисніть Revoke біля ключа Zapier в API Dashboard.

Попередній Premium та підписки