Kokeellinen ominaisuus. n8n-integraatiota ei ole vielä testattu täysin. Pääkäyttäjä ottaa sen tietoisesti käyttöön kohdassa Asetukset → Lisäasetukset → Muut; niin kauan kuin se on pois päältä, n8n-välilehti ja tämä oppaan luku ovat piilossa, ja /api/n8n/*-päätepisteet ovat pois käytöstä.

Mikä on n8n?

n8n on prosessien automatisointialusta. Integraatio Task Managerin kanssa toimii kahteen suuntaan:

  1. Lähtevät webhookit (Task Manager → n8n) - sovellus lähettää itse ilmoituksia n8n-työnkulkuusi, kun jotain tapahtuu (tehtävä luotiin, tila muuttui, viesti lisättiin, määräaika lähestyy jne.).
  2. Saapuva API (n8n → Task Manager) - n8n voi kutsua sovellusta luodakseen tehtäviä, lisätäkseen viestejä tai hakeakseen tietoja.

Integraation käyttöönotto

Napsauta hammasrataskuvaketta (⚙) → välilehti n8n. Välilehti jakautuu kahteen osaan: ”Henkilökohtaiset automaatiot” - vain sinua koskeva määritys, sekä ”Globaalit automaatiot” - kaikille käyttäjille yhteiset järjestelmäasetukset, näkyvissä vain pääkäyttäjälle. Jotta tapahtumia lähetetään, pääkäyttäjän on otettava käyttöön kytkin ”Ota n8n-integraatio käyttöön” globaalissa osassa.

A. Lähtevät webhookit - ilmoitukset sovelluksesta n8n:ään

Määritys

  1. Napsauta välilehdellä n8n kohtaa ”Uusi webhook”.
  2. Anna webhookin nimi ja n8n:stä kopioitu webhookin URL-osoite (Webhook-solmu laukaisimena, POST-metodi).
  3. Valitse tapahtumat, jotka lähetetään.
  4. (Valinnainen) aseta salaisuus - sovellus allekirjoittaa sillä pyynnöt (HMAC), jotta n8n voi varmistaa niiden aitouden.
  5. Tallenna. Voit lähettää testipingin tarkistaaksesi yhteyden.

Saatavilla olevat tapahtumat (valikoima)

  • Tehtävät: task.created, task.updated, task.status_changed, task.completed, task.deleted, task.deadline_approaching, task.overdue
  • Keskustelut / viestit: chat.message_sent, chat.mention, chat.file_uploaded
  • Käyttäjät / työtila: user.created, user.login, user.logout, workspace.created
  • Järjestelmä: system.daily_summary, system.weekly_summary

Jokainen n8n:lle lähetetty pyyntö sisältää tapahtuman nimen sekä kontekstitiedot (data) (esim. tehtävän id, työtila, tekijä).

B. Saapuva API - n8n ohjaa sovellusta

Määritys

  1. Napsauta välilehdellä n8n kohtaa ”Uusi API-avain”.
  2. Kopioi luotu token (näytetään vain kerran).
  3. Käytä n8n:ssä HTTP Request -nodea autentikointiotsikolla:
    Authorization: Bearer TWÓJ_TOKEN
    Toiminnot suoritetaan avaimen luoneen käyttäjän kontekstissa (hänen oikeuksiensa ja työtilojen käyttöoikeuksiensa mukaisesti).

Saatavilla olevat päätepisteet

  • GET /api/n8n/ping.php - tokenin testi ja tilatarkistus (palauttaa tiedot avaimesta ja käyttäjästä).
  • GET /api/n8n/workspaces.php - luettelo käytettävissä olevista työtiloista.
  • GET /api/n8n/users.php - käyttäjäluettelo (vain globaalin pääkäyttäjän luomat avaimet).
  • GET /api/n8n/tasks.php?workspace_id=&status=&limit= - tehtävälista.
  • POST /api/n8n/tasks.php - tehtävän luonti. JSON-runko:
    {
"workspace_id": 1,
"subject": "Nowe zadanie z n8n",
"description": "Opcjonalny opis",
"priority": "high",
"deadline_date": "2025-12-31",
"status": "none",
"assignees": [2, 5]
}
  • PATCH /api/n8n/tasks.php — olemassa olevan tehtävän päivitys, muun muassa tilan muutos. JSON-runko (task_id pakollinen, loput kentät valinnaisia - anna vain ne, joita haluat muuttaa):
    {
"task_id": 42,
"status": "in_progress",
"priority": "high",
"deadline_date": "2026-08-01",
"subject": "Nowy temat",
"description": "Nowy opis"
}
    • status: none | in_progress | done | cancelled. Tilan muutos toimii täsmälleen samalla tavalla kuin sovelluksessa: tehtävän viestiketjuun ilmestyy merkintä ”vaihtoi tilaksi…”, vastuuhenkilöt saavat sähköposti-ilmoituksen ja n8n:ään lähtee webhook task.status_changed (sekä task.completed, kun tila on done).
    • deadline_date: null tyhjentää määräajan. Määräajan muutos siirtää siihen kiinnitetyt muistutukset.
    • Muut kentät lähettävät webhookin task.updated.
    • Saman tilan asettaminen uudelleen ei lähetä mitään (turvallista n8n:n uudelleenyrityksissä).
    • Jos HTTP-nodesi ei tue PATCH-metodia, lähetä sama runko POST-pyynnöllä: task_id-kentän läsnäolo kytkee päätepisteen päivitystilaan.
    • Virhekoodit: 400 puuttuva task_id tai ei muutettavia kenttiä, 422 virheellinen arvo (tila/prioriteetti/päivämäärän muoto), 404 tehtävää ei ole tai se on avaimen käyttöoikeuden ulkopuolella, 403 ei oikeuksia tilan muuttamiseen/muokkaamiseen.
  • POST /api/n8n/messages.php - viestin lisääminen tehtävään tai keskusteluun. JSON-runko:
    {
"entity_type": "task",
"entity_id": 42,
"content": "Treść wiadomości"
}

Esimerkkejä automaatioskenaarioista

  • Google Forms -lomake → n8n → POST /api/n8n/tasks.php (uusi tehtävä Task Managerissa)
  • Tietyllä aiheella saapuva Gmail-viesti → n8n → tehtävä, jonka kuvaus tulee sähköpostin sisällöstä
  • Tilan muutos Jirassa → n8n → viesti / liittyvän tehtävän päivitys
  • Lähtevä webhook task.created → n8n → merkintä Google-laskentataulukkoon / ilmoitus Slackiin
  • task.deadline_approaching → n8n → sähköposti-/tekstiviestimuistutus lähestyvästä määräajasta

Ongelmien ratkaiseminen

  • Ei ilmoituksia n8n:ssä - tarkista, että integraatio on käytössä, webhook on aktiivinen ja URL on oikein. Käytä ”testipingiä”.
  • Ei valtuutusta (401) saapuvassa API:ssa - token on virheellinen tai se on poistettu. Luo uusi API-avain ja päivitä Authorization-otsikko n8n:ssä.
  • Tehtävää ei luoda - varmista, että workspace_id on olemassa ja että avaimen käyttäjällä on siihen pääsy sekä oikeus lisätä tehtäviä.